Skip to main content
The Coinversa MCP server exposes the Pulse tools to AI agents over the Model Context Protocol. You install it once in your client, and the agent gets first-class access to Hyperliquid trader analytics, HIP-4 outcomes, live risk, and the cross-market asset registry. The MCP is the agent interface — a curated set of tools wrapping the REST API. If you need direct programmatic access to the full endpoint surface (including endpoints not yet exposed as tools, like builder analytics) or x402 pay-per-call, use the REST API directly. Both use the same API key. Hosted MCP endpoint: https://mcp.coinversa.ai/mcp Source: github.com/Coinversaa/mcp-server The hosted endpoint uses OAuth: paste the URL into your client and it opens a Coinversa authorization page in your browser. Sign in — or create an account right there — and connect a key in one click: existing accounts pick any of their keys from a list (no need to have the value saved), new accounts get a key created automatically. New accounts get 14 days of Pro, no credit card. No headers, no config beyond the URL.
Prefer pasting? The authorization page also accepts a saved cvsa_ key directly. Either way, your key never travels through the client: connecting hands over a single-use, 2-minute code, and the MCP server stores only an opaque reference — never the key itself. Keys stay revocable any time from the developer portal — revoking a key instantly disconnects every agent that authorized with it.

​
Claude.ai (web)

Use the Custom Connectors UI — no local install.
1

Open the connector modal

Visit claude.ai/customize/connectors?modal=add-custom-connector.
2

Fill in the form

  • Name: Coinversa
  • URL: https://mcp.coinversa.ai/mcp
Leave the auth fields empty — Claude discovers the OAuth flow automatically.
3

Authorize

Claude opens the Coinversa authorization page. Sign in and pick a key — or sign up and one is created for you — then click Authorize.
4

Verify

Open a new chat and ask: “What’s the global trading stats from Coinversa Pulse?” — Claude should call pulse_global_stats.

​
Claude Desktop

Claude Desktop reads MCP servers from a local JSON config.
1

Locate your config file

2

Add the Coinversa entry

If the file already has other mcpServers, just add coinversa alongside them — don’t replace the whole block.
3

Restart and authorize

Fully quit (Cmd+Q / right-click → quit), then reopen. On first connection mcp-remote opens the Coinversa authorization page in your browser — sign in and click Authorize. Look for the Coinversa tool icon in the chat input.
Why mcp-remote? Claude Desktop only speaks stdio MCP today; mcp-remote is a small shim that bridges stdio ↔ HTTP and handles the OAuth dance for you.

​
Cursor

Cursor supports HTTP MCP servers natively. Add to your ~/.cursor/mcp.json:
Restart Cursor, approve the authorization prompt in your browser, and the Coinversa tools appear in the agent’s tool palette. (The one-click Install in Cursor deeplink at developers.coinversa.ai/connect works too.)

​
Perplexity

Use Perplexity’s Custom Connectors.
1

Open connectors

Visit perplexity.ai/computer/connectors.
2

Add custom connector

  • URL: https://mcp.coinversa.ai/mcp
No headers needed.
3

Authorize

Perplexity opens the Coinversa authorization page — sign in (or create a free account; every new account gets 14 days of Pro) and click Authorize.

​
Other clients (stdio / npx)

For any stdio-based MCP client, run the published server directly with your API key from the developer portal:
This runs the same tools locally over stdio, authenticated by the env key instead of OAuth.

​
Verify it works

Regardless of client, ask the agent:
Use Coinversa Pulse to show me the top 5 traders on Hyperliquid by total PnL this week.
You should see the agent call pulse_leaderboard and return ranked addresses with PnL stats. If it says “no tool available,” the install didn’t take — restart the client.

​
Troubleshooting

Your authorization expired or the key behind it was revoked. Reconnect the connector (your client will reopen the authorization page). If you revoked the key on purpose, sign in during authorization and pick another key — or create a fresh one right there.
The MCP connection didn’t initialize. For Claude Desktop, check Console.app on macOS for mcp errors. For Cursor, check the MCP panel in settings. Most often: missing -y on the npx command, or a JSON syntax error in the config.
You may have an aggressive prompt or you share a key with a bot. The MCP and direct-API calls share one quota — see authentication. Ask the agent to call pulse_my_plan to see your tier and limits, and bump to Starter or Pro if you genuinely need more.
Clone Coinversaa/mcp-server and run npm run start:http. Set COINVERSAA_API_URL if you also host the backend.