Skip to content
AI QUICKSTART

Set up RealtimeAPI in your AI agent

Pick your agent, copy & paste the prompt to your AI agent. It adds our MCP, gets a free key (1,000 calls a month), then makes a test call.

Setup prompt for Claude Code paste into your agent's chat
Set up RealtimeAPI.ai for me in Claude Code. It gives AI agents real-time crypto, stock and market data through one API, paid per call in USDC or with a free key.
If you can run commands or edit files yourself, do each step. Otherwise walk me through them one at a time and wait for me to confirm each one.

Step 1: Add the MCP server
Run: claude mcp add --transport http realtimeapi https://mcp.realtimeapi.ai/mcp

Step 2: Add the RealtimeAPI skill
Run: mkdir -p ~/.claude/skills/realtimeapi && curl -fsSL https://realtimeapi.ai/skills/realtimeapi/SKILL.md -o ~/.claude/skills/realtimeapi/SKILL.md

Step 3: Get access
Ask me for my email, then call the create_free_key tool with it (or POST https://api.realtimeapi.ai/keys/free with {"email": "<my email>"}). It returns a free key: 1,000 calls a month across every feed. Save it for me: set it as the RTAPI_KEY environment variable and run claude mcp remove realtimeapi, then claude mcp add --transport http realtimeapi https://mcp.realtimeapi.ai/mcp --header "X-API-Key: <the key>". Never ask me to paste a key into this chat, and do not repeat the full key back to me.
If I already pay with an x402 wallet (USDC on Base), you can skip the key and pay per call instead: https://realtimeapi.ai/docs#x402

Step 4: Check it works
Call discover with "bitcoin market health", then call_feed on the best match (or GET https://api.realtimeapi.ai/v1/cryptodata/market-health with the X-API-Key header). Give me a five-line summary of what came back and how old the cached copy is (the X-RTAPI-Data-Age header, seconds since the gateway fetched it; the data's own timestamp is in the body). Then call list_feeds and tell me what else I can ask for.

Reference: https://realtimeapi.ai/llms.txt (catalog and prices) and https://realtimeapi.ai/docs.

What the prompt does

1 Adds the MCP server Tools: discover, list_feeds, get_quote, call_feed, create_free_key.
2 Installs the skill Teaches the agent when and how to use the API, from the live catalog.
3 Gets access A free key (1,000 calls / month), stored safely, or pay per call with x402.
4 Makes a test call Fetches bitcoin market health and summarises it with data freshness.

Prefer doing it by hand?

Three steps, any MCP client.

1

Add the MCP server

Streamable HTTP. Tools: discover, list_feeds, get_quote, call_feed, create_free_key.

shell · json
claude mcp add --transport http realtimeapi https://mcp.realtimeapi.ai/mcp

# or in any MCP client config
{
  "mcpServers": {
    "realtimeapi": {
      "url": "https://mcp.realtimeapi.ai/mcp"
    }
  }
}
2

Add the skill

Teaches the agent when and how to use the API. Generated from the live catalog.

shell
mkdir -p ~/.claude/skills/realtimeapi
curl -fsSL https://realtimeapi.ai/skills/realtimeapi/SKILL.md \
  -o ~/.claude/skills/realtimeapi/SKILL.md
3

Get access

A free key covers 1,000 calls a month across every feed. Or skip keys and pay per call in USDC with x402.

shell
curl -X POST https://api.realtimeapi.ai/keys/free \
  -H "content-type: application/json" \
  -d '{"email":"you@example.com"}'

# then send it on every call
curl "https://api.realtimeapi.ai/v1/cryptodata/market-health" \
  -H "X-API-Key: $RTAPI_KEY"
Setting this up yourself? Sign in with an email link, which verifies your email, and copy your key from your account.
Get my key as a human

Additional AI resources

machine-readable docs for agents and tooling

Get a free key

1,000 calls a month across every feed. Who is setting it up?

No key needed at all: agents can pay per call in USDC with x402.