Axiom Oracle — MCP Server

Make Axiom Oracle callable from any Model Context Protocol–compatible AI agent without writing custom SDK integration code.

Important: Axiom Oracle currently operates on Solana devnet only. Attestations have audit-trail value but are NOT mainnet-grade financial records. See Production status.

What this lets your AI agent do

The Axiom Oracle attests real-world-asset (RWA) data on Solana. Once you add this MCP server to your agent's config, the agent can — during reasoning — call:

Quick start — add to your agent

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "axiom-oracle": {
      "url": "https://mcp.axiomstack.dev",
      "headers": {
        "Authorization": "Bearer YOUR_BEARER_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Desktop. The four Axiom Oracle tools appear in the tools list. Omit the headers block to use the anonymous read tier (no token required, but axiom_request_attestation will return 401).

Some Claude Desktop versions only support stdio MCP servers. If yours rejects the url field, use the mcp-remote stdio bridge instead.

Cursor

In Cursor settings → MCP Servers, add the same {url, headers} JSON object.

Cline / Continue / Goose

These clients accept the same MCP server config shape. Consult each client's MCP docs for the exact config file location; the entry's content is the same {url, headers} JSON object.

Programmatic (Python — for testing or custom agent integration)

from mcp.client.session import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://mcp.axiomstack.dev",
    headers={"Authorization": "Bearer YOUR_BEARER_TOKEN_HERE"},
) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        # ... invoke tools as needed

Quick smoke test — curl

# Anonymous tier — current fee for equity attestation request
curl -sS -X POST https://mcp.axiomstack.dev/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"axiom_quote_fee","arguments":{"asset_class":2}}}' | jq

# Authenticated tier — request a fresh NVDA attestation (spends devnet SOL)
curl -sS -X POST https://mcp.axiomstack.dev/mcp \
  -H 'Authorization: Bearer YOUR_BEARER_TOKEN_HERE' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"axiom_request_attestation",
                 "arguments":{"asset_id":"NVDA","asset_class":2}}}' | jq

Tool reference

`axiom_quot

... View full README on GitHub