Arbitron MCP server
Commit Nov 9, 2026Provides read-only market data for crypto perpetual futures including funding rates, spreads, and listings to AI assistants.
Also known as arbitron-team/arbitron-api, arbitron-api
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.3.0
- Last commit
- Nov 9, 2026
- License
- MIT
What is Arbitron MCP?
Arbitron provides read-only market data for crypto perpetual futures including funding rates, spreads, and listings to AI assistants.
Summary generated from the project's README
About Arbitron MCP server
Arbitron provides read-only market data specifically for crypto perpetual futures. It serves developers and AI assistants by delivering information on current funding rates, funding history, spreads between different venues, backtested spreads from the scanner, and a listings calendar. The server is accessible via a streamable HTTP connection using the registry entry app.arbitron/mcp.
Users can connect AI clients like Claude Desktop, Cursor, and ChatGPT using OAuth 2.1 by signing in with an Arbitron account. For programmatic access, an API key is required as a bearer token. The server includes nine specialized tools such as arbitron_get_funding_rates, arbitron_get_spreads, and arbitron_get_listings to facilitate data retrieval.
Data availability depends on the selected plan. The free Demo plan offers 15-minute delayed data with a limit of 50 rows per page and excludes historical data. Paid Developer, Pro, and Business plans provide live data and access to deeper historical records for commercial use.
What you can do with it
- 1Analyze funding rate trendsAsk the AI to retrieve historical funding data for a specific coin to identify patterns.
- 2Monitor new asset listingsHave the assistant check the upcoming listings calendar for new perpetual futures.
- 3Evaluate backtested spread performanceUse the assistant to look up the scanner's backtested spreads for various pairs.
Written from the project's README. Every use case is checked against a quote from it.
How to install Arbitron MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Arbitron MCP in Claude Code
$ claude mcp add --transport http arbitron-api https://arbitron.app/mcpInstall Arbitron MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"arbitron-api": {
"url": "https://arbitron.app/mcp"
}
}
}Install Arbitron MCP in VS Code
.vscode/mcp.json
{
"servers": {
"arbitron-api": {
"type": "http",
"url": "https://arbitron.app/mcp"
}
}
}Install Arbitron MCP in VS Code CLI
$ code --add-mcp '{"name":"arbitron-api","type":"http","url":"https://arbitron.app/mcp"}'Install Arbitron MCP in Codex
$ codex mcp add arbitron-api --url https://arbitron.app/mcpInstall Arbitron MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.arbitron-api] url = "https://arbitron.app/mcp"
Install Arbitron MCP in Gemini CLI
$ gemini mcp add -s user --transport http arbitron-api https://arbitron.app/mcpInstall Arbitron MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"arbitron-api": {
"url": "https://arbitron.app/mcp",
"type": "http"
}
}
}Configuration
ARBITRON_KEY
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablearbitron-team/arbitron-api is public and reachablegithub.com/arbitron-team/arbitron-api ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/arbitron-team/arbitron-api ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubArbitron API and MCP server
Read-only market data for crypto perpetual futures across the venues Arbitron tracks: current funding rates, funding history, the spread between two venues right now, the scanner's backtested spreads, and the listings calendar. Two doors to the same data: a REST API for programs and an MCP server for AI assistants.
This repository holds the public artefacts of that product so they can be pinned, diffed and cited. The service itself is closed source.
| What | Where |
|---|---|
| Developer guide | https://arbitron.app/developers (Markdown twin: https://arbitron.app/developers/index.md) |
| API reference (Scalar) | https://arbitron.app/developers/reference |
| OpenAPI 3.1 document | https://arbitron.app/api/v1/openapi.json (a copy: openapi/openapi.json) |
| MCP server | https://arbitron.app/mcp (Streamable HTTP; registry entry app.arbitron/mcp: mcp/server.json) |
| Server card | https://arbitron.app/.well-known/mcp/server-card.json |
| Plans and keys | https://arbitron.app/developers#plans, keys at https://arbitron.app/settings/api |
| llms.txt | https://arbitron.app/llms.txt |
REST in one minute
export ARBITRON_KEY=arb_live_... # https://arbitron.app/settings/api
# The most negative funding on liquid contracts
curl -s "https://arbitron.app/api/v1/funding?max_rate_pct=-0.01&min_volume_usdt=1000000&sort=rate_asc&limit=5" \
-H "Authorization: Bearer $ARBITRON_KEY"
# The spread between venues right now, tradeable pairs only
curl -s "https://arbitron.app/api/v1/spreads?min_volume_usdt=500000&max_spread_pct=3&min_strength=2&fields=symbol,exchange_a,exchange_b,spread_pct,direction" \
-H "Authorization: Bearer $ARBITRON_KEY"
Every response is { "data": ..., "meta": { "as_of", "delayed_seconds", "source", "url", "count", "total", "next_cursor" } }. Errors are RFC 9457 problem details. Rates are percent per settlement. More in examples/.
MCP in one minute
Claude Desktop, Cursor and ChatGPT connect with OAuth 2.1 (sign in with your Arbitron account); a program connects with the same API key as a bearer token. Client configurations are in mcp/clients/. Nine read-only tools: arbitron_search_coins, arbitron_get_funding_rates, arbitron_get_coin_funding, arbitron_get_funding_history, arbitron_get_spreads, arbitron_get_spread_backtest, arbitron_get_listings, arbitron_get_exchanges, arbitron_get_usage.
Plans
The Demo plan is free: 15-minute delayed data, 50 rows per page, no history. Paid plans (Developer, Pro, Business) are live, reach further back, and include commercial use. Details at https://arbitron.app/developers#plans.
Citing
Attribute republished figures as "Data: Arbitron" with a link to meta.url, and keep meta.as_of with the number. Name the exchange and the settlement interval beside any funding rate.
Contents of this repository
openapi/openapi.json: the OpenAPI document as served, refreshed byscripts/refresh.sh.mcp/server.json: the manifest published to the official MCP registry.mcp/clients/: configuration snippets for Claude Desktop, Cursor and ChatGPT.examples/: curl, Python and Node examples.plugin.jsonandmcp.json: the Agent Plugins 1.0 package (Open Plugins standard), so clients and directories that read it discover the MCP server from the repository root..cursor-plugin/: the plugin manifest for the Cursor marketplace.
Files here are licensed under the MIT License. The data the API returns is subject to the terms.
Arbitron MCP questions
How do I add Arbitron MCP to Claude Code?
Run claude mcp add --transport http arbitron-api https://arbitron.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Arbitron MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I connect my AI assistant to Arbitron?
Claude Desktop, Cursor, and ChatGPT can connect using OAuth 2.1, while programs can connect using an API key as a bearer token.
Is there a free version of Arbitron?
Yes, the Demo plan is free and includes 15-minute delayed data and 50 rows per page, but does not include history.