MCP server

cricket data for AI agents, over MCP

YorkerAPI is a hosted MCP server: one URL gives Claude, ChatGPT, Cursor or your own agent 18 read-only cricket data tools. 500 free credits every month, no card.

Get a free key Try a call in the browser

Connect in one step

Claude and ChatGPT: no key needed

Add a custom connector with this URL. The first time a tool runs, you sign in to your YorkerAPI account and press Allow; new users can create a free account from the same screen. In Claude: Settings, Connectors, Add custom connector. In ChatGPT: follow the ChatGPT steps below.

url

https://mcp.yorkerapi.com/mcp

Claude Code

bash

claude mcp add --transport http yorkerapi https://mcp.yorkerapi.com/mcp

Then run /mcp in Claude Code and sign in. To use an API key instead, add ?key=YOUR_API_KEY to the URL.

Claude Desktop, Cursor and other clients

json

{
  "mcpServers": {
    "yorkerapi": {
      "url": "https://mcp.yorkerapi.com/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Listing tools works without signing in; calling one needs your account or an API key, and uses its credits.

Use it in ChatGPT

ChatGPT adds outside MCP servers through developer mode. OpenAI currently offers it on workspace plans (Business, Enterprise and Edu), where an admin may need to turn it on, and it moves its menus often. Its developer mode guide has the current location of each setting.

Turn on developer mode in ChatGPT's settings (or ask your workspace admin to).
Create a custom MCP app or connector. Name it YorkerAPI, paste the server URL below, and choose OAuth as the authentication.
url
```
https://mcp.yorkerapi.com/mcp
```
ChatGPT opens a YorkerAPI sign-in page. Sign in, or create a free account on the same page, and press Allow. There is no API key to copy, so none ends up in a chat.
Start a new chat, add YorkerAPI from the tools menu, and ask something like “Show a bowler's economy rate and dot-ball share in the powerplay and in the death overs across the last three IPL seasons.”

No developer mode on your plan? Use Claude (steps above), or call the REST API from your own computer: your key stays on your machine and the responses save straight to files. See save the raw JSON in the docs.

Ask it things like

“Show a bowler's economy rate and dot-ball share in the powerplay and in the death overs across the last three IPL seasons.”
“Which batters have scored most against a given bowler across Tests, ODIs and T20s, with the strike rate and the dismissals?”
“What were each sportsbook's closing prices for the last IPL final, and how many books priced it?”
“Chart how a T20I's score built up over by over, with the wickets marked.”

18 tools

Credits per call. The same tools are REST endpoints; see the docs.

list_competitions1cr

Every competition we hold with its key, format, match count and seasons

list_teams1cr

Team ids for international sides and franchises, men's and women's

search_players1cr

Find a player's id by name, or list a team's players

get_schedule2cr

Upcoming and live matches in every competition, with both sides' ratings

get_matches2cr

Results by competition, season, team, venue or date, with scores and margins

get_ratings2cr

Our Elo ratings by format, best first

get_match5cr

One match in full: batting and bowling cards, ratings and every book's opening and closing price

get_player5cr

A career by format: runs, average, strike rate, wickets, economy, hundreds, best figures

get_player_stats5cr

A player split by season, competition, phase (powerplay, middle, death) or format

get_player_matches5cr

A player's matches with batting and bowling in each innings

get_matchup5cr

A batter against a bowler: balls, runs, strike rate, dots and every dismissal

get_leaders5cr

Leaders in runs, average, strike rate, sixes, wickets, economy

get_venue5cr

How a ground plays: par totals, batting first against chasing, toss effect

get_odds5cr

Match-winner prices by sportsbook, opening and closing, from mid-2020

get_deliveries10cr

Ball-by-ball rows for a match, a batter or a bowler, with our win probability

get_win_probability10cr

A match's win-probability worm over by over, and the balls that swung it

get_market_vs_model10cr

In-play prices beside our win probability, lined up to the exact ball

get_line_movement10cr

Every pregame snapshot by book, the market line over time, and in-play prices

Questions

What is the YorkerAPI MCP server?

A hosted Model Context Protocol server at https://mcp.yorkerapi.com/mcp. Add that URL to Claude, ChatGPT, Cursor or any MCP client and the assistant can call 18 read-only cricket data tools directly: no scraping, no local install.

Do I need to run anything locally?

No. It is a remote server over Streamable HTTP at one URL. Claude and ChatGPT connect with no key: they ask you to sign in to your YorkerAPI account the first time. Other clients send your API key as an x-api-key header or a ?key= parameter.

What does it cost?

Every account gets 500 free credits every month and no card. Connecting from an app starts you with 50 while you confirm your email, which adds the other 450. Tools cost 1 to 10 credits a call, a call that returns no data is refunded, and plans start at $19/month for 10,000 credits.

Is it the same data as the REST API?

Yes. Every MCP tool is also a REST endpoint with the same arguments and response, so an agent prototype and production code read identical data.

Which clients work?

Anything that speaks MCP over Streamable HTTP: Claude Code, Claude Desktop, ChatGPT (connectors), Cursor, Cline, Windsurf and agent frameworks with an MCP client. It is also listed on the official MCP Registry, Smithery and Glama.