MCP Server

apinn exposes an MCP server (Model Context Protocol): your AI assistant can search the documentation and call the API (list sports, fetch a match’s odds, history, specials…) directly in natural language.

MCP server URL: https://api.apinn.io/mcp (streamable HTTP transport). The documentation search MCP remains available separately at https://docs.apinn.io/mcp (no key needed). Header-less connectors (claude.ai, ChatGPT): pass the key in the URL — https://api.apinn.io/mcp?key=<YOUR_KEY> — or via the tools’ api_key argument.

Connecting the server

Claude Code
Cursor
Claude Desktop
Other MCP client

claude mcp add --transport http apinn https://api.apinn.io/mcp --header "X-API-Key: <YOUR_KEY>"

Then in a session: “list the live soccer matches”, “give me the odds for event 1632003656”.

Add to ~/.cursor/mcp.json (or Settings → MCP → Add):

{
  "mcpServers": {
    "apinn": {
      "url": "https://api.apinn.io/mcp",
      "headers": { "X-API-Key": "<YOUR_KEY>" }
    }
  }
}

In claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "apinn": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.apinn.io/mcp", "--header", "X-API-Key: <YOUR_KEY>"]
    }
  }
}

Restart Claude Desktop; the apinn server appears in the tools list.

Any MCP-compatible client (streamable HTTP transport) can connect to:

https://api.apinn.io/mcp

Authentication

The documentation search tools work without a key.
The tools that call the API use your apinn key (X-API-Key). Provide it to the assistant / in the MCP client configuration when it asks for it. Each call counts toward your hourly quota.

Never paste your key into a public repository or a screen share. Treat it as a secret.

What the assistant can do

“What sports are available?” → /api/sports
“Give me the live soccer matches” → /api/fixtures?sport_id=29&live=1
“Current odds for event 1632003656” → /api/odds
“Complete odds history for this match” → /api/odds?full_history=1
“Champions League winner: favorites’ odds” → /api/specials/outrights

All the API reference endpoints are exposed as MCP tools (read-only).

Get started

Concepts

Connecting the server

Authentication

What the assistant can do

​Connecting the server

​Authentication

​What the assistant can do

Connecting the server

Authentication

What the assistant can do