Overview - Allium Documentation Hub

Allium’s MCP Server lets your AI agents query blockchain data using structured tool calls—no REST or custom glue code required. Agents can run saved Explorer queries, execute raw SQL, and introspect Allium schemas via the Model Context Protocol (MCP).

Using a chatbot like ChatGPT, Claude, or Copilot? See the Chatbots section for setup instructions.

Quick Start

Get connected in under 30 seconds:

Run the installer

npx @allium-labs/mcp install

The installer will prompt you to select your AI tool and enter your API key. It supports Claude Code, Cursor, VS Code, Windsurf, and 10+ other clients.

Get an API Key

Generate an API key at app.allium.so/settings/api-keys.

Restart your client

Restart your AI tool to load the new MCP server.

Start Querying

Ask your agent to query blockchain data—it now has access to 80+ chains via Allium.

Prefer manual setup?

See the API Key Authentication section below for manual configuration instructions.

Key Benefits

Structured Tool Calls

No REST API glue code needed—agents use standard MCP tool calls

Schema Discovery

Semantic search and introspection of Allium’s data schemas

Universal Compatibility

Works with any MCP-compatible agent framework

Production Ready

Reliable access to Allium’s enterprise-grade blockchain data

API Key Authentication

Recommended for most users. API key auth works with all coding agents and MCP clients. Generate a key at app.allium.so/settings/api-keys.

Automatic Setup

The fastest way to get started — works with 13+ clients:

npx @allium-labs/mcp install

For non-interactive environments (CI/CD, scripts):

npx @allium-labs/mcp install --client claude-code --api-key YOUR_KEY --yes

Supported Clients

The installer supports the following clients: Claude Code, Cursor, Claude Desktop, VS Code (GitHub Copilot), Codex, Cline, RooCline, Windsurf, Warp, Gemini CLI, Goose, Zed, and Opencode.

Don’t see your client listed? Reach out to contact@allium.so and we’ll add support for it.

Manual Setup

If you prefer to configure manually:

claude mcp add --scope user --transport http allium https://mcp.allium.so --header "X-API-KEY: <your-api-key>"

Then restart Claude Code.

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "allium": {
      "url": "https://mcp.allium.so",
      "headers": {
        "X-API-KEY": "<your-api-key>"
      }
    }
  }
}

Then restart Cursor.

Add the server:

codex mcp add allium --url https://mcp.allium.so

Then add your API key to ~/.codex/config.toml:

[mcp_servers.allium]
url = "https://mcp.allium.so"
http_headers = { "X-API-KEY" = "<your-api-key>" }

Then restart Codex.

{
  "tools": [
    {
      "name": "explorer_run_query",
      "server": "https://mcp.allium.so",
      "headers": {
        "X-API-KEY": "<YOUR_API_KEY>"
      }
    },
    {
      "name": "explorer_run_sql",
      "server": "https://mcp.allium.so",
      "headers": {
        "X-API-KEY": "<YOUR_API_KEY>"
      }
    }
  ]
}

Add explorer_fetch_schema and explorer_search_schemas the same way. You can also add any of the Realtime API tools.

For streamable-http or other CLI-based setups:

{
  "mcpServers": {
    "allium": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.allium.so",
        "--header",
        "X-API-KEY:${API_KEY}"
      ],
      "env": {
        "API_KEY": "<your-api-key>"
      }
    }
  }
}

This enables local agent tool streaming with auth injected from environment variables.

Configure your MCP client to connect to https://mcp.allium.so with the X-API-KEY header set to your API key.Most MCP clients support HTTP transport with custom headers. Refer to your client’s documentation for specific configuration details.

Chatbots

If you’re using a coding agent like Claude Code or Cursor, use the Quick Start above instead.

ChatGPT
Claude
Microsoft Copilot
Gemini

Note: Requires ChatGPT Plus, Pro, or Team plan. MCP is not available on the free plan.ChatGPT supports MCP servers as “Apps,” letting you ask questions about on-chain data directly in your chat — no code required.

Follow these steps to connect Allium MCP to ChatGPT:

Click on your username in the bottom left
Go to Settings
Navigate to Apps
Go to Advanced Settings
Select and turn on Developer Mode
Click Create App
Set MCP Server URL to: https://mcp-oauth.allium.so
Select OAuth as authentication

That’s it! By selecting the + icon and activating the Allium MCP App, you’ll be able to instantly enhance your chats with Allium’s data.

Note: Requires Claude Pro, Max, Team, or Enterprise plan.Claude supports MCP servers as “connectors,” letting you ask questions about on-chain data directly in your chat — no code required.

Follow these steps to connect Allium MCP to Claude:

Click on your user icon in the bottom left
Go to Settings (Pro / Max plans) or Organization Settings (Team / Enterprise plans)
Navigate to Connectors
Scroll down to Add Custom Connector
Add https://mcp-oauth.allium.so as the Remote MCP Server URL
(On Settings > Connectors) Find the Allium Custom Connector and click “Connect”
Log in with Google

That’s it! By selecting the + icon and activating the Allium connector, you’ll be able to instantly enhance your chats with Allium’s data.

Note: Requires Copilot Studio to configure MCP servers.With Copilot Studio, you can build custom agents and workflows that pull live blockchain data from Allium — ideal for embedding on-chain insights into enterprise tools like Teams, Power Automate, or internal dashboards.

Follow these steps to connect Allium MCP to Copilot Studio:

Click Create blank agent
Click on Tools
Select Add a Tool then Model Context Protocol
Add https://mcp.allium.so as the Server URL
Select API key authentication, using the X-API-KEY header, and click Create
Once the connector has been created, select Connection > Create new connection
Copy your API key from https://app.allium.so/settings/api-keys and paste it into Copilot
Click Create, then Add and configure

Once connected, Copilot Studio automatically discovers Allium’s tools and keeps them in sync — you can selectively enable individual tools, combine them with other connectors, and deploy your agent across Teams, Power Automate, and custom apps. See the Copilot Studio MCP documentation for full detailed integration instructions.

Gemini web does not currently support MCP. However, you can use Gemini CLI with API key authentication:

npx @allium-labs/mcp install

Select “Gemini CLI” when prompted. See the Quick Start for full instructions.

Want support for another chatbot platform? Reach out to contact@allium.so.

Tools Reference

Detailed documentation for all MCP tools

Examples

Real interaction transcripts

Run Queries

Learn how to save queries in Explorer and obtain a query ID

Explorer API

REST endpoints for running queries and retrieving results

MCP

x402

​Quick Start

​Key Benefits

Structured Tool Calls

Schema Discovery

Universal Compatibility

Production Ready

​API Key Authentication

​Automatic Setup

​Supported Clients

​Manual Setup

​Chatbots

​Related Resources

Tools Reference

Examples

Run Queries

Explorer API

Quick Start

Key Benefits

API Key Authentication

Automatic Setup

Supported Clients

Manual Setup

Chatbots

Related Resources