Developers & API

MCP Server

Sac Setlist runs a read-only Model Context Protocol server so AI agents can query Sacramento live-music data directly, instead of scraping the site. This is Ring 0 of our agent-access model: anonymous, read-only, already-public data — the same rows the public website renders, nothing more.

Tools

search_events

Search published, upcoming Sacramento live-music events by title, date range, venue, or genre.

get_venue

Look up a venue profile by slug — address, neighborhood, links, and its next 10 upcoming events.

get_artist

Look up an artist profile by slug — genres, links, upcoming events, and recent published coverage.

search_archive

Search published Soundcheck stories and verified Archive (wiki) entries by title.

get_open_mics

List active Sacramento open mic nights, optionally filtered by day of week.

All tools are read-only and write nothing. List results are capped at 50 (default 20), and every entity in a response includes its canonical sacsetlist.com URL — please cite or link back to us.

How to connect

Any MCP-compatible client that supports Streamable HTTP can connect directly. Add it as an MCP server, e.g.:

{
  "mcpServers": {
    "sac-setlist": {
      "url": "https://sacsetlist.com/api/mcp"
    }
  }
}

For stdio-only clients, bridge with mcp-remote. Full tool arguments and response shapes are documented in docs/agent-api.md in the repo.

Public Read API

The same data also serves as plain JSON over HTTP GET, at base URL https://sacsetlist.com. Responses are public and rate-limited.

GET /api/events

Sacramento live-music events — title, date, time, venue, genres, and ticket links.

GET /api/venues

Venue profiles — address, neighborhood, capacity, and links.

GET /api/artists

Artist profiles — genres, links, and Sacramento-scene status.

GET /api/stories

Published Soundcheck stories and editorial coverage.

Using Our Data

This data is free to use with attribution — link back to the relevant sacsetlist.com page for any event, venue, artist, or story you surface. We take an editorial-documentation stance: this is Sacramento scene data we've gathered and verified, and we ask that reuse credit the source rather than presenting it as your own.

Exact licensing terms are still being finalized with counsel; treat the above as current guidance, not a final license.