The Graph Token API MCP
About
Official MCP server that turns The Graph’s Token API into a plug-and-play web3 data tool. Exposes ERC-20 & NFT metadata, balances, transfers, top-holder stats, prices, and more, allowing LLMs to run SQL queries on structured and indexed blockchain data.
Details
- Author
- pinax-network
- Downloads
- 241
- Categories
- Developer Tools
Jump to
- Runs with the Bun runtime
- Provides SSE and HTTP streaming endpoints
- Connects to a ClickHouse database
- Configurable via CLI flags and environment variables
- Supports pretty and verbose logging options
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
The Graph Token API MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run with bun run index.ts. Configure via CLI options or environment variables for port, ClickHouse URL, database name, username, password, and logging preferences. The server listens on http://localhost:8080/sse (SSE) and http://localhost:8080/stream (HTTP streaming) by default.
list_databases
List available databases
list_tables
List available tables from a database
describe_table
Describe the schema of a table from a database
run_query
Run a read-only SQL query
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"the graph token api mcp": {
"token-api": {
"command": "npx",
"args": [
"@pinax/mcp",
"--sse-url",
"https://token-api.mcp.thegraph.com/sse"
],
"env": {
"ACCESS_TOKEN": "<https://thegraph.market JWT Access Token>"
}
}
}
}
}McpServers
{
"token-api": {
"command": "npx",
"args": [
"@pinax/mcp",
"--sse-url",
"https://token-api.mcp.thegraph.com/sse"
],
"env": {
"ACCESS_TOKEN": "<https://thegraph.market JWT Access Token>"
}
}
}mcp-token-api
Run with Bun:
$ bun run index.ts
Server will be running on http://localhost:8080/sse for SSE and http://localhost:8080/stream for HTTP streaming.
Usage: mcp-token-api [options]
MCP server for The Graph Token API
Options:
-V, --version output the version number
-p, --port <number> HTTP port on which to attach the MCP SSE server (default: "8080", env: PORT)
--url <string> Database HTTP hostname (default: "http://localhost:8123", env: URL)
--database <string> The database to use inside ClickHouse (default: "default", env: DATABASE)
--username <string> Database user for API (default: "default", env: USERNAME)
--password <string> Password associated with the specified API username (default: "", env: PASSWORD)
--pretty-logging <boolean> Enable pretty logging (default JSON) (choices: "true", "false", default: false, env: PRETTY_LOGGING)
-v, --verbose <boolean> Enable verbose logging (choices: "true", "false", default: false, env: VERBOSE)
-h, --help display help for command
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
