API & MCP Documentation

Programmatic access to SNL episode data

REST API

All pages support JSON responses by setting the Accept: application/json header.

Check Current Status

# Check if there's an episode tonight

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/

View response example

{
  "answer": "YES",
  "episode": {
    "date": "2025-10-18",
    "host": "Sabrina Carpenter",
    "musicalGuest": "Sabrina Carpenter"
  }
}

Get All Seasons

# List all seasons

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/seasons

View response example

{
  "seasons": [
    {
      "seasonNumber": 48,
      "episodeCount": 11,
      "firstEpisode": "2022-10-01",
      "lastEpisode": "2023-04-15"
    },
    ...
    {
      "seasonNumber": 51,
      "episodeCount": 6,
      "firstEpisode": "2025-10-04",
      "lastEpisode": "2025-11-15"
    }
  ]
}

Get Season Details

# Get episodes for a specific season

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/seasons/51

View response example

{
  "season": 51,
  "episodes": [
    {
      "episodeNumber": 1,
      "date": "2025-10-04",
      "host": "Bad Bunny",
      "musicalGuest": "Doja Cat"
    },
    ...
    {
      "episodeNumber": 6,
      "date": "2025-11-15",
      "host": "Glen Powell",
      "musicalGuest": "Olivia Dean"
    }
  ],
  "pagination": {
    "prev": 50,
    "next": null
  }
}

Get Episode Details

# Get specific episode

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/seasons/51/episodes/3

View response example

{
  "season": 51,
  "episodeNumber": 3,
  "date": "2025-10-18",
  "host": {
    "name": "Sabrina Carpenter",
    "slug": "sabrina-carpenter",
    "otherEpisodes": [
      {
        "season": 49,
        "episode": 20,
        "date": "2024-05-18",
        "role": "musicalGuest"
      }
    ]
  },
  "musicalGuest": {
    "name": "Sabrina Carpenter",
    "slug": "sabrina-carpenter",
    "otherEpisodes": [
      {
        "season": 49,
        "episode": 20,
        "date": "2024-05-18",
        "role": "musicalGuest"
      }
    ]
  },
  "pagination": {
    "first": 1,
    "prev": 2,
    "next": 4,
    "last": 6
  }
}

Get All Hosts

# List all hosts

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/hosts

View response example

{
  "hosts": [
    {
      "name": "Amy Poehler",
      "slug": "amy-poehler",
      "episodeCount": 1
    },
    ...
    {
      "name": "Timothee Chalamet",
      "slug": "timothee-chalamet",
      "episodeCount": 1
    }
  ]
}

Get Host Details

# Get specific host with episode history

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/hosts/sabrina-carpenter

View response example

{
  "name": "Sabrina Carpenter",
  "slug": "sabrina-carpenter",
  "hostedEpisodes": [
    {
      "season": 51,
      "episodeNumber": 3,
      "date": "2025-10-18",
      "musicalGuest": "Sabrina Carpenter"
    }
  ],
  "musicalGuestEpisodes": [
    {
      "season": 49,
      "episodeNumber": 20,
      "date": "2024-12-14",
      "host": "Martin Short"
    },
    ...
    {
      "season": 50,
      "episodeNumber": 14,
      "date": "2025-03-15",
      "host": "Sydney Sweeney"
    }
  ]
}

Get All Musical Guests

# List all musical guests

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/musical-guests

View response example

{
  "musicalGuests": [
    {
      "name": "Bad Bunny",
      "slug": "bad-bunny",
      "episodeCount": 2
    },
    ...
    {
      "name": "Yeah Yeah Yeahs",
      "slug": "yeah-yeah-yeahs",
      "episodeCount": 1
    }
  ]
}

Get Musical Guest Details

# Get specific musical guest with performance history

curl -H "Accept: application/json" https://isthereasnlepisodetonight.com/musical-guests/billie-eilish

View response example

{
  "name": "Billie Eilish",
  "slug": "billie-eilish",
  "musicalGuestEpisodes": [
    {
      "season": 50,
      "episodeNumber": 8,
      "date": "2024-12-14",
      "host": "Martin Short"
    },
    ...
    {
      "season": 50,
      "episodeNumber": 14,
      "date": "2025-03-15",
      "host": "Sydney Sweeney"
    }
  ],
  "hostedEpisodes": []
}

Model Context Protocol (MCP)

Integrate SNL episode data directly into AI tools like Claude Desktop, VS Code, and Cursor using the Model Context Protocol.

MCP Server Endpoint

https://isthereasnlepisodetonight.com/api/mcp

Available Tools

check_snl_tonight

Check if there's a new SNL episode airing tonight, including host and musical guest information.

list_upcoming_episodes

Get a list of upcoming SNL episodes with dates, hosts, and musical guests.

Setup Instructions

Claude Desktop

Open Claude Desktop settings
Navigate to Developer → Edit Config
Add the following configuration:

{
  "mcpServers": {
    "snl-checker": {
      "url": "https://isthereasnlepisodetonight.com/api/mcp"
    }
  }
}

Restart Claude Desktop to activate the integration.

VS Code

Install the "GitHub Copilot Chat" extension
Open VS Code settings (Cmd+, or Ctrl+,)
Enable: Chat → Mcp → Discovery and Chat → Mcp
Edit settings.json and add:

{
  "mcp": {
    "servers": {
      "snl-checker": {
        "url": "https://isthereasnlepisodetonight.com/api/mcp"
      }
    }
  }
}

Cursor

Open Cursor settings
Navigate to MCP or Tools & Integrations
Click "Add new global MCP server"
Update mcp.json with:

{
  "mcpServers": {
    "snl-checker": {
      "url": "https://isthereasnlepisodetonight.com/api/mcp"
    }
  }
}