# Foul Domain

Search 36,000+ analyzed Phish tracks. Find the best jams, shows, and song versions by year, era, venue, tags, and more.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add fouldomain/phish-analytics

# Browse available tools
npx -y @smithery/cli@latest tool list fouldomain/phish-analytics

# Get full schema for a tool
npx -y @smithery/cli@latest tool get fouldomain/phish-analytics search_songs

# Call a tool
npx -y @smithery/cli@latest tool call fouldomain/phish-analytics search_songs '{}'
```

## Direct MCP Connection

Endpoint: `https://phish-analytics--fouldomain.run.tools`

## Tools (8)

- `search_songs` — Search for Phish songs by name. Returns song info, play counts, and audio stats.
- `best_versions` — Get the top-rated versions of a specific Phish song. Filter by year, year range, era, venue, or state.
- `get_show` — Get details about a specific Phish show by date (YYYY-MM-DD format).
- `top_shows` — Get the highest-rated Phish shows. Filter by year, year range, era, tour, venue, or state.
- `song_stats` — Get detailed statistics about a Phish song: total plays, debut, gap, average duration, and audio analysis.
- `find_jams` — Find Phish jams matching specific criteria. Filter by song, year/era, venue, state, tags (Dark, Funk, Bliss, Type II, e…
- `bustouts` — Find songs with long gaps between performances (bustouts). Without a year, shows current bustout candidates. With a yea…
- `shows_by_venue` — Find Phish shows at a specific venue, city, or state.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get fouldomain/phish-analytics <tool-name>
```

## Resources

- `fouldomain://guides/scoring` — How Foul Domain scores tracks and shows
- `fouldomain://about` — About Foul Domain and its data sources

## Prompts (3)

- `explore_song` (song) — Deep-dive analysis of a Phish song — best versions, stats, and standout jams across eras
- `discover_jams` (style, era) — Find jams matching a mood or style — dark, funky, blissful, ambient, etc.
- `show_recap` (date) — Get a full recap and analysis of a specific Phish show