sockodds-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SOCKODDS_DEMO | No | Set to 1 to try the tools with invented sample data and no key. Ignored when a key is set. | off |
| SOCKODDS_API_KEY | No | Your SockOdds key. Sent only in the x-api-key header. Without it the odds tools explain how to get one. | |
| SOCKODDS_BASE_URL | No | API base URL | https://api.sockodds.com/v2 |
| SOCKODDS_TIMEZONE | No | Time zone for start times (UTC is always shown too) | Australia/Sydney |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_leaguesA | List the leagues SockOdds carries and whether this API key's plan can read each one. The free Developer plan covers MLB, NFL, AFL and NRL. Use it when you are unsure of a leagueID. |
| find_eventA | Find upcoming events (games) from a plain question such as 'Broncos v Bulldogs', 'AFL grand final' or 'Lions Crows'. Returns matching events with start times (local and UTC), event IDs and the best head to head price per side. Pass league_id whenever you know the league (for example AFL, NRL, NFL, MLB): it keeps the search small, because every event returned counts as one object against the key's monthly allowance. With no team named, it lists the soonest events in the league. |
| get_oddsA | Get every bookmaker's current decimal prices for one event's main markets: head to head (with the draw where the sport has one), line (handicap) and total points. Each price shows the bookmaker and when it was last seen. Set all_markets to true to include every priced market, such as halves and props. Costs one object. |
| best_priceA | Find the best (highest) decimal price for one side of one market across bookmakers, and show the rest of the field. Only prices open right now count; suspended or expired prices are listed separately. For line and total markets prices are compared at one line only: the line you give, else SockOdds' consensus line. Give market and side, or an exact odd_id from get_odds. Costs one object. |
| fair_oddsA | Work out the no-vig (margin-free) fair price for a two- or three-way market. Method: for each bookmaker that prices every outcome at the same line, convert prices to implied chances (1 / decimal price), divide by their total so they add to 100% (the proportional method), then average those chances across bookmakers and convert back (1 / chance). Also reports each bookmaker's margin and the combined margin of the best prices. Use event_id and market for live prices, or pass prices to calculate by hand with no API call. The result estimates the chance; it is not a prediction or a tip. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool targets a distinct stage of the workflow: list_leagues and find_event handle discovery, get_odds retrieves all prices for an event, best_price isolates the top price for one side, and fair_odds computes margin-free prices. The only mild overlap is get_odds vs best_price, both returning prices, but the descriptions clearly separate 'all bookmakers/markets' from 'best price for one side'.
All names use consistent snake_case, but the convention is mixed: list_leagues, get_odds and find_event are verb_noun, while best_price and fair_odds are adjective_noun rather than verbs. Readable but not a single predictable pattern.
Five tools is a tight, well-scoped set for a sports-odds API, covering discovery, retrieval and analysis without redundancy. Slightly lean, but every tool earns its place.
The surface covers the core lifecycle: find leagues, find events, fetch odds, find best price and derive fair odds. Minor gaps exist (no bookmaker listing, historical odds, or event detail beyond odds), but main betting workflows are workable.