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:
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):
{
"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.
| Client | How to add it |
|---|---|
| Claude Desktop | JSON config → mcpServers, then restart |
| Cursor | JSON config in MCP settings, then restart |
| Claude.ai | Settings → Connectors → Add custom connector → paste URL |
| Antigravity | Add MCP server → paste URL |
| Cline | MCP servers → add remote → paste URL |
| Continue | MCP 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:
| Tier | Limit | How |
|---|---|---|
| Anonymous | 100 calls/day per IP | Nothing — just connect |
| Free key | 1,000 calls/day | Request a tkmcp_live_* key at /mcp/key |
| Higher | 10,000+ calls/day | Contact us |
Pass the key as Authorization: Bearer tkmcp_live_…. Handshake calls (listing tools, connecting) are never limited — only the analysis calls count.
THEN WHAT?
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