Overview

Allium’s MCP Server lets your AI agents query blockchain data using structured tool calls. Its tools cover SQL and saved queries, schema and docs search, dashboards, realtime prices and balances, and Hyperliquid, all via the Model Context Protocol (MCP).

Connect with	URL
Sign-in (recommended)	`https://mcp-oauth.allium.so`
API key	`https://mcp.allium.so`

Quick Start

Add the server to your client

Add https://mcp-oauth.allium.so as a custom MCP server or connector, and choose OAuth authentication if your client asks.Per-client steps for ChatGPT, Claude, and Copilot Studio are below.

Your client opens Allium’s login page. Sign in with your Allium account and approve access.

Start Querying

Ask your agent to query blockchain data. It now has access to chains via Allium.

Using a coding agent? With our installer, building on Allium is super straightforward:

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

See Coding agents and CLIs for the full client list.

Key Benefits

Structured Tool Calls

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

What your agent can do

SQL & queries

Run SQL, save reusable Explorer queries, choose a compute profile

Knowledge & discovery

Search schemas, docs, and analyst-built Terminal dashboards

Dashboards & sharing

Build visuals and dashboards, publish share and embed links

Realtime data

Prices, balances, transactions, DeFi positions, holdings PnL

Hyperliquid

Info, fills, orders, and orderbooks through a rate-limit-free proxy

Skills

Load Allium’s own SQL and dashboard guidance into your agent

Two habits make an agent noticeably better on Allium data: call get_skill(name="sql-optimization") before writing SQL, and call realtime_get_supported_chains once per session before any realtime tool.

Chatbots

Per-client setup for the sign-in flow.

Signing in with OAuth is the recommended way to connect.

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,” so you can ask questions about on-chain data directly in your chat without writing code.

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

Select the + icon and activate the Allium MCP App to use Allium’s data in your chats.

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

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”
Sign in with your Allium account, using Google, SSO, or email

Select the + icon and activate the Allium connector to use Allium’s data in your chats.

Note: Requires Copilot Studio to configure MCP servers. Copilot Studio connects with an API key rather than sign-in, so it uses https://mcp.allium.so.With Copilot Studio, you can build custom agents and workflows that pull live blockchain data from Allium. This is useful 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 integration instructions.

Gemini web does not currently support MCP. Use Gemini CLI instead:

npx @allium-labs/mcp install --client gemini-cli --yes

Gemini CLI signs in on first use. See Coding agents and CLIs.

Want support for another chatbot platform? Reach out to [email protected].

Coding agents and CLIs

Claude Code, Cursor, Codex and the other CLI clients sign in with your Allium account. The installer writes the server into the client’s own config file:

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

Swap claude-code for your client’s slug. Most clients open the login page the first time your agent calls a tool. Claude Code and Codex need one more command before that.

Client	Slug	Sign-in
Claude Code	`claude-code`	Run `/mcp`, select allium
Cursor	`cursor`	On first use
Claude Desktop	`claude`	On first use
Codex	`codex`	Run `codex mcp login allium`
VS Code (GitHub Copilot)	`vscode`	On first use
Cline	`cline`	On first use
Windsurf	`windsurf`	On first use
Warp	`warp`	On first use
Gemini CLI	`gemini-cli`	On first use
Goose	`goose`	On first use
Zed	`zed`	On first use
OpenCode	`opencode`	On first use
Tabnine	`tabnine`	On first use
Roo Code	`roo-cline`	API key only, see below

Roo Code cannot sign in yet. Its OAuth 2.1 issue is still open, so install it with a key instead:

npx @allium-labs/mcp install --client roo-cline --api-key YOUR_KEY --yes

To configure a client by hand, point it at https://mcp-oauth.allium.so and choose OAuth authentication if it asks:

Claude Code
Cursor
Codex

claude mcp add --scope user --transport http allium https://mcp-oauth.allium.so

Then run /mcp, select allium, and finish the login in your browser.

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

{
  "mcpServers": {
    "allium": {
      "url": "https://mcp-oauth.allium.so"
    }
  }
}

Then restart Cursor.

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

Don’t see your client listed? Reach out to [email protected].

API Key Authentication

For autonomous agents, CI, and clients that can’t sign in. Use an API key when a browser sign-in is not practical, such as an agent running unattended. Connect to https://mcp.allium.so and send the key in an X-API-KEY header. Generate one at app.allium.so/settings/api-keys.

You store and rotate the key yourself, so prefer sign-in where your client supports it. Both paths reach the same tools.

Automatic Setup

The installer takes a key with --api-key, which also skips the browser step:

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

Client slugs are listed under Coding agents and CLIs.

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": "run_sql_query",
      "server": "https://mcp.allium.so",
      "headers": {
        "X-API-KEY": "<YOUR_API_KEY>"
      }
    },
    {
      "name": "get_query_run_results",
      "server": "https://mcp.allium.so",
      "headers": {
        "X-API-KEY": "<YOUR_API_KEY>"
      }
    }
  ]
}

Register search_schemas and search_docs the same way. An agent needs them to find the right tables before it writes SQL. Add any of the other available tools as needed.

Query execution is asynchronous: run_sql_query returns a run_id, and get_query_run_results fetches the rows. Register both, or your agent will never see its results. See SQL & queries.

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.

Plugins

Extend your agent with the allium-analyst plugin

Tools Reference

Every tool, by category

Billing & limits

Which tools cost credits, and the row and poll caps

Examples

What customers build with MCP

Run Queries

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

Explorer API

REST endpoints for running queries and retrieving results

Assistant

MCP

Machine Payments

Quick Start

Key Benefits

Structured Tool Calls

Schema Discovery

Universal Compatibility

Production Ready

What your agent can do

SQL & queries

Knowledge & discovery

Dashboards & sharing

Realtime data

Hyperliquid

Skills

Chatbots

Coding agents and CLIs

API Key Authentication

Automatic Setup

Manual Setup

Plugins

Tools Reference

Billing & limits

Examples

Run Queries

Explorer API

​Quick Start

​Key Benefits

Structured Tool Calls

Schema Discovery

Universal Compatibility

Production Ready

​What your agent can do

SQL & queries

Knowledge & discovery

Dashboards & sharing

Realtime data

Hyperliquid

Skills

​Chatbots

​Coding agents and CLIs

​API Key Authentication

​Automatic Setup

​Manual Setup

​Related Resources

Plugins

Tools Reference

Billing & limits

Examples

Run Queries

Explorer API

Quick Start

Key Benefits

What your agent can do

Chatbots

Coding agents and CLIs

API Key Authentication

Automatic Setup

Manual Setup

Related Resources