# MLB API: Get standings

> Returns MLB regular-season division standings for a season: records, win percentage, games back, streak, last 10 games and wild-card games back. Defaults to the current year.

Unofficial. Not affiliated with or endorsed by MLB.

- Page: https://fous.com/methods/mlb.com/get-standings
- Method: `mlb.com/get_standings`, version 1
- Website: mlb.com
- Returns: league, division, rank, team, wins, losses, win percentage, games back, streak, last 10, wild-card games back, team page
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `season` | integer | no |  | MLB season year, for example 2025. Defaults to the current year. |

## Output

From a run on Oct 27, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "teams": [
    {
      "rank": 1,
      "team": "Tampa Bay Rays",
      "wins": 98,
      "league": "American League",
      "losses": 64,
      "streak": "Lost 1",
      "last_10": "5-5",
      "division": "AL East",
      "page_url": "https://www.mlb.com/rays",
      "games_back": "-",
      "win_percentage": 0.605,
      "wild_card_games_back": "-"
    },
    {
      "rank": 2,
      "team": "New York Yankees",
      "wins": 93,
      "league": "American League",
      "losses": 68,
      "streak": "Won 1",
      "last_10": "5-5",
      "division": "AL East",
      "page_url": "https://www.mlb.com/yankees",
      "games_back": "4.5",
      "win_percentage": 0.578,
      "wild_card_games_back": "+9.5"
    },
    {
      "rank": 3,
      "team": "Boston Red Sox",
      "wins": 87,
      "league": "American League",
      "losses": 75,
      "streak": "Lost 1",
      "last_10": "5-5",
      "division": "AL East",
      "page_url": "https://www.mlb.com/redsox",
      "games_back": "11.0",
      "win_percentage": 0.537,
      "wild_card_games_back": "+3.0"
    }
  ],
  "season": 2026
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"mlb.com/get_standings","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the current MLB division standings with win-loss records and games back?
- Show me the 2024 MLB standings for the American League East including streaks and last 10 results.
- Which teams lead their divisions right now, and how many wild-card games back is each team?
- Can you pull up the 1998 MLB standings by division with win percentages?
- On mlb.com, what do the 2019 National League Central standings look like, including each team's last 10 games?

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "season": {
      "type": "integer",
      "minimum": 1876,
      "description": "MLB season year, for example 2025. Defaults to the current year."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "season",
    "teams"
  ],
  "properties": {
    "teams": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "league",
          "division",
          "rank",
          "team",
          "wins",
          "losses",
          "win_percentage",
          "page_url"
        ],
        "properties": {
          "rank": {
            "type": "integer"
          },
          "team": {
            "type": "string"
          },
          "wins": {
            "type": "integer"
          },
          "league": {
            "type": "string"
          },
          "losses": {
            "type": "integer"
          },
          "streak": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_10": {
            "type": [
              "string",
              "null"
            ]
          },
          "division": {
            "type": "string"
          },
          "page_url": {
            "type": "string"
          },
          "games_back": {
            "type": [
              "string",
              "null"
            ]
          },
          "win_percentage": {
            "type": "number"
          },
          "wild_card_games_back": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "description": "Teams ordered by league, division and division rank."
    },
    "season": {
      "type": "integer",
      "description": "Standings season year."
    }
  },
  "additionalProperties": false
}
```

## See more

- [MLB API: Get scores and schedule](https://fous.com/methods/mlb.com/get-scores.md): Lists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone.
- [MLB API: Get player stats](https://fous.com/methods/mlb.com/get-player-stats.md): Gets an MLB player's profile and regular-season hitting and pitching statistics for one season and for his career. Without a season it uses the current season, or the player's latest MLB season if he has no stats this year.
- [NFL API: Get standings](https://fous.com/methods/nfl.com/get-standings.md): Gets NFL regular-season standings by conference and division for a season, with clinch status when shown.
- [Yahoo API: Get team standings](https://fous.com/methods/sports.yahoo.com/get-standings.md): Returns Yahoo Sports team standings for a league and season, grouped by division or conference.
- [NBA API: Get standings](https://fous.com/methods/nba.com/get-standings.md): Returns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page.
- [NHL API: Get standings](https://fous.com/methods/nhl.com/get-standings.md): Gets NHL standings as of a date, ordered by conference, division and division rank, with each team's official homepage.
- [Formula 1 API: Get championship standings](https://fous.com/methods/formula1.com/get-standings.md): Gets Formula 1 drivers' and teams' championship standings for a season, with the last completed race. Teams' standings begin in 1958.
- [Premier League API: Get league table](https://fous.com/methods/premierleague.com/get-league-table.md): Gets the Premier League table for the current season or a chosen season, with each club's last five league results.
- [All MLB methods](https://fous.com/methods/mlb.com.md)
