MCP Server

Friend of the Show exposes a Model Context Protocol (MCP) server so AI assistants can search comedians, shows, episodes, and live dates. No authentication required.

Endpoint

POST https://friendoftheshow.live/api/mcp

Stateless Streamable HTTP transport. Each request is independent — no sessions, no auth tokens.

Available Tools

Tool	Description	Parameters
search_comedians	Search comedian profiles by name, with optional classification filter.	query, classification?, limit?
search_shows	Search podcast and TV shows by name, with optional type filter.	query, showType?, limit?
search_episodes	Search episodes by keyword in title or description, with optional show filter.	query, showSlug?, limit?
search_live_dates	Search upcoming live comedy dates by comedian, city, country, or date range.	comedianName?, city?, country?, from?, to?, limit?
lookup_comedian	Get full comedian profile including show appearances and upcoming live dates.	slug
lookup_show	Get full show details including hosts and recent episodes.	slug

Connect from Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "friend-of-the-show": {
      "type": "streamablehttp",
      "url": "https://friendoftheshow.live/api/mcp"
    }
  }
}

Connect from Claude Code

Add this to your .mcp.json:

{
  "mcpServers": {
    "friend-of-the-show": {
      "type": "streamablehttp",
      "url": "https://friendoftheshow.live/api/mcp"
    }
  }
}

Markdown Pages

Every public page on this site has a markdown version, ideal for AI agents and LLM consumption. Access it in two ways:

Append .md to any URL

curl https://friendoftheshow.live/comedians/james-acaster.md

Use the Accept header

curl -H "Accept: text/markdown" https://friendoftheshow.live/comedians/james-acaster

Works on all routes: /comedians, /shows, /live-dates, /locations, and detail pages.

llms.txt

We publish standard llms.txt files for AI agent discovery:

/llms.txt

Concise site overview, capabilities, and access methods

View →

/llms-full.txt

Full documentation: all routes, MCP tool schemas, data model

View →

What data is available?

•Comedians — profiles, bios, social links, classification
•Shows — podcasts and TV shows with descriptions and artwork
•Episodes — episode titles, descriptions, publish dates, season/episode numbers
•Live Dates — upcoming gigs with venue, city, country, and ticket links
•Venues — names, cities, countries, coordinates

All data is read-only. No user accounts, authentication tokens, or personal information is exposed.