{ "name": "The Archivist", "description": "Keeper of the gd.SB Grateful Dead archive: 2,295 shows from 1965 to 1995. Answers questions about what was played, when, where, and how often, from real setlist data rather than recollection, and hands back links that play a night in the gd.SB player.", "version": "1.0.0", "url": "https://gd.sb/a2a", "preferredTransport": "JSONRPC", "supportedInterfaces": [ { "url": "https://gd.sb/a2a", "protocolBinding": "JSONRPC", "protocolVersion": "1.0" } ], "provider": { "organization": "gd.SB", "url": "https://gd.sb" }, "capabilities": { "streaming": false, "pushNotifications": false }, "defaultInputModes": [ "text/plain" ], "defaultOutputModes": [ "text/plain", "application/json" ], "skills": [ { "id": "tally", "name": "tally", "description": "Count anything in the archive, grouped however you need it, so you can BUILD A SCREEN out of real numbers. This is the tool to reach for before build_screen: it returns rows already shaped for a BarList or a Sparkline, and coordinates shaped for a MiniMap, so you can bind them straight into a surface without reformatting. count is what to tally (\"nights\", \"performances\", or \"sit_ins\"); by is how to group it (\"year\", \"decade\", \"month\", \"venue\", \"city\", \"state\", \"song\", \"guest\", \"era\"). Narrow it with venue, song, guest, from, to, or one only= condition. Examples: nights by year at one venue is the shape of a venue chart; performances by year of one song is the shape of that song's whole life; nights by venue with include_places gives you a map. Every filter is checked against the archive first, so a room they never played comes back as a refusal naming the closest real ones rather than an empty chart. Never make up a number to fill a component: call this instead, and if it refuses, say so.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "How many nights did they play Alpine Valley, and which years?", "Count the nights they played at Alpine Valley by year, and put it on the screen." ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "about_me", "name": "about_me", "description": "What this person has told the archive about themselves: the nights they were at, the shows and songs they saved, the songs they have said outright that they love, the rooms they went back to, and the well-known songs they never once caught live. Reach for it when someone asks about their own history, when a recommendation should avoid what they have already heard, or when you want to say something that shows you know them. It answers empty for a stranger, and that is a fine answer.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What do you know about me?", "What have I never heard live?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_setlist", "name": "get_setlist", "description": "What they actually played that night, set by set, in order, with the segues marked. Use this for any \"what did they play\", \"what was in the second set\" or \"how did the show open\" question. Never read the whole thing aloud — name the two or three that matter and offer the rest. Some nights have no known setlist and that is an honest answer.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What is the setlist?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_relic", "name": "get_relic", "description": "The ticket stub, pass or laminate from a night, when one survives. About half the nights have one. Reach for it when someone is dwelling on a show, when they say they were there, or when a stub would land better than another sentence. It shows on screen; describe it rather than reading a URL.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Is there a ticket stub for this one?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "superlative", "name": "superlative", "description": "The extremes of the whole archive: the longest and shortest shows by song count, the songs they played most and least, and the first and last night they ever played. Use it for any \"what is the most\", \"what is the rarest\", \"when did they start\" question. Give the answer and one detail, not the whole list.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What is the longest show they ever played?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "cover_styles", "name": "cover_styles", "description": "The styles a cover can be made in, described the way you would say them out loud. Reach for this when someone asks what the options are, or before making a cover so you can offer a choice rather than guessing. Never read all six as a list; offer two or three that suit the night and let them ask for the rest.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What cover styles are there?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "venue_portrait_styles", "name": "venue_portrait_styles", "description": "The styles a venue portrait can be made in, described the way you would say them out loud. Reach for this when someone asks what the options are, or before making a portrait so you can offer a choice rather than guessing. Never read all six as a list; offer two or three that suit the room and let them ask for the rest.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What portrait styles are there?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "search_archive", "name": "search_archive", "description": "Find Grateful Dead shows by date, venue, city, song, or the name of a guest musician who sat in. Use for any \"when did they play\", \"find the show at\", or \"which nights did X sit in\" question. Returns nights with a link that plays each one.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "When did they play Barton Hall?", "Put every night Branford Marsalis sat in on one screen, with what he played." ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_show", "name": "get_show", "description": "Everything about one specific night: the setlist, what made it notable, whether a recording actually circulates, how many circulate, any guest who sat in and the songs they played on, and whether footage of it exists. This is also the tool for \"who sat in\", \"who guested\" and \"was anybody else on stage\" for a known date. Requires an exact date.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Tell me about the 27th of August, 1972.", "Who else was up there that night?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_venue_history", "name": "get_venue_history", "description": "Every night the band played one room, in order, with first and last dates.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Every night at Madison Square Garden.", "Show me every night at Madison Square Garden." ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_song_stats", "name": "get_song_stats", "description": "A song's performance history: how many times, the debut, the last time, the longest silence, and the night that silence broke.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "How many times did they play Dark Star?", "Find me a Dark Star longer than twenty minutes and save it." ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "on_this_day", "name": "on_this_day", "description": "Every year the band played a given calendar day. Good for \"what happened on this date\".", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What happened on the 8th of May?", "How many nights did they play on my birthday?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_tour", "name": "get_tour", "description": "A whole tour as an ordered route: every mappable night in sequence with the miles, heading and days off between them. Use for 'walk me through Europe 72' or any single year as a tour.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Walk me through the Europe 72 tour.", "Fly me through the summer of 72 and say something at every stop." ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "compare_performances", "name": "compare_performances", "description": "Put two performances of the same song side by side with the context around each. Returns facts, deliberately not a verdict on which is better.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Compare the Dark Star from 8/27/72 with the one from 2/13/70.", "Which is better, Cornell or Veneta?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "find_similar_shows", "name": "find_similar_shows", "description": "More nights like a given one, ranked mostly by how much setlist they share, then era and feel. Only suggests shows that actually circulate.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Something like Cornell." ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_lore", "name": "get_lore", "description": "What tape traders and reviewers actually wrote about the shows. Searches Archive.org review text and returns the nights people talked about most.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What do people say about it?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_segues", "name": "get_segues", "description": "Everything a song ever flowed into or out of, with counts and the nights. Includes pairings that happened exactly once, which are usually the better story. Use for 'has Scarlet ever gone into anything but Fire'.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What comes out of Scarlet Begonias?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "get_suite", "name": "get_suite", "description": "A named unbroken chain like Help > Slip > Franklin's or China Cat > Rider: how many times ever, how many per year, and every night it happened.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What is in the Help, Slip, Frank suite?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "rarest_segues", "name": "rarest_segues", "description": "Transitions that happened exactly once in thirty years, with the night each one happened.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "What are the rarest segues?", "What is the rarest thing in here?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "search_covers", "name": "search_covers", "description": "Find generated cover art by what is depicted in it: 'a turtle coming out of the ocean', 'monkey wrench', 'skeleton with roses'. Each cover carries the art director's description of its subject, so this searches the picture rather than the show's metadata.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Find me a cover with a turtle in it." ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "crowd_verdict", "name": "crowd_verdict", "description": "What people who were there actually thought, from real Archive.org star ratings. Ranks by rating weighted by how many reviews exist, so a night with three raves does not outrank one with ninety. Use for 'best reviewed' or 'most divisive' questions.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Which nights do people save the most?", "Which nights does everybody keep?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] }, { "id": "recommend", "name": "recommend", "description": "Suggest nights to listen to, filtered by mood or era, ranked by how the archive itself rates them. Only ever suggests shows that actually circulate.", "tags": [ "grateful-dead", "music", "archive", "read-only" ], "examples": [ "Recommend me something spacey from 1973.", "What should I hear next, given what you know about me?" ], "inputModes": [ "text/plain" ], "outputModes": [ "application/json" ] } ] }