io.github.noahowsh由 GitHub 帳號 noahowsh 發布v1.1.6更新於 Oct 24, 2026
ATP and WTA tennis since 2007: sets, draws, rankings, head to head, surface Elo, sportsbook lines.
託管式網球資料 MCP 伺服器，讓助理查詢 2007 年以來的 ATP 與 WTA 單打賽果、籤表、排名、對戰紀錄、場地 Elo 及博彩賠率。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.noahowsh%2Facesapi/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"acesapi": {
"type": "http",
"url": "https://mcp.acesapi.com/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}The tennis data API. ATP and WTA singles matches with every set and tiebreak score, tournament draws round by round, player profiles, weekly rankings, head to head, surface splits, our own Elo by surface, and sportsbook moneylines on Grand Slam and Masters / WTA 1000 matches. REST API and MCP server. 500 free credits every month, no card.
Website: https://acesapi.com · Docs: https://acesapi.com/docs · Get a key: https://acesapi.com/signup
Most clients connect to https://mcp.acesapi.com/mcp directly. For a client that launches a local process instead:
It forwards to the hosted server with your key, so every tool and credit cost is the same.
This repo also ships 16 free Claude skills in skills/ that turn Claude into a tennis analyst on top of the tools below: match and player lookup, surface Elo, head to head, ranking history, set-score modeling, odds math, edge detection and backtesting. They call the AcesAPI tools and keep to what the data holds (no serve statistics, moneylines on Slams, Masters and WTA 1000 only).
Or install them as a Claude Code plugin:
Or with the skills CLI: npx skills add noahowsh/acesapi-mcp.
Point Claude at the skills/ folder, add the MCP server (see Quick start), and ask a question such as "who is favored in tomorrow's Shanghai match and why?". Full catalog: skills/README.md. The skills also work on your own CSV or JSON without a key.
The official Python client is on PyPI: acesapi.
Typed errors for a bad key, no credits left, not found and rate limits, automatic retries, and to_dataframe for pandas.
This is a hosted (remote) MCP server over Streamable HTTP. There is nothing to install.
Claude Code
Claude Desktop, Cursor and other clients
The key can also be sent as an x-api-key header or Authorization: Bearer. Connecting and listing tools works without a key; calling a tool needs one.
REST
Every tool is POST /v1/{tool} with a JSON body.
Runnable Python (standard library only) and Node 18+ (no dependencies) examples live in examples/:
examples/python/quickstart.py and examples/node/quickstart.mjs: schedule plus a headline call.examples/python/tennis_head_to_head_surface_elo.py: Two players side by side.See examples/README.md for details. Get a free key (500 credits a month, no card) at https://acesapi.com/signup.
Leagues: tennis (default, ATP), wta (pass league: "wta" to any tool).
odds array of get_match (there is no separate odds tool): Grand Slam matches from mid-2020 and ATP Masters and WTA 1000 matches from August 2024, pre-match, refreshed hourly; the array is empty for other tournamentsCoverage by season, read live from the database: https://acesapi.com/docs
500 free credits every month, no card. Plans: Starter $19/mo (10,000 credits), Pro $49/mo (30,000), Scale $149/mo (125,000). Wallet top-ups from $5, never expire. https://acesapi.com/pricing
Surfaces and ratings are ours. Not affiliated with the ATP, WTA, ITF or any tournament.
MIT for the contents of this repository. Data terms as above.
Add this repo as a Codex plugin marketplace, then install the plugin:
Then open the plugin directory in Codex and install acesapi-skills from the acesapi marketplace. The plugin bundles the skills in skills/ and the AcesAPI MCP server (https://mcp.acesapi.com/mcp). Set your key first (free at https://acesapi.com/signup):
Codex sends it as a bearer token.
The extension adds the AcesAPI MCP server (https://mcp.acesapi.com/mcp) and sends the key in the x-api-key header. Get a free key (500 credits a month) at https://acesapi.com/signup.
來源：README.md，提交 c464e4a
List tournaments
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.
limitleagueoffsetseasonstatussurfaceTournament
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.
drawleaguetournament_id必填Matches
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.
datelimitroundleagueoffsetseasonstatustournament_idSchedule
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.
daysleagueMatch
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.
leaguematch_id必填Search players
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.
namelimitleaguecountryPlayer
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.
leagueplayer_id必填Player matches
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.
drawlimitleagueoffsetseasonsurfaceplayer_id必填opponent_idtournament_idHead to head
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.
leagueplayer_id必填opponent_id必填Surface splits
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.
leagueseasonby_seasonplayer_id必填Player stats
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.
leagueseasonplayer_id必填Rankings
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.
dateweeklimitleagueseasonplayer_idRatings
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.
limitleaguesurfaceactive_since已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
You: "What is Carlos Alcaraz's record on clay against top-10 players?"Claude: [calls get_surface_splits]
You: "Who leads the Sinner and Alcaraz head to head, and how many of their meetings were finals?"Claude: [calls get_head_to_head]
You: "Which moneylines were posted for the 2025 US Open men's final?"Claude: [calls get_matches, then get_match]git clone https://github.com/noahowsh/acesapi-mcp.git && cd acesapi-mcp && npm installACESAPI_API_KEY=your_key node index.js{ "mcpServers": { "acesapi": { "command": "node", "args": ["/path/to/acesapi-mcp/index.js"], "env": { "ACESAPI_API_KEY": "your_key" } } } }git clone https://github.com/noahowsh/acesapi-mcp.git/plugin marketplace add noahowsh/acesapi-mcp/plugin install acesapi-skills@acesapipip install acesapiexport ACESAPI_API_KEY=sk_live_...from acesapi import Client
client = Client()
ranks = client.get_rankings(limit=5)for row in ranks["rankings"]: print(row["rank"], row["name"], row["points"])claude mcp add --transport http acesapi "https://mcp.acesapi.com/mcp?key=YOUR_API_KEY"{ "mcpServers": { "acesapi": { "url": "https://mcp.acesapi.com/mcp?key=YOUR_API_KEY" } }}curl -X POST https://mcp.acesapi.com/v1/list_tournaments -H "x-api-key: YOUR_API_KEY"export ACESAPI_API_KEY=your_keypython3 examples/python/quickstart.pynode examples/node/quickstart.mjscodex plugin marketplace add noahowsh/acesapi-mcpexport ACESAPI_API_KEY=your_keyexport ACESAPI_API_KEY=your_keygemini extensions install https://github.com/noahowsh/acesapi-mcp