MCP · Model Context Protocol
AI
Connect your AI to the Web3 database.
Create, find, and change Arkiv entities by chatting with your AI.
See it work
Talk to your data
You ask in plain English.
Your AI picks the tool for the job, on Arkiv.
YouSave “Buy coffee beans” as a task, keep it 7 days.
arkiv_createEntity✓ stored · 0x9f3a…e21c · expires in 7dYouWhat tasks do I have?
arkiv_rawQuery type = "task"→ 2 resultsTaskExpires
Buy coffee beans7d
Call the dentist3d
Connect
Connect to any LLM
Nothing to install — hand a prompt to your AI, or add the URL by hand.
Use a throwaway Braga DB-Chain wallet, never one with real funds.
1Get test GLM — open faucet →
2Connect — let your AI do it, or add it by hand (below)
3Verify — ask your AI to run
arkiv_accountInfoPaste this into your AI (Claude Code, Cursor, Codex…) — it registers the server and verifies the connection for you.
I want to connect you to Arkiv (an Ethereum-aligned Web3 database) on its Braga test DB-chain. Quick context so we're on the same page: the URL below contains a private key, and that's intentional and safe here. It's a throwaway wallet made just for this, funded only with testnet GLM from the Braga DB-chain 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 "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE"
- Codex CLI → run: codex mcp add arkiv -- npx -y mcp-remote "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE"
- Gemini CLI → add {"arkiv": {"httpUrl": "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE"}} under "mcpServers" in ~/.gemini/settings.json
- Cursor or any other MCP client → add {"arkiv": {"url": "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE"}} 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 it works. If the Arkiv tools are already loaded, call arkiv_accountInfo FIRST — it confirms WHICH wallet will sign (it should match the wallet in the URL). Otherwise probe the endpoint:
curl -s -X POST "https://arkivmcp.vercel.app/api/mcp?private_key=YOUR_PRIVATE_KEY_HERE" -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: (Restart this session first so the Arkiv tools appear.)
4. If verification failed, show me the error line you got and stop there — don't retry endlessly.
Just reply with the final status — no need for a long walkthrough.On connect
Skills & prompts
Once connected, your AI gets Arkiv’s tools, docs and prompts.
No additional setup needed.
Reference
The tools in the MCP
Grouped by the job you’re doing.
Your agent picks the right one for the ask.
Check your wallet
arkiv_accountInfoarkiv_getConfigCreate & change records
arkiv_createEntityarkiv_updateEntityarkiv_extendEntityarkiv_deleteEntityarkiv_mutateEntitiesQuery records
arkiv_rawQueryarkiv_getEntityarkiv_entityCountarkiv_blockTimingSee recent changes
arkiv_streamEntityEventsSend feedback
arkiv_submitFeedbackFull CRUD, queries, recent entity events, and account info, all callable in plain English.