Overview

Allium’s MCP Server lets your AI agents query blockchain data using structured tool calls—no REST or custom glue code required. 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

Turn on connections

Go to app.allium.so/mcp and enable Allow chatbots to connect.

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.

Building with a coding agent or in CI? Claude Code, Cursor, Codex, and other CLI tools connect with an API key instead — see API Key Authentication. One command: npx @allium-labs/mcp install.

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

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.

Sign-in is the recommended path. No API key to manage, and access follows your Allium account. It requires Allow chatbots to connect to be enabled at app.allium.so/mcp.

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

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. 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 — 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. Use Gemini CLI with API key authentication instead:

npx @allium-labs/mcp install

Select “Gemini CLI” when prompted. See API Key Authentication for full instructions.

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

API Key Authentication

For coding agents, CLIs, and CI. Where sign-in isn’t available or a non-interactive credential is required, connect to https://mcp.allium.so with an API key. Generate one at app.allium.so/settings/api-keys.

Prefer sign-in when your client supports it — an API key is a long-lived secret you have to store and rotate, and it doesn’t need the App toggle. Both paths reach the same tools.

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 [email protected] 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": "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

API Key Authentication

Automatic Setup

Supported Clients

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

​API Key Authentication

​Automatic Setup

​Supported Clients

​Manual Setup

​Related Resources

Plugins

Tools Reference

Billing & limits

Examples

Run Queries

Explorer API

Quick Start

Key Benefits

What your agent can do

Chatbots

API Key Authentication

Automatic Setup

Supported Clients

Manual Setup

Related Resources