tarana-mcp
Provides read-only tools for querying the Supabase project behind the Tarana Setlist Manager app, enabling retrieval of songs (with filtering by search text, key, and BPM range), setlists with songs in performance order, and upcoming/past shows, plus set-building suggestions and band statistics — all enforced by row-level security.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tarana-mcp Show me the setlist for Friday's gig, in order."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tarana-mcp
A read-only Model Context Protocol server that lets an AI assistant answer questions about my band's data - songs, setlists and shows - straight from the Supabase project behind the Tarana Setlist Manager app.
Ask things like:
"What songs do we have in G that are over 120 BPM?"
"Show me the setlist for Friday's gig, in order."
"How many shows are coming up?"
Why this exists
The setlist manager is a Next.js + Supabase app with row-level security on every
table. This server exposes that same data to agent tooling over MCP, with the
same RLS guardrails: it only ever runs SELECTs, and it can only read what the
credentials you give it are allowed to see.
Related MCP server: Supabase MCP Server
Tools
Tool | What it does |
| List repertoire, filter by search text, key, BPM range |
| One song with chord chart and notes |
| Recent setlists |
| A setlist with its songs in performance order |
| Upcoming/past shows, filter by booking status |
| One show plus its setlist |
| Set-builder helper: songs by key/BPM |
| Counts: songs, setlists, total and upcoming shows |
Setup
npm install
cp .env.example .env # fill in SUPABASE_URL and SUPABASE_ANON_KEY
npm run buildClaude Code
claude mcp add tarana -- node /path/to/tarana-mcp/dist/index.jsClaude Desktop / any MCP client
{
"mcpServers": {
"tarana": {
"command": "node",
"args": ["/path/to/tarana-mcp/dist/index.js"],
"env": {
"SUPABASE_URL": "https://your-project-ref.supabase.co",
"SUPABASE_ANON_KEY": "your-anon-key"
}
}
}
}If your RLS policies scope rows to auth.uid(), also set
SUPABASE_ACCESS_TOKEN to a signed-in user's session token. Without it the
server reads whatever the anon role may see - which is the correct behaviour
for a public deployment.
Safety
Read-only: not one
insert,update,deleteor RPC in the code.No secrets in the repo: credentials come from
.envor the client config.RLS is the enforcement layer; the anon key is safe to use because your policies already decide what it can read.
Stack
TypeScript, @modelcontextprotocol/sdk (stdio transport), @supabase/supabase-js, zod.
Available Tools
8 toolsband_statsBand statsA
Quick overview: total songs, setlists, shows, and how many shows are coming up.
Inputs: no named parameters.
get_setlistGet a setlistA
Get one setlist by id with its songs in performance order, grouped by section when sections are used.
Inputs: setlist_id (required).
get_showGet a showA
Get one show by id, plus its setlist when one exists.
Inputs: show_id (required).
get_songGet a songB
Get one song by id, including its chord chart and rehearsal notes.
Inputs: song_id (required).
list_setlistsList setlistsC
List setlists, newest first.
Inputs: limit.
list_showsList showsB
List shows (gigs). Filter upcoming/past and by booking status (e.g. Enquiry, Confirmed, Advance Received, Completed).
Inputs: when, limit, booking_status.
list_songsList songsB
List songs in the band's repertoire, optionally filtered by a title/artist search, musical key, or minimum/maximum BPM.
Inputs: limit, search, bpm_max, bpm_min, +1 more.
suggest_songsSuggest songs for a setC
Suggest songs for building a set, filtered by key and/or BPM range. Useful for 'give me upbeat songs in G' style requests.
Inputs: limit, bpm_max, bpm_min, song_key.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have clear resource/action boundaries (list/get for songs, setlists, and shows; band_stats is distinct). However, suggest_songs overlaps substantially with list_songs, since both filter songs by key and BPM range, and the distinction is only loosely clarified as 'for building a set.'
The set mostly follows a consistent snake_case verb_noun pattern: list_songs, get_song, list_setlists, get_setlist, list_shows, get_show, and suggest_songs. band_stats is the one deviation, using a noun phrase with no verb, but it is still readable and predictable.
Eight tools is well-scoped for a band repertoire/setlist/show assistant. Each tool covers a clear read-oriented operation, and there is no excessive surface area.
The read side is solid: songs, setlists, and shows all have list/get coverage, plus suggestions and stats. However, the surface has no create/update/delete operations for songs, setlists, or shows, and no way to edit setlists or booking status, which are notable gaps for a band management domain.
Maintenance
Related MCP Connectors
PostgreSQL, MySQL, and SQL Server in one session. 26 read-only MCP tools for AI agents.
Read-only search of 2,189 AI agent tools (MCP servers, x402 APIs) with daily automated trust scores.
Read-only tools for the approved public KOKU SCRIPTS AI Catalog.
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform CRUD operations on Supabase databases through natural language. Supports advanced filtering, pagination, and safety checks for seamless database interaction.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with Supabase databases through standardized CRUD operations including querying, inserting, updating, and deleting records with support for filtering, pagination, and column selection.-
- FlicenseNot gradedqualityDmaintenanceConnects to a Gym Tracker Supabase database to provide LLMs with access to personal workout history, routines, and training progress. It enables users to analyze fitness performance, track personal records, and receive personalized coaching advice through natural language.-
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve read-only ISHARI shalawat content from Supabase, including verse translations, full chapters, audio recitations, reciters, and per-user bookmarks through MCP tools.-