{
  "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"
      ]
    }
  ]
}