01MCP 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"
}
}
}View on npm · Source on GitHub
02Available tools
Each tool maps to a public REST endpoint. Examples are real prompts your AI can answer end-to-end.
search_songs— Search for songs by name. e.g. “Search for Ghost”best_versions— Top versions of a song — filter by year/era, venue, state. e.g. “Best Reba from 1997”get_show— Full show details with setlist and scores. e.g. “What happened on 12/31/99?”top_shows— Highest-rated shows — filter by year/era, tour, venue, state. e.g. “Top shows at MSG”song_stats— Play count, debut, gap, audio analysis. e.g. “Tell me about Reba”find_jams— Search by song, tags, year/era, venue, state, BPM, groove. e.g. “Dark funky Tweezers from 1997-1999”bustouts— Songs with long gaps between performances. e.g. “Bustouts from 2024”shows_by_venue— Find shows at a venue, city, or state. e.g. “Shows at Red Rocks”
03ChatGPT
Use Foul Domain directly in ChatGPT — no setup required.
04Public API
REST endpoints powering the MCP server. No auth required. Responses cached for 1 hour. See the OpenAPI spec.
/api/public/song?q={query}Search songs by name with stats and audio analysis
/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
/api/public/show?date={YYYY-MM-DD}Show details with setlist and scores
/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
/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
/api/public/bustouts?minGap={n}&year={n}&limit={n}Songs with long performance gaps — current candidates or historical bustouts by year
/api/public/shows-by-venue?venue={name}&city={name}&state={st}&year={n}&limit={n}Find shows at a venue, city, or state
05Remote MCP endpoint
For clients that support remote MCP servers over HTTP (Streamable HTTP transport):
https://fouldomain.com/api/mcp
Stateless, no authentication. Supports POST for tool calls.
Found a bug, missing endpoint, or want to talk integration? Reach us.