MCP Server (AI Assistants)
SharpAPI includes a built-in MCP server at https://mcp.sharpapi.io/mcp — connect Claude Desktop, Claude Code, or any MCP-compatible AI assistant to query live odds and opportunities through natural language.
SharpAPI’s MCP server is listed in the mcpservers.org directory under Finance.
What is MCP?Permalink for this section
The Model Context Protocol (MCP) lets AI assistants call external tools directly. Instead of copying data from our API into a chat, your AI assistant can query SharpAPI in real-time:
“Find me the best +EV opportunities in NBA right now”
“Compare moneyline odds for the Lakers game across all sportsbooks”
“What arbitrage opportunities are available in soccer?”
SetupPermalink for this section
Source and issues: github.com/Sharp-API/SharpAPI-MCP .
Run the npm package without installing it: npx -y @sharp-api/mcp-server.
Add SharpAPI to your MCP client configuration:
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"sharpapi": {
"type": "streamable-http",
"url": "https://mcp.sharpapi.io/mcp",
"headers": {
"X-API-Key": "sk_live_..."
}
}
}
}Restart Claude Desktop after saving.
Available ToolsPermalink for this section
The MCP server exposes tools that map to SharpAPI’s REST API:
Reference DataPermalink for this section
| Tool | Description |
|---|---|
get_sports | List all sports with event and live counts |
get_leagues | List leagues, filterable by sport |
get_sportsbooks | List all sportsbooks with metadata |
get_markets | List all market types (moneyline, spread, total, player props…) |
Odds & EventsPermalink for this section
| Tool | Description | Min Tier |
|---|---|---|
get_events | Search events by sport, league, or team name | All |
get_odds | Get current odds with filters | All |
get_odds_delta | Incremental sync — only odds changed since a timestamp | All |
get_best_odds | Best odds across all books for each selection | All |
compare_odds | Side-by-side odds comparison for an event | All |
get_closing_lines | Captured closing lines for CLV analysis | Pro |
FuturesPermalink for this section
| Tool | Description | Min Tier |
|---|---|---|
get_futures | List a league’s futures (season-long markets: championship, MVP, win totals) and their ids | Enterprise |
get_futures_odds | Odds on futures, grouped by future: filter by league, team, selection or sportsbook | Enterprise |
compare_futures_lines | Cross-book comparison on one future | Enterprise |
get_futures returns the ids that get_futures_odds and compare_futures_lines take as future_id. The three tools read the endpoints described on Enterprise Endpoints.
OpportunitiesPermalink for this section
| Tool | Description | Min Tier |
|---|---|---|
find_ev_opportunities | +EV bets using Pinnacle as reference | Pro |
find_arbitrage | Cross-book arbitrage with stake sizing | Hobby |
find_middles | Middle opportunities (win both sides) | Pro |
find_low_hold | Tightest lines across books | Pro |
AccountPermalink for this section
| Tool | Description |
|---|---|
get_account_info | Your tier, rate limits, and features |
Sportsbook Access by TierPermalink for this section
Odds, best odds, and comparison results are automatically filtered to the sportsbooks your tier can access:
| Tier | Books | Examples |
|---|---|---|
| Free | 2 | DraftKings, FanDuel |
| Hobby | 5 | + BetMGM, Caesars, Fanatics |
| Pro | 15 | + SABA, Bet365, BetOnline, … |
| Sharp | 25 (any of 43) | Any 25 of the 43 live books |
| Enterprise | All | + Futures, Historical |
Rate LimitsPermalink for this section
Each MCP tool call counts as one API request against your tier’s rate limit. The initial handshake (initialize + tools/list) costs 2-3 requests — this happens once per session.
| Tier | Requests/min |
|---|---|
| Free | 12 |
| Hobby | 120 |
| Pro | 300 |
| Sharp | 1,000 |
| Enterprise | 10,000 |
Use get_account_info to check your current usage and limits.
llms.txt — API Discovery for AgentsPermalink for this section
Alongside the MCP server, SharpAPI publishes a machine-readable API summary at
https://api.sharpapi.io/llms.txt following the
llms.txt convention . It describes the base URL, authentication,
the MCP endpoint, and every available tool in a format language models parse reliably —
so an agent (or a developer pasting it into a prompt) can orient on the API in one fetch,
no key required. (This docs site serves its own separate
https://docs.sharpapi.io/llms.txt for
documentation discovery — the API one above is the machine-readable API summary.)
Point a coding agent at it directly:
Read https://api.sharpapi.io/llms.txt and use the SharpAPI REST API to ...Example ConversationsPermalink for this section
Once connected, you can ask your AI assistant questions like:
- “What sports have live events right now?”
- “Show me NBA odds for tonight’s games on DraftKings”
- “Find arbitrage opportunities in soccer with at least 1% profit”
- “Compare the odds for the Chiefs game across all books”
- “What’s my current API tier and how many requests do I have left?”
The AI will automatically call the appropriate SharpAPI tools and present the results in a readable format.