Token Economics
AI19 Jun 20265 min read

Connect your AI to live tokenomics data (MCP setup)

One URL, no SDK, no key for the free tier. Here’s the setup for every major MCP client.

You can give any MCP-aware assistant — Claude, Cursor, and friends — direct access to 300+ real tokenomics and 25 analysis tools in under a minute. No SDK, no API key for the free tier. One endpoint, one paste, restart, done.

What you’re connecting to

The Token Economics MCP is a remote HTTP server. There’s nothing to install and nothing to run locally — your client just talks to one URL:

MCP endpoint
https://tokeneconomics.io/api/mcp

It’s anonymous and free to start (rate-limited per IP). Want higher limits? Grab a free key and pass it as a bearer token — more on that below.

Clients that use a JSON config (Claude Desktop, Cursor)

Add one entry under mcpServers in your client’s config file, then restart the app. For Claude Desktop that file lives at ~/Library/Application Support/Claude/claude_desktop_config.json (create it if it isn’t there):

claude_desktop_config.json
{
  "mcpServers": {
    "tokenomics-layer": {
      "url": "https://tokeneconomics.io/api/mcp"
    }
  }
}

Cursor uses the same shape in its MCP settings. After a restart you’ll see the Token Economics tools available in the client.

Clients that paste a URL (Claude.ai, Antigravity, Cline, Continue)

Web and IDE-plugin clients let you add a remote MCP server by URL — no JSON. In Claude.ai, open Settings → Connectors, choose Add custom connector, and paste the endpoint URL. Antigravity, Cline, and Continue all have an equivalent “add MCP server” field — same URL.

All six speak remote HTTP MCP, so the same endpoint works everywhere. Per-client step-by-steps live at /install.
ClientHow to add it
Claude DesktopJSON config → mcpServers, then restart
CursorJSON config in MCP settings, then restart
Claude.aiSettings → Connectors → Add custom connector → paste URL
AntigravityAdd MCP server → paste URL
ClineMCP servers → add remote → paste URL
ContinueMCP config → add server → paste URL

Your first prompt

Once connected, confirm it works with something only the tools can answer:

  • “List the five highest-scoring DeFi launches in the corpus.”
  • “Audit this allocation: 25% team, 15% investors, 40% community, 10% liquidity, 10% airdrop — what would a VC flag?”
  • “Compare my design to UNI, ARB, and OP on insider concentration.”

If the assistant comes back with specific scores, real launch names, and source links, the connection is live and it’s calling the tools rather than guessing.

Free tier, and when to get a key

The anonymous tier is generous enough to evaluate the server and run real analyses. If you’re building an agent that hammers it, a free key lifts the cap:

TierLimitHow
Anonymous100 calls/day per IPNothing — just connect
Free key1,000 calls/dayRequest a tkmcp_live_* key at /mcp/key
Higher10,000+ calls/dayContact us

Pass the key as Authorization: Bearer tkmcp_live_…. Handshake calls (listing tools, connecting) are never limited — only the analysis calls count.

THEN WHAT?

Now that your AI can reach the data and the math, see How to analyze any token’s tokenomics with AI for the questions worth asking — and the MCP page for the full tool list and per-client guides.

Try the tool

Token Economics is the free designer behind every chart and computation in this article. Replicate any of 300+ real-world tokenomics, edit allocations, see live sell-pressure and health-score updates.

Open the editor

Building something similar?

3UILD is the web3 services team behind Token Economics. We audit tokenomics, deploy contracts, and advise on launches. 30-min review, no pitch.

Talk to 3UILD

Related reading