Skip to content

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.
limitintegeroptional
leagueenum: mlb | ncaabaseoptional
League. Defaults to mlb. One of: mlb, ncaabase.

Notes

  • Over MCP, ask for it in plain English and the client calls search_players itself. Point any MCP client at https://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_idstring
players[].namestring
players[].positionstring
players[].batsstring
players[].team_idstring
players[].teamstring
countnumber

Used in

Related endpoints

Try it

500 free credits every month: 500 calls to search_players, and no card.