AcesAPI
ATP and WTA tennis since 2007: sets, draws, rankings, head to head, surface Elo, sportsbook lines.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"acesapi": {
"url": "https://mcp.acesapi.com/mcp"
}
}
}遠端端點
https://mcp.acesapi.com/mcpstreamable-http它能做什麼
工具清單
工具（13）
🟢list_tournaments(season, surface, status, limit, offset, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"season": {
"description": "Year, e.g. 2025 (default this year).",
"type": [
"string",
"number"
]
},
"surface": {
"description": "Only tournaments on this surface.",
"type": "string",
"enum": [
"hard",
"clay",
"grass",
"carpet"
]
},
"status": {
"description": "Only upcoming, in-progress or completed tournaments.",
"type": "string",
"enum": [
"scheduled",
"live",
"final"
]
},
"limit": {
"description": "Max tournaments (default 100).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Page offset; use next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"season": {
"type": "number"
},
"tournaments": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"tour",
"season",
"tournaments",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_tournament(tournament_id, draw, league)
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.
輸入結構描述
{
"type": "object",
"properties": {
"tournament_id": {
"type": "string",
"description": "Tournament edition id from list_tournaments, e.g. \"188-2025\"."
},
"draw": {
"description": "Which draw (default main).",
"type": "string",
"enum": [
"main",
"qualifying",
"all"
]
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"required": [
"tournament_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"tournament": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"champion": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"runner_up": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"rounds": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"tour",
"tournament",
"champion",
"runner_up",
"rounds",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_matches(date, tournament_id, season, round, status, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "UTC date, YYYY-MM-DD.",
"type": "string"
},
"tournament_id": {
"description": "Tournament edition id, e.g. \"188-2025\".",
"type": "string"
},
"season": {
"description": "Year.",
"type": [
"string",
"number"
]
},
"round": {
"description": "Round name as listed, e.g. \"Final\", \"Semifinal\", \"Round 1\".",
"type": "string"
},
"status": {
"type": "string",
"enum": [
"scheduled",
"live",
"final"
]
},
"limit": {
"description": "Max matches (default 100).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"tour",
"matches",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_schedule(days, league)
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 ESPN has set one. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"days": {
"description": "Days ahead (default 7).",
"type": "integer",
"minimum": 1,
"maximum": 30
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"days": {
"type": "number"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"tour",
"days",
"matches",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_match(match_id, league)
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), and what the score says (total games, tiebreaks, whether it went the distance, comebacks). No serve statistics: ESPN does not publish them. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"match_id": {
"type": "string",
"description": "Match id from get_tournament, get_matches or get_player_matches."
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"required": [
"match_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"match": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"players": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"stats": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"odds": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"tour",
"match",
"players",
"stats",
"odds"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_players(name, country, limit, league)
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 ESPN's top 100 to 150). Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"description": "Part of the player's name, e.g. \"sinner\".",
"type": "string"
},
"country": {
"description": "Three-letter country code, e.g. ESP.",
"type": "string"
},
"limit": {
"description": "Max players (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"players": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"tour",
"players",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_player(player_id, league)
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.
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "Player id from search_players."
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"required": [
"player_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"player": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"ranking": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"rating": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"record": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"by_surface": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"recent_matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"tour",
"player",
"ranking",
"rating",
"record",
"by_surface",
"recent_matches"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_player_matches(player_id, season, surface, opponent_id, tournament_id, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "Player id from search_players."
},
"season": {
"description": "Year.",
"type": [
"string",
"number"
]
},
"surface": {
"type": "string",
"enum": [
"hard",
"clay",
"grass",
"carpet"
]
},
"opponent_id": {
"description": "Only matches against this player.",
"type": "string"
},
"tournament_id": {
"description": "Only this tournament edition, e.g. \"188-2025\".",
"type": "string"
},
"draw": {
"type": "string",
"enum": [
"main",
"qualifying"
]
},
"limit": {
"description": "Max matches (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"required": [
"player_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"player_id": {
"type": "string"
},
"name": {
"type": "string"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"required": [
"tour",
"player_id",
"name",
"matches",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_head_to_head(player_id, opponent_id, league)
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.
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "First player id."
},
"opponent_id": {
"type": "string",
"description": "Second player id."
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"required": [
"player_id",
"opponent_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"players": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"summary": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"matches": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"tour",
"players",
"summary",
"matches"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_surface_splits(player_id, season, by_season, league)
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.
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "Player id from search_players."
},
"season": {
"description": "Year (default the whole career).",
"type": [
"string",
"number"
]
},
"by_season": {
"description": "Split each surface by season.",
"type": "boolean"
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"required": [
"player_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"player_id": {
"type": "string"
},
"name": {
"type": "string"
},
"season": {
"type": [
"number",
"null"
]
},
"overall": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"splits": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"ratings": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"required": [
"tour",
"player_id",
"name",
"season",
"overall",
"splits",
"ratings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_player_stats(player_id, season, league)
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: ESPN does not publish them. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 3 credits.
輸入結構描述
{
"type": "object",
"properties": {
"player_id": {
"type": "string",
"description": "Player id from search_players."
},
"season": {
"description": "Year (default every season).",
"type": [
"string",
"number"
]
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"required": [
"player_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"player_id": {
"type": "string"
},
"name": {
"type": "string"
},
"season": {
"type": [
"number",
"null"
]
},
"by_season": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"by_round": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"by_opponent_rank": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"note": {
"type": "string"
}
},
"required": [
"tour",
"player_id",
"name",
"season",
"by_season",
"by_round",
"by_opponent_rank",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_rankings(season, week, date, player_id, limit, ...)
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. ESPN keeps 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.
輸入結構描述
{
"type": "object",
"properties": {
"season": {
"description": "Year.",
"type": [
"string",
"number"
]
},
"week": {
"description": "Week number of the season.",
"type": "integer",
"minimum": 1,
"maximum": 53
},
"date": {
"description": "The list in force on this date, YYYY-MM-DD.",
"type": "string"
},
"player_id": {
"description": "One player's ranking history instead of a list.",
"type": "string"
},
"limit": {
"description": "Max rows of a list (default 100).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"season": {
"type": "number"
},
"week": {
"type": "number"
},
"ranking_date": {
"type": [
"string",
"null"
]
},
"rankings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"player_id": {
"type": "string"
},
"name": {
"type": "string"
},
"best_rank": {
"type": [
"number",
"null"
]
},
"history": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"required": [
"tour",
"count"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_ratings(surface, active_since, limit, league)
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.
輸入結構描述
{
"type": "object",
"properties": {
"surface": {
"description": "Rank by the surface rating instead of overall.",
"type": "string",
"enum": [
"hard",
"clay",
"grass",
"carpet"
]
},
"active_since": {
"description": "Only players with a rated match since this date, YYYY-MM-DD (default one year ago).",
"type": "string"
},
"limit": {
"description": "Max players (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"league": {
"description": "League. Defaults to tennis. One of: tennis, wta.",
"type": "string",
"enum": [
"tennis",
"wta"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tour": {
"type": "string"
},
"surface": {
"type": [
"string",
"null"
]
},
"active_since": {
"type": "string"
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"method": {
"type": "string"
}
},
"required": [
"tour",
"surface",
"active_since",
"ratings",
"count",
"method"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}社群
證據