@fouldomain/mcp-server
v2.1.0
Published
MCP server for Foul Domain Phish concert analytics. Query 36,000+ analyzed tracks, show scores, and jam data.
Maintainers
Readme
Foul Domain MCP Server
An MCP (Model Context Protocol) server that gives AI assistants access to Phish concert analytics from Foul Domain. Query 36,000+ analyzed tracks, show scores, jam ratings, and more.
Tools
| Tool | Description |
|------|-------------|
| search_songs | Find songs by name |
| best_versions | Top-rated versions of any song, filterable by year/era, venue, state |
| get_show | Show details with full setlist and scores |
| top_shows | Highest-rated shows, filterable by year/era, tour, venue, state |
| song_stats | Detailed song stats: plays, debut, gap, audio analysis |
| find_jams | Search jams by song, tags, year/era, venue, state, BPM, duration, groove, with sort options |
| bustouts | Find songs with long gaps between performances |
| shows_by_venue | Find shows at a specific venue, city, or state |
Setup
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"fouldomain": {
"command": "npx",
"args": ["-y", "@fouldomain/mcp-server"]
}
}
}Claude Code
Add to your ~/.claude/settings.json:
{
"mcpServers": {
"fouldomain": {
"command": "npx",
"args": ["-y", "@fouldomain/mcp-server"]
}
}
}Manual
npx @fouldomain/mcp-serverExample Queries
Once connected, you can ask your AI assistant things like:
By song
- "What's the best version of Tweezer?"
- "Best Reba from 1997"
- "Top Ghost versions at MSG"
- "Best 3.0 Tweezers"
By style
- "Find me a long, dark Phish jam"
- "Dark funky jams from 1997-1999"
- "Best Type II jams over 20 minutes"
- "Grooviest jams from Fall 1997"
- "Longest jams in 2.0"
By year and era
- "Best Phish shows from 1997"
- "Top shows in 3.0"
- "Best jams from 2003-2004"
By venue and location
- "Best shows at MSG"
- "When did they last play Red Rocks?"
- "Top shows in Colorado"
- "What shows were at the Gorge in 2023?"
- "Best jams at Hampton Coliseum"
Bustouts and gaps
- "What songs haven't they played in 50+ shows?"
- "What bustouts happened in 2024?"
- "Songs they haven't played since 1.0"
Show details
- "What happened at the Phish show on 12/31/99?"
- "Show me the setlist from Baker's Dozen night 1"
- "How many times has Phish played Reba?"
Every response includes links back to fouldomain.com for full audio analysis, waveforms, and playback.
Data
Powered by audio analysis of 36,861 Phish tracks from Phish.in, scored using a blend of:
- Phish.net community ratings (343,000+ votes)
- Phish.in likes
- Jam chart recognition
- Audio analysis (energy, groove, rhythm, BPM, peak detection)
License
MIT
