Model Context Protocol

CricSynthesis MCP.Cricket for AI assistants.

Ask Claude, ChatGPT desktop, Cursor or any MCP client about any player, ground, league or team, or about an upcoming match. Answers come from a ball-by-ball model of every recorded delivery. Free, and it runs on your own machine.

Install

Needs uv. In Claude Desktop open Settings, Developer, Edit config, and add:

claude_desktop_config.jsonJSON
{
  "mcpServers": {
    "cricsynthesis": {
      "command": "uvx",
      "args": ["--index", "https://cricsynthesis.in/pypi/simple/", "cricsynthesis-mcp"]
    }
  }
}

Claude Code:

Terminalshell
claude mcp add cricsynthesis -- uvx --index https://cricsynthesis.in/pypi/simple/ cricsynthesis-mcp

41 tools

Players

Ratings, phase splits, bowling types, batting hands, situations, formats, roles, similar players and side-by-side comparisons.

search_players · player_rating · player_phases · player_vs_bowling · bowler_vs_batting_hand · player_situations · player_formats · player_role · similar_players · compare_players

Rankings and match-ups

Model leaderboards by format, phase and metric, and any batter against any bowler, ball by ball.

rankings · matchup · matchup_grid · best_bowler_against

Venues, leagues and teams

How grounds and competitions play, scoring trends by season, and the profile of any side or XI.

venues · venue_profile · competitions · competition_profile · scoring_trend · teams · team_profile

Match forecasts

Win chances, projected scores, phases, wicket timing, key duels and player outlooks for upcoming matches.

list_matches · match_forecast · innings_shape · key_matchups · player_outlook · about_the_model

Decisions

What-ifs, win probability and projections from any score, par score, chase curve, toss call, batting order, bowling plan and player impact.

simulate_scenario · live_win_probability · innings_projection · par_score · chase_curve · toss_decision · batting_order · bowling_plan · player_impact

Fantasy and graphics

Fantasy projections, a best XI with captain and vice-captain, multi-entry portfolios, and shareable SVG cards.

fantasy_projections · fantasy_team · fantasy_portfolio · match_graphic · analytics_graphic

Things to ask

Who's favourite for India v West Indies, and does the toss matter?

India are 120/4 after 15.2 overs chasing 165. Who wins?

Heavy dew and a turning pitch: how does that change the forecast?

Pick my fantasy XI and captain for the next match.

How does Suryakumar Yadav fare against left-arm spin?

Who are the best death bowlers in T20 right now?

Full API

Set CRICSYNTHESIS_API_KEY in the server's environment and an api_request tool reaches all 56 API endpoints: player and venue analytics, decision models and graphics.