API & MCP Server

Connect your AI assistant to 36,000+ analyzed Phish tracks. Works with Claude, ChatGPT, and any MCP-compatible client. Free, no authentication required.

MCP Server

The Model Context Protocol lets AI assistants like Claude and ChatGPT query Foul Domain directly. Ask your AI "what's the best Tweezer?" and get an answer sourced from our data.

Install via npm:

npx @fouldomain/mcp-server

Claude Desktop / Claude Code (local stdio):

{
  "mcpServers": {
    "fouldomain": {
      "command": "npx",
      "args": ["-y", "@fouldomain/mcp-server"]
    }
  }
}

ChatGPT / Remote clients (HTTP):

{
  "mcpServers": {
    "fouldomain": {
      "url": "https://fouldomain.com/api/mcp"
    }
  }
}

Available Tools

search_songs

Search for songs by name

"Search for Ghost"
best_versions

Top versions of a song — filter by year/era, venue, state

"Best Reba from 1997"
get_show

Full show details with setlist and scores

"What happened on 12/31/99?"
top_shows

Highest-rated shows — filter by year/era, tour, venue, state

"Top shows at MSG"
song_stats

Play count, debut, gap, audio analysis

"Tell me about Reba"
find_jams

Search by song, tags, year/era, venue, state, BPM, groove, with sort options

"Dark funky Tweezers from 1997-1999"
bustouts

Songs with long gaps between performances

"Bustouts from 2024"
shows_by_venue

Find shows at a venue, city, or state

"Shows at Red Rocks"

View on npm · Source on GitHub

ChatGPT

Use Foul Domain directly in ChatGPT — no setup required.

Open in ChatGPT

Public API

REST endpoints powering the MCP server. No auth required. Responses cached for 1 hour. OpenAPI spec

GET/api/public/song?q={query}

Search songs by name with stats and audio analysis

GET/api/public/best-versions?song={name}&year={n}&startYear={n}&endYear={n}&venue={name}&state={st}&limit={n}

Top-rated versions of a song, filterable by year range, venue, state

GET/api/public/show?date={YYYY-MM-DD}

Show details with setlist and scores

GET/api/public/top-shows?year={n}&startYear={n}&endYear={n}&tour={name}&venue={name}&state={st}&limit={n}

Highest-rated shows, filterable by year range, tour, venue, state

GET/api/public/find-jams?song={name}&tag={t1,t2}&year={n}&startYear={n}&endYear={n}&venue={name}&state={st}&sort={field}&limit={n}

Search jams by song, tags, year range, venue, state, BPM, groove — sort by score, duration, or groove

GET/api/public/bustouts?minGap={n}&year={n}&limit={n}

Songs with long performance gaps — current candidates or historical bustouts by year

GET/api/public/shows-by-venue?venue={name}&city={name}&state={st}&year={n}&limit={n}

Find shows at a venue, city, or state

Remote MCP Endpoint

For clients that support remote MCP servers over HTTP (Streamable HTTP transport):

Endpoint:

https://fouldomain.com/api/mcp

Stateless, no authentication. Supports POST for tool calls.