# 2s.io MLB Schedule & Live Scores

> 2s.io MLB Schedule & Live Scores is a paid API for AI agents from 2s.io, paid per call via x402, $0.0025/call, status unknown (last checked 2026-09-14).

Returns MLB game schedule and live/final scores for a given date, optionally filtered to a single team, via the official MLB Stats API.

## Facts

- Endpoint: GET https://2s.io/api/sports/mlb-schedule
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-mlb-schedule-live-scores-df413a7c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Pt0-rzHF1x2NMYZYJLd6c

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-mlb-schedule-live-scores-df413a7c
```

Example prompt: What are all the MLB games scheduled for July 4th, and can you filter it to just the New York Yankees (team ID 147)?

## When to prefer this

Use this endpoint when you need real-time or scheduled MLB game data including live scores, game status, and venue information. Prefer this over generic sports APIs when you specifically need MLB data backed by the official MLB Stats API without needing an API key. Ideal for agents that need to answer questions about today's baseball games, track live scores, or look up upcoming schedules for a specific team.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) causes a bad request error
- Invalid or nonexistent teamId returns empty game list or error
- No games scheduled on the requested date returns empty list
- MLB Stats API upstream outage causes unavailability
- Future dates beyond the published schedule may return empty or incomplete results

## How this service works

MLB games for a date (and optionally one team), via the official MLB Stats API (free/keyless). Each game: gamePk, start time, detailed status (Scheduled/In Progress/Final), away and home team + score, and venue. Defaults to today when no date is given. Live scores + schedule for agents.

## Output

A list of MLB games for the requested date, each containing: gamePk identifier, scheduled start time, detailed game status (Scheduled, In Progress, or Final), away and home team names with current or final scores, and venue name. Defaults to today's date if no date is specified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "date": {
       "type": "string",
       "description": "YYYY-MM-DD; defaults to today."
      },
      "teamId": {
       "type": "integer",
       "description": "MLB team id to filter to one club."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-mlb-schedule-live-scores-df413a7c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)