Songsterr MCP

MCP server for Songsterr guitar, bass, and drum tabs. Deploys to Gumstack as an Internal MCP.

Repo: github.com/gumluke/songsterr-mcp

Setup

# Install dependencies (requires uv)
uv sync

# If you add or change dependencies, run and commit uv.lock for reproducible builds
# uv lock

# Optional: copy env for local overrides
cp env.example .env

Local development

# Run the server (streamable-http on PORT)
./run.sh

# Or
uv run songsterr-mcp

Set ENVIRONMENT=local in .env to use streamable-http; otherwise the server uses GumstackHost (for deployed env).

Authentication

This server uses No Authentication. Songsterr’s public API does not require user credentials or an API key. Users don’t provide anything in the Gumstack UI.

Tools

Tool	Description
search_tabs	Search for guitar, bass, or drum tabs by keyword (song title, artist, or phrase)
best_match	Get the single best matching tab for a search query (e.g. "enter sandman")
search_by_artist	Get tabs by one or more artist names (comma-separated)
get_tab	Fetch a tab by ID (metadata, track list, and a working view URL)

Tab notation

Songsterr’s public API only exposes search and song metadata (title, artist, track names). The actual tab notation (the notes/tablature) is not available via any documented public endpoint — it’s rendered in the browser on Songsterr. Every result includes a view_url that uses the current site URL pattern (e.g. /a/wsa/artist-title-tab-s123). Open that link to view and play the tab on Songsterr.

Deploy to Gumstack

1. Connect this repo (gumluke/songsterr-mcp) in Gumstack Internal MCPs.
2. Ensure the GitHub App is installed for the repo so pushes trigger deployments.
3. Push to main; Gumstack builds and deploys. The server URL is on the server’s Overview tab.

About

MCP server: Songsterr MCP — search and fetch tabs from Songsterr.