protogrid

Search / io.github.livetennisapi/livetennisapi-mcp

livetennisapi-mcp

R0· no sign-in

Live tennis scores, players, rankings, odds and win-probability. ATP, WTA, Challenger, ITF, juniors.

v1.5.0 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality87good
Trust94of 100
Uptime, 30 days100%
Latency p50184 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "livetennisapi-mcp": {
      "type": "http",
      "url": "https://mcp.livetennisapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${LIVETENNISAPI_MCP_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http livetennisapi-mcp https://mcp.livetennisapi.com/mcp --header "Authorization: Bearer ${LIVETENNISAPI_MCP_TOKEN}"
[mcp_servers.livetennisapi-mcp]
url = "https://mcp.livetennisapi.com/mcp"
bearer_token_env_var = "LIVETENNISAPI_MCP_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "livetennisapi-mcp": {
      "type": "remote",
      "url": "https://mcp.livetennisapi.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:LIVETENNISAPI_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "livetennisapi-mcp": {
      "type": "http",
      "url": "https://mcp.livetennisapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${LIVETENNISAPI_MCP_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=livetennisapi-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmxpdmV0ZW5uaXNhcGkuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0xJVkVURU5OSVNBUElfTUNQX1RPS0VOfSJ9fQ%3D%3D"
}
{
  "servers": {
    "livetennisapi-mcp": {
      "type": "http",
      "url": "https://mcp.livetennisapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${LIVETENNISAPI_MCP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "livetennisapi-mcp": {
      "httpUrl": "https://mcp.livetennisapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${LIVETENNISAPI_MCP_TOKEN}"
      }
    }
  }
}
extensions:
  "livetennisapi-mcp":
    enabled: true
    name: "livetennisapi-mcp"
    type: streamable_http
    uri: "https://mcp.livetennisapi.com/mcp"
    headers:
      "Authorization": "Bearer ${LIVETENNISAPI_MCP_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${LIVETENNISAPI_MCP_TOKEN}. The registry never accepts secret values.

Quality 87 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations24 of 24 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 4,906 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependencies67 · weight 15
  • pass
    deps.known_vulnsno known advisory in 99 resolved packages
  • fail
    deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
  • pass
    deps.resolvable[email protected] resolved: 99 packages

24 tools, about 4,906 tokens to load them all · tool set f572ece622e4 · checked 2026-10-20 12:13 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90
liveness100
freshness85
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% ~updated-36d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npm98 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-19

advisoryseveritypackagefixed in
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP serverhigh@modelcontextprotocol/[email protected]MCP SDK, directfixed in 1.31.0

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.livetennisapi.com/mcp streamable-httpnoneyes100%184 ms2025-11-252026-10-20
packageregistryversionruntimesecrets
livetennisapi-mcpnpm1.5.0–LIVETENNISAPI_KEY

Tools (24)

check_api_statusread-onlyCheck whether the Live Tennis API is reachable and which plan the configured key is on. Useful for diagnosing why other tools are refusing data.
get_archive_careerread-onlyOne player's whole career over the results archive (1968–2022): W-L record overall and by surface/level/year, titles, and summed serve statistics with honest coverage — the corpus records serve stats from 1991 only, so matches_with_stats states how many matches the serve block covers. The name must resolve to one person; an ambiguous fragment returns the candidate list to choose from. Requires the BASIC plan or any History plan.
get_archive_matchread-onlyOne result from the results archive (1968–2022), with per-match serve statistics where the era recorded them — stats are null for most rows before 1991, honestly, never synthesised. Requires the BASIC plan or any History plan.
get_charting_matchread-onlyEvery Match Charting Project stat family for ONE charted match, both players, with the per-set split (set 1, set 2, …, Total) exactly as charted. Charting ids are their own id space (1960–2026), mostly matches with no counterpart in the live tables. Requires the ULTRA plan.
get_charting_playerread-onlyCareer shot-level profile from the Match Charting Project: serve placement (deuce/ad × wide/body/T), return depth and outcomes, net play, clutch break/game/set-point serving, winners and errors by wing, rally-length tendencies — summed over the player's charted matches. COVERAGE IS CURATED (11,646 charted matches back to the 1960s, concentrated on the majors), not full-slate. An ambiguous name returns the candidates to choose from. Requires the ULTRA plan.
get_fixturesread-onlyUpcoming scheduled tennis fixtures, earliest first — the forward schedule, filterable by tour, player and date. Use this for "what is on this week". Works on the FREE plan (no card needed).
get_h2hread-onlyThe all-time record between two players, across BOTH halves of the product: the results archive (1968–2022) plus our own completed matches (2023 onward). Names are the keys — an ambiguous fragment returns the candidate list to choose from rather than guessing. Totals count only meetings with a known winner; walkovers and retirements are part of the record and each meeting carries its outcome. Requires the BASIC plan or any History plan.
get_live_matchesread-onlyList tennis matches currently in progress, with live scores. Covers ATP, WTA, Challenger, ITF and juniors. Use this for "what tennis is on right now". Works on the FREE plan (no card needed).
get_matchread-onlyFull detail for one match by id: players, score, surface, round and status. Includes market prices on PRO and model analysis on ULTRA. Works on the FREE plan (no card needed).
get_match_analysisread-onlyModel analysis for a match: predicted win probability, the model's thesis and the key factors behind it. Requires the ULTRA plan. Match rows carry has_analysis — check it first; a match with no thesis or profile has nothing to return.
get_match_eventsread-onlyTimeline of events for a match — breaks, games won, sets won, momentum runs. Requires the PRO plan.
get_match_oddsread-onlyMatch-winner market prices for a match — implied probability per player, with bid, ask and mid. Requires the PRO plan. Match rows carry has_market — check it first; a match with no market mapped has no prices to return.
get_match_scoreread-onlyCurrent score for one match — the fastest, lowest-latency read. Use this when you only need the score and already know the match id. Works on the FREE plan (no card needed).
get_match_statisticsread-onlyIn-play (or final) statistics for one match, in TWO families kept deliberately separate: DERIVED is rebuilt from the point-by-point record (holds/breaks, break points, service/return points); MEASURED is counted upstream and includes what no point record can yield — aces, double faults, the serve split, winners/unforced errors. Measured coverage varies by tour; absent fields are omitted, never zero-filled. Requires the ULTRA plan.
get_playerread-onlyOne player's profile: ranking, country, handedness, date of birth and cached stats. Works on the FREE plan (no card needed).
get_player_rankingsread-onlyPoint-in-time ranking records for SPECIFIC players: per system, the newest record in force ON OR BEFORE as_of — never one dated after it. Every other ranking field in this API is the CURRENT value joined at read time; this is the historical answer. Systems are never collapsed: ATP/WTA and the ITF circuits carry rank+points, UTR a rating. ITF and UTR history begins 2026-07-29. Requires the ULTRA plan.
get_rankingsread-onlyThe FULL published ranking table in rank order for one system — the newest week at or before as_of. Rows carry player_name as published and a null player_id for players outside our roster, so the table has no silent holes. ATP/WTA history runs deep; the ITF circuits begin 2026-07-29. For point-in-time records of SPECIFIC players use get_player_rankings. Requires the PRO plan.
get_recent_resultsread-onlyRecently completed tennis matches with final scores and winners. Filterable by tour, player, nationality and play date. Requires the BASIC plan or any History plan.
get_tournamentread-onlyOne tournament by its stable id — the tournament_id carried on match objects. Name, tour, surface, indoor, plus host city/country and category where curated. Works on the FREE plan (no card needed).
get_upcoming_matchesread-onlyList tennis matches scheduled to start soon, with players, tournament and start time. Use this for "who plays next" or to find a match id before it starts. Works on the FREE plan (no card needed).
search_archive_matchesread-onlySearch the results archive — completed-match RESULTS from 1968 through 2022: ATP and WTA, main draws, qualifying and the ITF/futures tiers. Winner/loser-shaped records with final score, seeds and ranks AT THE TIME of the match. Use this for historical questions ("Borg's Wimbledon finals"); the archive ends 2022-12-31 where our own results (get_recent_results) begin. Requires the BASIC plan or any History plan.
search_archive_playersread-onlyThe people of the results archive (1968–2022): hand, date of birth, country, height, and career-high rank with the week it was first reached. Their ids are corpus person ids (the winner/loser player_id on archive results), not roster ids — for current players use search_players. Requires the BASIC plan or any History plan.
search_playersread-onlySearch tennis players by name. Returns id, country, ranking and tour. Use the returned id with get_player. Works on the FREE plan (no card needed).
search_tournamentsread-onlySearch the tournament catalogue — the stable id space that match objects carry as tournament_id. Returns surface, indoor, host city/country and category where curated. Works on the FREE plan (no card needed).

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.livetennisapi/livetennisapi-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.livetennisapi.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Bearer twjp_… — your Live Tennis API key. Tools are listable without it; calling one needs it. Free key, no card: https://livetennisapi.com/subscribe/free"
        }
      ]
    }
  ],
  "version": "1.5.0",
  "packages": [
    {
      "version": "1.5.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "livetennisapi-mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "LIVETENNISAPI_KEY",
          "isSecret": true,
          "description": "Your Live Tennis API key (twjp_...). Get one free, no card, at https://livetennisapi.com/subscribe/free — the server runs without it but only the status check will work."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/livetennisapi/livetennisapi-mcp",
    "source": "github"
  },
  "websiteUrl": "https://livetennisapi.com",
  "description": "Live tennis scores, players, rankings, odds and win-probability. ATP, WTA, Challenger, ITF, juniors."
}