MCP tool reference · #541 of 563 by publishers
search_players
Exposed by 13 servers from 8 publishers, read from the live servers by the Serverdex check; most of them sit in Games & Sports; 92.3% of them take a limit parameter; the most-starred is Livetennisapi MCP (126 stars).
search_players(limit?: integer, league?: string, name: string, query: string, …)Parameters
share = % of the 13 servers whose schema has it · required = % of those that mark it required| Parameter | Type | Share | Required | Usual description |
|---|---|---|---|---|
| limit | integer | 92.3% | 0% | Max players (default 20). |
| league | string | 53.8% | 0% | League. Defaults to golf. One of: golf, lpga, liv, dpwt, kornferry. |
| name | string | 46.2% | 66.7% | Full or partial name. |
| query | string | 46.2% | 100% | Full or partial player name, e.g. "alcaraz". |
| active | boolean | 23.1% | 0% | Default true, but an active-only search that finds nobody automatically falls back to all players and says so. Set false to search everyone outright. |
| position | string | 23.1% | 0% | Filter by position |
| team | string | 23.1% | 0% | Club id, abbreviation or name. |
| country | string | 15.4% | 0% | ISO 3166-1 alpha-3 country code, e.g. USA. |
| after_id | integer | 7.7% | 0% | Cursor: last player id from the previous page's next_after_id. |
| max_height_cm | — | 7.7% | 0% | — |
| min_height_cm | — | 7.7% | 0% | — |
| q | string | 7.7% | 0% | Name search (partial match). |
Source: the input schema each server returns for search_players, aggregated over the 13 index-tier servers; type and description are the values most servers use. Rebuilt every 6 hours.
Servers with search_players
10 of 13 · 8 publishers · 10 answering live · most-starred first, 3 per publisher| # | Server | Publisher | Category | ★ | Live | How it describes search_players |
|---|---|---|---|---|---|---|
| 1 | Livetennisapi MCPlivetennisapi · Games & Sports | livetennisapi | Games & Sports | 126 | yes | Search 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). |
| 2 | Lumify Sports Intelligencelumifyai · Games & Sports | lumifyai | Games & Sports | 15 | yes | Search players by name, sport, country, ranking, or active status, paginated by id (after_id). Returns the same identity object on every sport (null means unknown, not wrong sport). Tennis standings nest under rankings.{singles, points}; rankings is null on every other sport. Use get_player for full detail on one id, or get_player_events for a player's schedule/results. |
| 3 | stat-api — Sports Datastat-api · Games & Sports | stat-api | Games & Sports | 2 | yes | Fuzzy player-name search (typo-tolerant). Currently NBA only — for other leagues query the players table with a name filter via query_table. Returns player rows ordered by match quality. Requires a stat-api sign-in or API key; rows count against quota. |
| 4 | AcesAPInoahowsh · Games & Sports | noahowsh | Games & Sports | 1 | yes | 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. |
| 5 | DraftCallevanatpizzarobot · Games & Sports | evanatpizzarobot | Games & Sports | 1 | yes | Find players by partial name, team abbreviation, or position. Use this when a name is ambiguous or only partly known before calling the other tools. |
| 6 | NBA Prop Labkhavel · Health & Science | khavel | Health & Science | — | yes | Find NBA and WNBA players by name; returns their ids for player_research. |
| 7 | BirdieAPInoahowsh · Games & Sports | noahowsh | Games & Sports | — | yes | Use to find a player's id by name (accents optional). Returns country, tournaments played, wins and the seasons played. Costs 1 credit. |
| 8 | StrikerAPInoahowsh · Games & Sports | noahowsh | Games & Sports | — | yes | Use to find a player's id by name (accents optional), optionally within a club. Returns position, current club, last season and appearances. Costs 1 credit. |
| 9 | PuckAPIpuckapi · Games & Sports | puckapi | Games & Sports | — | yes | Use when looking up a player by name. Searches 4,900+ players across every season since 2010-11. Returns active players by default; set active=false for retired/historical. Use the returned player ID with get_player_stats for full details. Costs 2 credits. |
| 10 | Vosters Rostersandrewvg23 · Games & Sports | andrewvg23 | Games & Sports | — | yes | Search players by name, position, height, or team. |
Stars from GitHub as stored in the Serverdex index (re-read every 7 days per server); live = answered the last daily check of its hosted endpoint. The other 3 servers are reached from their publisher pages.