get_matchup

Pack: mlb-stats · Endpoint: https://gateway.pipeworx.io/mlb-stats/mcp

MLB BATTER-vs-PITCHER history from the official MLB Stats API — “how has Yordan Alvarez hit against Tanner Bibee”, ” career numbers vs ”. Accepts batter and pitcher NAMES (resolved automatically) or numeric ids. Returns the batter’s hitting line against that specific pitcher (at-bats, hits, HR, RBI, AVG, OPS, strikeouts), split by season with career totals.

Parameters

NameTypeRequiredDescription
batterstringyesBatter NAME (e.g. “Yordan Alvarez”) or numeric MLB person id.
pitcherstringyesPitcher NAME (e.g. “Tanner Bibee”) or numeric MLB person id.
seasonnumber,stringnoOptional season year to limit to; omit for full career.

Example call

curl -X POST https://gateway.pipeworx.io/mlb-stats/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_matchup","arguments":{}}}'

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "mlb-stats": {
      "url": "https://gateway.pipeworx.io/mlb-stats/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build July 2, 2026