MCP for AI assistants

The Model Context Protocol lets an AI assistant call tools on your behalf. Our MCP server offers the API as 37 read-only tools, so you can ask in plain words ("who has won the most All England titles since 2000?" or "how did Kunlavut do against Shi Yuqi this year?") and the assistant finds the ids, picks the tool, reads the answer and explains it. It uses the same key, plan and limits as the API.

Address: https://api.badmintonapi.com/mcp
Transport: streamable HTTP
Your key as Authorization: Bearer
Every tool is read-only: nothing can be changed through it

Claude Desktop and other clients

Add the server to your client's MCP settings. Most clients take a block like this one; the name on the left is yours to choose.

MCP client settings (JSON)

{
  "mcpServers": {
    "badminton": {
      "type": "http",
      "url": "https://api.badmintonapi.com/mcp",
      "headers": { "Authorization": "Bearer bda_live_..." }
    }
  }
}

Claude Code

One command in a terminal

claude mcp add --transport http badminton https://api.badmintonapi.com/mcp \
  --header "Authorization: Bearer $BADMINTON_API_KEY"

Check it by hand

The server speaks JSON-RPC over HTTP, so you can list its tools with curl before you connect an assistant. Listing needs no key; calling a tool checks yours, exactly as the API does.

List the tools

curl -s https://api.badmintonapi.com/mcp \
  -H "Authorization: Bearer $BADMINTON_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Plans and limits

Each tool calls one endpoint, so it has that endpoint's plan: on a Free key the assistant can read results, fixtures and search, and a tool above your plan answers with the plan that has it, which the assistant will tell you. Every tool call counts as one API call against your limits. MCP tools lists every tool with the endpoint it calls.

A typical exchange

Ask "how has Viktor Axelsen done against Chinese players since 2022?" and a connected assistant will search for the player to get his id, read his matches since 2022, keep the ones against Chinese opponents, and answer with the count, the wins and the matches that stand out, naming the tools it used. If it needs a plan your key does not have, it says which. You can ask it to show the calls it made, which is a quick way to learn the API itself.