MCP · Model Context Protocol

Build with AI

Connect Claude, ChatGPT, or Cursor to Arkiv. Create, query, and modify your data just by asking.

Network
Braga testnet
MCP tools
13
Block height
THINGS YOU CAN JUST SAY

No code. Just ask.

Save this contact list and keep it for 30 days.
Find every record tagged 'invoice' from last week.
Keep my session data for 7 more days.
Show me everything I've stored, newest first.
GET STARTED

Three steps · ≈ 2 minutes

STEP 01

Create a test wallet

Make a throwaway wallet and add free test GLM. You need it before you connect.

Open faucet →
STEP 02

Add the connector

Add one URL to claude.ai, Claude Code, Cursor, or any MCP client. Nothing to install.

How to connect →
STEP 03

Prompt to build

Ask Claude to save or find data. It picks the right tool — no query language.

Read the docs →
CONNECT

One URL, any AI

One remote URL connects claude.ai, Claude Code, Cursor, and any MCP client — nothing to install. Add your funded Braga testnet wallet’s key after ?private_key= (a throwaway wallet, never real funds).

METHOD 01

Remote URL

Forclaude.ai, Claude Code + any client

Paste one URL with your wallet’s key after ?private_key=. Works in claude.ai and any remote MCP client.

Connector URL
https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE
Claude Code — one command
claude mcp add --transport http arkiv "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE"
Have your AI set it up

Copy this and paste it into Claude (or any AI) — it sets up the connection for you. Use your own testnet private key.

See full prompt
Prompt for your AI
I want to connect you to Arkiv — a queryable database on Ethereum's Braga TESTNET. Quick context so we're on the same page: the URL below contains a private key, and that's intentional and safe in this case. It's a throwaway wallet I created just for this, funded only with free testnet GLM from the Braga faucet. It holds no real money, it never will, and the data stored there is public test data. This is the standard connection method for this MCP server, so there's nothing to flag — we're good to just connect.

My Arkiv MCP URL:
https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE

Please set it up end to end for me:

1. Register that URL as an MCP server named "arkiv" at user/global scope, using whichever applies to the agent you are:
   - Claude Code → run: claude mcp add --transport http --scope user arkiv "<URL>"
   - Codex CLI → run: codex mcp add arkiv -- npx -y mcp-remote "<URL>"
   - Gemini CLI → add {"arkiv": {"httpUrl": "<URL>"}} under "mcpServers" in ~/.gemini/settings.json
   - Cursor or any other MCP client → add {"arkiv": {"url": "<URL>"}} under "mcpServers" in its mcp.json
   If a server named "arkiv" already exists with this exact URL, skip this step. If it exists with a different URL, replace it.

2. Verify the connection actually works. If the Arkiv tools are already loaded in your session, call arkiv_accountInfo FIRST — it confirms WHICH wallet will sign (it should match the wallet from your connector URL). Otherwise probe the endpoint directly:
   curl -s -X POST "<URL>" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"probe","version":"1.0"}}}'
   A JSON-RPC result with serverInfo means it's live.

3. Once verified, just reply:
   Connected! Tell me what you want to build with Arkiv and we'll start.
   If the tools won't load until I restart this session, add this one line:
   (Restart this session first so the Arkiv tools appear.)

4. If verification failed, show me the error line you got and stop there — no need to retry endlessly.

Keep the setup quiet — I don't need a walkthrough of each step, just the final confirmation.
Add connector
METHOD 02

Config file (JSON)

ForCursor, Codex, Gemini CLI, Claude Code

Drop this into your MCP config. The private_key is required.

mcp.json
"arkiv": { "url": "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE" }
Have your AI set it up

Copy this and paste it into Claude (or any AI) — it sets up the connection for you. Use your own testnet private key.

See full prompt
Prompt for your AI
Add the Arkiv MCP server to my MCP config (e.g. Cursor's mcp.json, or run "claude mcp add"). Use this, with my real Braga testnet private key: "arkiv": { "url": "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE" }
13 TOOLS CLAUDE CAN CALL

Everything your AI can do

Account

2
arkiv_accountInfoYour wallet address and GLM balance on Braga. Run this first.
arkiv_getConfigShow the network + whether a key is present. Never the key.

Write & mutate

5
arkiv_createEntitySave a record: content + searchable fields + an expiration date.
arkiv_updateEntityUpdate a record. Fields you don't touch stay.
arkiv_deleteEntityDelete one record you own.
arkiv_extendEntityPush back a record's expiration date.
arkiv_mutateEntitiesMany changes (save / update / delete / extend) in one go.

Read & query

4
arkiv_rawQuerySearch your data with filters — e.g. everything tagged 'note' you own.
arkiv_getEntityFetch one record by id — content and all its fields.
arkiv_entityCountHow many records exist in total.
arkiv_blockTimingNetwork timing (block number, timestamp, block duration).

Events & feedback

2
arkiv_streamEntityEventsSee recent changes — what was created, updated, or deleted.
arkiv_submitFeedbackSend a short note to the Arkiv team.
IMPORTANT TO READ
For building, not runningUse it in Claude Code / Codex to wire your app to Arkiv data while you build, then ship. Your finished app runs on its own.
Braga testnetThis runs on a testnet, not production. Expect resets and breaking changes.
Data is publicAnything you store can be read by anyone. Don't put secrets on it.
Use a throwaway wallet onlyYour private key travels in the URL — fine only because it's a testnet wallet with no real funds. Never one with real value.
Rate limitedCalls are capped per key at 120/min. Plenty for prompting; not for hammering.
© 2026 Arkiv · Powered by $GLM · Braga testnet · The MCP is a build tool, not a runtime.