Skip to main content
[ ARKIV ]HUB

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 7d
YouWhat tasks do I have?
arkiv_rawQuery type = "task"→ 2 results
TaskExpires
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_accountInfo

Paste 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_getConfig
Create & change records
arkiv_createEntityarkiv_updateEntityarkiv_extendEntityarkiv_deleteEntityarkiv_mutateEntities
Query records
arkiv_rawQueryarkiv_getEntityarkiv_entityCountarkiv_blockTiming
See recent changes
arkiv_streamEntityEvents
Send feedback
arkiv_submitFeedback

Full CRUD, queries, recent entity events, and account info, all callable in plain English.