Back to phishin
Card snapshot
phish.in
·
2026-08-05 17:18:42 UTC
·
6240cf289d2ed072c64184b92c815caccfef6ffedfa660884b1c09cae2cd7561
This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.
{
"schema_version": "0.3.0",
"protocolVersion": "0.3.0",
"name": "phishin",
"description": "Agent interface for the Phish.in live Phish audio archive. Browse and play shows, songs, venues, tours, tags, and playlists.",
"url": "https://phish.in/mcp",
"preferredTransport": "MCP",
"supportedInterfaces": [
{
"transport": "MCP",
"url": "https://phish.in/mcp",
"protocolVersion": "2025-03-26"
},
{
"transport": "MCP",
"url": "https://phish.in/mcp/anthropic",
"protocolVersion": "2025-03-26"
},
{
"transport": "MCP",
"url": "https://phish.in/mcp/openai",
"protocolVersion": "2025-03-26"
},
{
"transport": "HTTPS+JSON",
"url": "https://phish.in/api/v2",
"protocolVersion": "2.0"
}
],
"additionalInterfaces": [
{
"transport": "MCP",
"url": "https://phish.in/mcp/anthropic"
},
{
"transport": "MCP",
"url": "https://phish.in/mcp/openai"
}
],
"provider": {
"organization": "Phish.in",
"url": "https://phish.in"
},
"version": "1.0.0",
"documentation_url": "https://phish.in/llms.txt",
"documentationUrl": "https://phish.in/llms.txt",
"icon_url": "https://phish.in/logo.svg",
"iconUrl": "https://phish.in/logo.svg",
"capabilities": {
"streaming": false,
"push_notifications": false,
"state_transition_history": false
},
"default_input_modes": [
"text/plain",
"application/json"
],
"defaultInputModes": [
"text/plain",
"application/json"
],
"default_output_modes": [
"text/plain",
"application/json"
],
"defaultOutputModes": [
"text/plain",
"application/json"
],
"skills": [
{
"id": "get_audio_track",
"name": "get_audio_track",
"description": "Get a song performance with audio URL. triggers: 'play [song]', 'random track', 'listen to', 'surprise me', or when user selects a performance from get_song results. params: random=true for random; slug='YYYY-MM-DD/track-slug' for specific. display: Link to track web URL (use 'url', not 'mp3_url'). The web page provides artwork, context, and navigation.",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"Play a random Phish track",
"Play Tweezer from 1997-11-22"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "get_playlist",
"name": "get_playlist",
"description": "Get a playlist with track listing, show dates, and durations. display: Link playlist name to playlist URL, track titles to track web URLs (use 'url', not 'mp3_url'). Format dates as 'Jul 4, 2023'. Show max 10 tracks. Example: | [Tweezer](track_url) | [Jul 4, 2023](show_url) |",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "get_show",
"name": "get_show",
"description": "Get a Phish show with full setlist, venue, tags, and gaps. triggers: 'random show', specific dates ('Halloween 1995', '12/31/99'), or follow-up to list_shows/search. params: random=true for random; date='YYYY-MM-DD' for specific. display: Format dates as 'Jul 4, 2023'. Link tracks to web URLs (use 'url', not 'mp3_url').",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"Get the Halloween 1995 show",
"Random Phish show"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "get_song",
"name": "get_song",
"description": "Get a Phish song with performance history. triggers: 'random song' or specific song by slug. params: random=true for random; slug='song-slug' for specific. display: Format dates as 'Jul 4, 2023'. Link tracks to web URLs (use 'url', not 'mp3_url').",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"Show me the history of Tweezer"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "get_tag",
"name": "get_tag",
"description": "Get shows or tracks associated with a specific tag. params: type='show' for tagged shows (e.g., costume); type='track' for tagged tracks (e.g., jamcharts). display: Link dates to show URLs, song names to track web URLs (use 'url', not 'mp3_url'). Format dates as 'Jul 4, 2023'. Example: | [Tweezer](track_url) | [Jul 4, 2023](show_url) |",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "get_tour",
"name": "get_tour",
"description": "Get a Phish tour with date range and show count. params: random=true for random; slug='tour-slug' for specific. follow-up: Use list_shows with tour_slug to get shows on this tour. display: Format dates as 'Jul 4, 2023'.",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "get_venue",
"name": "get_venue",
"description": "Get a venue with location, show count, and date range. params: random=true for random; slug='venue-slug' for specific. follow-up: Use list_shows with venue_slug to get shows at this venue. display: Format dates as 'Jul 4, 2023'.",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "list_playlists",
"name": "list_playlists",
"description": "List user-created playlists with optional sorting. follow-up: Use get_playlist with slug for full track listing. display: Link playlist names to their URLs. Example: [My Favorite Jams](url)",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "list_shows",
"name": "list_shows",
"description": "Browse shows by year, date range, tour, or venue. Returns shows WITHOUT setlists. params: At least one filter required. follow-up: Call get_show with date to get full setlist and audio. display: Link dates to show URLs, venues to venue URLs. Format dates as 'Jul 4, 2023'. Example: | [Jul 4, 2023](show_url) | [MSG](venue_url) |",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"List all 1995 shows",
"Shows at Red Rocks"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "list_songs",
"name": "list_songs",
"description": "List Phish songs with optional filtering and sorting. follow-up: Use get_song with slug for detailed performance history. display: Link song titles to their URLs. Example: [Tweezer](url)",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"All Phish songs starting with T"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "list_tags",
"name": "list_tags",
"description": "List all tags with show and track counts. Tags categorize content: Jamcharts (notable jams), Costume, Guest, Debut, and more. follow-up: Use get_tag with a tag slug to see tagged items.",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "list_tours",
"name": "list_tours",
"description": "List all Phish tours with optional year filtering. follow-up: Use get_tour with slug for tour details.",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "list_venues",
"name": "list_venues",
"description": "List Phish venues with optional geographic filtering. follow-up: Use get_venue with slug for venue details. display: Link venue names to their URLs. Example: [Madison Square Garden](url)",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"Venues in Colorado"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "list_years",
"name": "list_years",
"description": "List all years/eras when Phish performed, with show counts. Eras: 1.0 (1983-2000), 2.0 (2002-2004), 3.0 (2009-2020), 4.0 (2021+). follow-up: Use list_shows with year to see shows. display: Link years to their URLs. Example: [1995](url)",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "search",
"name": "search",
"description": "Case-insensitive substring search across shows, songs, venues, tours, tags, and playlists. note: For specific dates ('Halloween 95', 'NYE 99'), use get_show directly. follow-up: Call get_show for full setlist and audio details. display: Link dates to show URLs, titles to song URLs, names to venue URLs. Format dates as 'Jul 4, 2023'. api: https://phish.in/api/v2/swagger_doc (no key required)",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"Find all shows at Madison Square Garden",
"Search for Tweezer jams"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
},
{
"id": "stats",
"name": "stats",
"description": "Statistical analysis: gaps (bustouts), transitions, set positions, geographic patterns, co-occurrence, and song frequency. display: Link song names to song URLs, dates to track web URLs (use 'url', not 'mp3_url'). Format dates as 'Jul 4, 2023'. Example: | [Tweezer](song_url) | 42 | [Dec 31, 1995](track_url) | api: https://phish.in/api/v2/swagger_doc (no key required)",
"tags": [
"phish",
"live-music",
"archive"
],
"examples": [
"Longest gap for Harpua",
"Most-played songs of 1997"
],
"inputModes": [
"text/plain",
"application/json"
],
"outputModes": [
"text/plain",
"application/json"
]
}
]
}