# SockOdds (npm · sockodds-mcp)

Australian sports odds from SockOdds API v1: bookmaker prices, best price and no-vig fair odds.

- Trust score: 68/100 (medium)
- Change this week: +30
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-18

## Components

- npm · `sockodds-mcp`: 68/100 (this document), [markdown](https://verifymcp.io/servers/jameselle-sockodds-mcp/sockodds-mcp.md), [page](https://verifymcp.io/servers/jameselle-sockodds-mcp/sockodds-mcp)

## Channel facts

- Registry: `npm`
- Package: `sockodds-mcp`
- Version: `1.1.0`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-18.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 4 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 66/100
  - AI-judged instruction clarity (excellent).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 5 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**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.

## Install

### 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.

### Claude

```bash
claude mcp add jameselle-sockodds-mcp -- npx -y sockodds-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "jameselle-sockodds-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sockodds-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "jameselle-sockodds-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sockodds-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add jameselle-sockodds-mcp -- npx -y sockodds-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jameselle-sockodds-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "sockodds-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jameselle-sockodds-mcp --command npx --arg -y --arg sockodds-mcp
```

### Hermes

```yaml
mcp_servers:
  jameselle-sockodds-mcp:
    command: "npx"
    args: ["-y", "sockodds-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "jameselle-sockodds-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "sockodds-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add jameselle-sockodds-mcp -t stdio -c npx -a -y sockodds-mcp
```

### Other

```json
{
  "mcpServers": {
    "jameselle-sockodds-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sockodds-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-14 (score 68, +30)

- [security regression] Known CVEs: pass → unverified
- [security improvement] 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).
- [functional regression] Dependency health: 0.85 → unverified
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] 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

### 2026-10-13 (score 38, 0)

- [functional] Package version: 0.1.0 → 1.0.0

### 2026-10-12 (score 38, 0)

- [functional regression] Security disclosure: unverified → fail

### 2026-10-11 (score 38)

First indexed and scored.

## MCP tools (5)

### `list_leagues` (~97 tokens)

List leagues

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.

Input parameters:

- `sport_id` (string): Optional sport key filter, for example australian_football, rugby_league or soccer

### `find_event` (~221 tokens)

Find an event

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.

Input parameters:

- `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, required): Plain question or team names, for example 'Broncos v Bulldogs' or 'AFL grand final'

### `get_odds` (~163 tokens)

Get odds for an event

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).

Input parameters:

- `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, required): Event ID from find_event, for example ev_000ckk0nc1tg

### `best_price` (~227 tokens)

Best price

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.

Input parameters:

- `event_id` (string, required): 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)

### `fair_odds` (~218 tokens)

No-vig fair odds

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.

Input parameters:

- `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

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/jameselle-sockodds-mcp/sockodds-mcp#diagnostics

## Score history

- 2026-10-18: 68
- 2026-10-17: 68
- 2026-10-16: 68
- 2026-10-15: 68
- 2026-10-14: 68
- 2026-10-13: 38
- 2026-10-12: 38
- 2026-10-11: 38

## Common questions

### 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.

## Links

- npm package: https://www.npmjs.com/package/sockodds-mcp
- Socket report: https://socket.dev/npm/package/sockodds-mcp
- Repository: https://github.com/jameselle/sockodds-mcp
- Website: https://sockodds.com/
- Changelog RSS feed: https://verifymcp.io/servers/jameselle-sockodds-mcp/sockodds-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/jameselle-sockodds-mcp/sockodds-mcp.json
- HTML version of this page: https://verifymcp.io/servers/jameselle-sockodds-mcp/sockodds-mcp