AcesAPI
by noahowsh · remote · no sign-in to list tools · v1.1.6 · published by GitHub user noahowsh
ATP and WTA tennis since 2007: sets, draws, rankings, head to head, surface Elo, sportsbook lines.
13 tools: 13 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads13Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http acesapi https://mcp.acesapi.com/mcp --header 'x-api-key: <your-x-api-key>'Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
13 tools
Only reads 13Claude Code: allow
get_head_to_headUse for two players' head to head: wins each, sets won, wins by surface and in finals, and every meeting with its score.No findings
Why it is in this group
- The name "get_head_to_head" says "get": a word for reading.
Description, as the server wrote it Use for two players' head to head: wins each, sets won, wins by surface and in finals, and every meeting with its score. Walkovers are listed but not counted as wins; incomplete records are not counted. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Head to head
- destructiveHint: false
get_matchUse for everything about one match: the score by set with tiebreak points, seeds, each player's sets, games and tiebreaks won, both players' ratings before and after (overall and o…No findings
Why it is in this group
- The name "get_match" says "get": a word for reading.
Description, as the server wrote it Use for everything about one match: the score by set with tiebreak points, seeds, each player's sets, games and tiebreaks won, both players' ratings before and after (overall and on the surface), what the score says (total games, tiebreaks, whether it went the distance, comebacks), and each sportsbook's opening and closing moneylines where the match had them (Grand Slam, ATP Masters and WTA 1000 matches only). No serve statistics: they are not available. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Match
- destructiveHint: false
get_matchesUse for match results by day, tournament or season: each match with both players, seeds, round, status, score and sets (games and tiebreak points).No findings
Why it is in this group
- The name "get_matches" says "get": a word for reading.
Description, as the server wrote it Use for match results by day, tournament or season: each match with both players, seeds, round, status, score and sets (games and tiebreak points). Pass a date (YYYY-MM-DD, UTC), a tournament_id or a season; filter by round (e.g. "Final") and status. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Matches
- destructiveHint: false
get_playerUse for a player profile: date of birth, country, height, playing hand; latest ranking; our rating overall and per surface with peak; career record (wins, losses, sets, games, tieb…No findings
Why it is in this group
- The name "get_player" says "get": a word for reading.
Description, as the server wrote it Use for a player profile: date of birth, country, height, playing hand; latest ranking; our rating overall and per surface with peak; career record (wins, losses, sets, games, tiebreaks, deciding sets), titles, finals and Grand Slam titles; record by surface; and the last 10 matches. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 5 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Player
- destructiveHint: false
get_player_matchesUse for a player's matches, newest first: tournament, surface, round, opponent, result, score by set and the player's rating before and after.No findings
Why it is in this group
- The name "get_player_matches" says "get": a word for reading.
Description, as the server wrote it Use for a player's matches, newest first: tournament, surface, round, opponent, result, score by set and the player's rating before and after. Filter by season, surface, opponent_id, tournament_id or draw. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 5 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Player matches
- destructiveHint: false
get_player_statsUse for a player's match statistics by season: wins, losses, sets and games won, tiebreaks won and lost, deciding sets, 6-0 sets and retirements, all counted from scores; plus the …No findings
Why it is in this group
- The name "get_player_stats" says "get": a word for reading.
Description, as the server wrote it Use for a player's match statistics by season: wins, losses, sets and games won, tiebreaks won and lost, deciding sets, 6-0 sets and retirements, all counted from scores; plus the record by round and by the opponent's ranking (top 10, 11-50, 51-100). No serve statistics: they are not available. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Player stats
- destructiveHint: false
get_rankingsUse for the ranking list: the latest (default), or a season and week, or the list in force on a date, with rank, previous rank, points and player.No findings
Why it is in this group
- The name "get_rankings" says "get": a word for reading.
Description, as the server wrote it Use for the ranking list: the latest (default), or a season and week, or the list in force on a date, with rank, previous rank, points and player. Pass player_id instead for one player's ranking history. Weekly lists hold the top 100 to 150 for most weeks since 2007. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Rankings
- destructiveHint: false
get_ratingsUse for our Elo ratings, highest first: overall, or on one surface (hard, clay, grass).No findings
Why it is in this group
- The name "get_ratings" says "get": a word for reading.
Description, as the server wrote it Use for our Elo ratings, highest first: overall, or on one surface (hard, clay, grass). Players with a rated match since active_since (default a year ago) and at least 10 rated matches. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Ratings
- destructiveHint: false
get_scheduleUse for upcoming matches: every scheduled or in-progress singles match in the next N days (default 7, max 30) with players, seeds, round and start time where one is set.No findings
Why it is in this group
- The name "get_schedule" says "get": a word for reading.
Description, as the server wrote it Use for upcoming matches: every scheduled or in-progress singles match in the next N days (default 7, max 30) with players, seeds, round and start time where one is set. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Schedule
- destructiveHint: false
get_surface_splitsUse for a player's record by surface (hard, clay, grass, carpet): wins, losses, win rate, sets, share of games won, tiebreaks, deciding sets and 6-0 sets, plus the current surface …No findings
Why it is in this group
- The name "get_surface_splits" says "get": a word for reading.
Description, as the server wrote it Use for a player's record by surface (hard, clay, grass, carpet): wins, losses, win rate, sets, share of games won, tiebreaks, deciding sets and 6-0 sets, plus the current surface ratings. For one season or the whole career; by_season splits each surface by year. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Surface splits
- destructiveHint: false
get_tournamentUse for a tournament's draw and results: every singles match of one edition grouped by round in draw order (qualifying, then the main draw to the final), each with the score by set…No findings
Why it is in this group
- The name "get_tournament" says "get": a word for reading.
Description, as the server wrote it Use for a tournament's draw and results: every singles match of one edition grouped by round in draw order (qualifying, then the main draw to the final), each with the score by set and tiebreak points, seeds, and the champion and runner-up. draw: main (default), qualifying or all. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Tournament
- destructiveHint: false
list_tournamentsUse to find tournaments.No findings
Why it is in this group
- The name "list_tournaments" says "list": a word for reading.
Description, as the server wrote it Use to find tournaments. Lists a season's tournaments in calendar order with dates, city, surface, whether it is a Grand Slam, status, main-draw match count and the champion. Filter by surface (hard, clay, grass, carpet) and status. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 1 credit.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: List tournaments
- destructiveHint: false
search_playersUse to find a player's id.No findings
Why it is in this group
- The name "search_players" says "search": a word for reading.
Description, as the server wrote it Use to find a player's id. Search by name (accents optional) and/or country code (e.g. ITA); most-played first, with matches, last match and rank on the current list (null outside the top 100 to 150 listed). Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 1 credit.
Annotations the server declares
- readOnlyHint: true
- openWorldHint: false
- title: Search players
- destructiveHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.1.6. Values in angle brackets are yours to fill in.
claude mcp add --transport http acesapi https://mcp.acesapi.com/mcp --header 'x-api-key: <your-x-api-key>'Run in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__acesapi__list_tournaments",
"mcp__acesapi__get_tournament",
"mcp__acesapi__get_matches",
"mcp__acesapi__get_schedule",
"mcp__acesapi__get_match",
"mcp__acesapi__search_players",
"mcp__acesapi__get_player",
"mcp__acesapi__get_player_matches",
"mcp__acesapi__get_head_to_head",
"mcp__acesapi__get_surface_splits",
"mcp__acesapi__get_player_stats",
"mcp__acesapi__get_rankings",
"mcp__acesapi__get_ratings"
],
"ask": [],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as acesapi. Review it before you use it.
