Skip to main content
Glama
syedhassaanahmed

crickey

crickey

crickey is an MCP server that answers cricket statistics questions from Cricinfo Statsguru with proof links.

crickey is for personal use at the user's own risk, Cricinfo's terms ban data-extraction tools, and crickey isn't affiliated with Cricinfo, ESPNcricinfo or ESPN.

Start it

Docker image: ghcr.io/syedhassaanahmed/crickey, tagged as a version (0.1.0), a minor version (0.1) and latest. The commands use 0.1, which gets its patch releases.

docker run -d --rm --read-only --name crickey -p 127.0.0.1:8765:8765 ghcr.io/syedhassaanahmed/crickey:0.1

Keep that container running before MCP clients connect; after a reboot, run it again. Check it: open http://127.0.0.1:8765/health in a browser; it shows {"status":"ok"}.

Stop it:

docker stop crickey

Update: pull the latest patch release, then stop the container and run it again.

docker pull ghcr.io/syedhassaanahmed/crickey:0.1

Pass a setting with -e:

docker run -d --rm --read-only --name crickey -p 127.0.0.1:8765:8765 -e CRICKEY_MIN_INTERVAL=15s ghcr.io/syedhassaanahmed/crickey:0.1

Related MCP server: cricket-mcp

Connect a client

Use this URL in your MCP client: http://127.0.0.1:8765/mcp. It isn't a web page, so a browser shows a "Missing session ID" error. If your client has a tool timeout, set it to 5 minutes.

{
  "mcpServers": {
    "crickey": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

Copilot CLI:

copilot mcp add --transport http --timeout 300000 crickey http://127.0.0.1:8765/mcp

Settings

Variable

Default

Meaning

CRICKEY_MIN_INTERVAL

15s

Minimum time between Cricinfo requests; valid 2s through 168h, with a warning below 15s.

CRICKEY_MAX_RETRIES

3

Retries after the first request; use 0 to turn retries off.

CRICKEY_BLOCK_PAUSES

5m,15m,1h,4h,24h

Pause schedule after a block; comma-separated durations, each up to 168h.

CRICKEY_MAX_PAGES

4

Maximum Statsguru result pages per tool call.

CRICKEY_CACHE_MAX_MB

64

In-memory page cache size in MB.

CRICKEY_RECENT_TTL

1h

Cache time for pages that include recent matches; up to 168h.

CRICKEY_PORT

8765

HTTP port inside the container; changing it needs a matching -p mapping.

CRICKEY_IN_CONTAINER

0

Set to 1 by the image so it can listen inside Docker.

Requests are slow because crickey waits 15 seconds between Cricinfo requests by default. The cache is only in memory, so it resets when the container stops. Run one container for all your clients so they share the cache, request spacing and block pause.

Debug stdio:

docker run -i --rm --read-only ghcr.io/syedhassaanahmed/crickey:0.1 stdio

Contributors: see AGENTS.md.

Related MCP Connectors

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Provides natural language access to IPL cricket match data, allowing users to query player statistics, team performances, and match results. It utilizes a SQLite backend and Cricsheet data to deliver detailed cricket analytics through the Model Context Protocol.
    1
    -
  • F
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that enables natural language querying of over 10 million ball-by-ball cricket deliveries stored in a local DuckDB database. It provides 26 tools for analyzing player matchups, situational stats, and historical records across all major cricket formats and tournaments.
    2
    -
  • A
    license
    A
    quality
    D
    maintenance
    Enables users to query MLB Statcast, FanGraphs, and Baseball Reference data using natural language through an AI assistant. It provides comprehensive tools for analyzing player performance, pitch-level data, season leaderboards, and team standings.
    24
    36
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Wraps CricAPI to provide live cricket data, enabling AI agents to query cricket information through natural language or direct tool calls.
    246 npm
    MIT