search_players
1 creditStatic referencePOST /v1/search_players
Find players by name
Use it when you have a name, or part of one, and need the player id for the other endpoints.
Parameters
namestringrequired- Full or partial name.
limitintegeroptionalleagueenum: mlb | ncaabaseoptional- League. Defaults to mlb. One of: mlb, ncaabase.
Notes
- Over MCP, ask for it in plain English and the client calls
search_playersitself. Point any MCP client athttps://mcp.fastballapi.com/mcp?key=YOUR_API_KEY. - Each call costs 1 credit, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.fastballapi.com/v1/search_players \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"name": "harper",
"limit": 3
}'Response
json
{
"players": [
{
"player_id": "30951",
"name": "Bryce Harper",
"position": "1B",
"bats": "L",
"team_id": "22",
"team": "PHI"
},
{
"player_id": "33333",
"name": "Ryne Harper",
"position": "RP",
"bats": "R",
"team_id": "20",
"team": "WSH"
}
],
"count": 2
}Response fields
players[]array- List of objects
players[].player_idstringplayers[].namestringplayers[].positionstringplayers[].batsstringplayers[].team_idstringplayers[].teamstringcountnumber
Used in
- MLB player props by sportsbook, from 2023: MLB player prop lines by sportsbook since May 2023: the closing line, and the opening line where held, with each player's history against his line. REST or MCP.
Related endpoints
get_player5 cr
Takes the player_id this one returns.
Season batting (AVG, OBP, SLG, OPS, RE24) and pitching (ERA, WHIP, K/9)
get_player_games5 cr
Takes the player_id this one returns.
A player's full batting and pitching game log
list_teams1 cr
Filters by the same league.
Team ids, abbreviations and colours for a season
get_games2 cr
Filters by the same limit and league.
Games with runs, hits and errors by season, date, range or team
Try it
500 free credits every month: 500 calls to search_players, and no card.