Skip to main content
Tokenomist MCP is protected by OAuth 2.1 (with PKCE). The first time your client connects, you’ll be redirected to a Tokenomist sign-in page to authorize access — after that, your client refreshes tokens silently.

​
What you’ll need

A Tokenomist API key. Find it at tokenomist.ai/profile#my-api-key under the My API Key section — copy it with the copy icon. If you don’t have one yet, generate it there — Free accounts can create one too. Rotating your API key revokes existing MCP sessions.
Tokenomist My API Key page

Find your API key at tokenomist.ai/profile#my-api-key

​
How the sign-in flow works

1

Add the server to your client

Add the Tokenomist MCP server to your client (see Getting started).
2

Authorization is discovered

On first connection, your client automatically discovers that authorization is required and opens a browser tab to the Tokenomist sign-in page.
3

Paste your API key

Paste your Tokenomist API key on that page and click Authorize.
Tokenomist authorization page

Paste your API key on the Tokenomist authorization page

4

Token is issued

The browser redirects back to your MCP client, which now holds a short-lived access token. Refreshes happen silently in the background.
5

You're connected

Subsequent tool calls happen automatically — no further prompts.
The browser flow only happens once per client + machine. If you reinstall your client, switch machines, or revoke your token, you’ll be prompted to authorize again.

​
Scopes

Two OAuth scopes are exposed:
  • mcp:read — read tokenomics data via MCP tools
  • mcp:write — used by the self-listing tools to create, update, and submit token listing drafts
Most clients request both scopes by default. Modern MCP clients (Claude Desktop, Claude Code, ChatGPT, Cursor, etc.) handle OAuth discovery, registration, and token refresh automatically — no manual configuration required.

​
Troubleshooting

Some clients only trigger the OAuth flow on the first tool call rather than at install time. Try sending a quick prompt like “List tokens on Tokenomist” — the sign-in page should open then.
Your access token may have expired without a successful refresh. In most clients you can re-run the connection step (Claude Desktop: restart the app; Claude Pro: re-enable the connector; Claude Code: run /mcp, select tokenomist-mcp, then Authenticate). You’ll be sent through the sign-in page again.
Rotate your Tokenomist API key from your account settings. All existing MCP sessions tied to the old key are invalidated immediately. You’ll be re-prompted on the next request from any connected client.
Expected. Tokens are stored locally per client + machine. Paste your API key on the sign-in page and you’re back in.
Not yet — the current flow requires an interactive browser sign-in. Headless / service-account auth is on the roadmap.