SockOdds
NPM · SOCKODDS-MCP
Australian sports odds from SockOdds API v1: bookmaker prices, best price and no-vig fair odds.
Available components
Last scanned (16 hours ago)
Scores higher than 38% of npm servers
Category Finance and Payments
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 92 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 4 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability66
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1060 tokens (~212/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 5 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 14 Oct 26 +30
- Known CVEs: pass → unverified ▼ security
- Injection markers: unverified → pass ▲ security
- First check of Judged manipulation: pass security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Dependency health: 0.85 → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Schema quality: fail functional
- First check of Schema quality: excellent functional
- First check of Destructive annotations: pass functional
- First check of Schema quality: fail functional
- First check of Tool coverage: 100 functional
- Package version: 1.0.0 → 1.1.0 functional
- 13 Oct 26 0
- Package version: 0.1.0 → 1.0.0 functional
- 12 Oct 26 0
- Security disclosure: unverified → fail ▼ functional
- 11 Oct 26 38
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 18 Oct 2026 · Analysed npm/sockodds-mcp@1.1.0
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 92 packages
| Packages resolved | 92 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
best_price Best price ~227
Find the best (highest) decimal price for one side of one market across bookmakers, and show the rest of the field. Only available prices count. For line and total markets prices are compared at one line only: the line you give, else the line most bookmakers quote. Give market and side, or an exact outcome_id (oc_...) from get_odds with all_markets.
| Name | Type | Req | Description |
|---|---|---|---|
| event_id | string | yes | Event ID from find_event |
| line | number | – | Compare at this line. For a line market this is the chosen side's own handicap, for example -2.5 |
| market | string | – | h2h, h2h_3way, line or total |
| outcome_id | string | – | Exact outcome_id (oc_...) from get_odds with all_markets, instead of market and side, for any market |
| side | string | – | home or away (h2h, line; competitor_1 or competitor_2 in tennis and UFC), draw (h2h_3way), over or under (total) |
No output schema declared.
No examples provided.
fair_odds No-vig fair odds ~218
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.
| Name | Type | Req | Description |
|---|---|---|---|
| event_id | string | – | Event ID from find_event (with market) |
| line | number | – | Line to use: the home team's handicap for a line market, the total for a total market |
| market | string | – | h2h, h2h_3way, line or total |
| prices | object | – | Calculate by hand from these decimal prices instead of calling the API |
No output schema declared.
No examples provided.
find_event Find an event ~221
Find upcoming and live events (games) from a plain question such as 'Broncos v Bulldogs', 'AFL grand final' or 'Australia v New Zealand'. Returns matching events with start times (local and UTC) and event IDs (ev_...), but no prices. Pass league_id whenever you know the league (for example afl, nrl, nfl, mlb, rlwc): 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.
| Name | Type | Req | Description |
|---|---|---|---|
| days_ahead | integer | – | Only events starting within this many days. Default 14. |
| league_id | string | – | League key, for example afl, nrl, nfl, mlb or rlwc. Strongly recommended. |
| limit | integer | – | Most events to fetch. Default 25 with a league, 50 without. |
| query | string | yes | Plain question or team names, for example 'Broncos v Bulldogs' or 'AFL grand final' |
No output schema declared.
No examples provided.
get_odds Get odds for an event ~163
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 the main total. Each price shows the bookmaker and when SockOdds saw it. Set all_markets to true to include every priced market, such as halves and props (this costs more objects: one for the event plus one per priced outcome).
| Name | Type | Req | Description |
|---|---|---|---|
| all_markets | boolean | – | Include every priced market, not just head to head, line and total |
| bookmakers | string | – | Optional comma separated bookmaker keys, at most 20, for example sportsbet,tab |
| event_id | string | yes | Event ID from find_event, for example ev_000ckk0nc1tg |
No output schema declared.
No examples provided.
list_leagues List leagues ~97
List the leagues SockOdds carries, with each league's key (for example afl, nrl, nfl, mlb, rlwc). The free Developer plan covers MLB, NFL, AFL, NRL and the Rugby League World Cup (men's and women's). Use it when you are unsure of a league key.
| Name | Type | Req | Description |
|---|---|---|---|
| sport_id | string | – | Optional sport key filter, for example australian_football, rugby_league or soccer |
No output schema declared.
No examples provided.
How do I install the SockOdds MCP server?
SockOdds runs locally as an npm package, launched with npx -y sockodds-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · sockodds-mcp
claude mcp add jameselle-sockodds-mcp -- npx -y sockodds-mcp
What is the SockOdds MCP server?
SockOdds is an MCP server listed in the public MCP registry as io.github.jameselle/sockodds-mcp. Australian sports odds from SockOdds API v1: bookmaker prices, best price and no-vig fair odds. This page covers its npm package (sockodds-mcp).
Is the SockOdds MCP server safe to use?
SockOdds scores 68 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 18 October 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the SockOdds MCP server expose?
SockOdds exposes 5 tools: list_leagues, find_event, get_odds, best_price, fair_odds. Their descriptions and schemas cost roughly 926 tokens of context every time the server is loaded.
Is the SockOdds MCP server still maintained?
SockOdds is still listed as active in the MCP registry. We last reached this channel on 18 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the SockOdds MCP server under?
SockOdds declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.