Model Context Protocol

CricSynthesis for AI assistants

Ask Claude, ChatGPT, Cursor or any MCP client about a player, ground, league or upcoming match. Free to use: add the hosted connector by URL, or run the server on your own machine.

Hosted connector

Nothing to install. In claude.ai or the Claude apps open Settings, Connectors, Add custom connector, and paste:

Connector URLURL
https://mcp.cricsynthesis.in

Claude Code, or any client that takes a config file:

Terminalshell
claude mcp add --transport http cricsynthesis https://mcp.cricsynthesis.in
MCP configJSON
{
  "mcpServers": {
    "cricsynthesis": { "type": "http", "url": "https://mcp.cricsynthesis.in" }
  }
}

When you add it, your assistant asks you to sign in with your CricSynthesis account (free) and allow it: 200 tool calls a day. Or put an API key from your account in the URL (https://mcp.cricsynthesis.in/?key=cs_live_…) and calls count against its plan. 41 of the 42 tools; decision and fantasy tools answer for the matches we cover, from 3 days before the start. Custom what-ifs need the local server.

On your machine

All 42 tools, including what-if simulations with your own conditions. 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

42 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 · fantasy_picks · 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 (local) · 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.