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
- Connect this repo (gumluke/songsterr-mcp) in Gumstack Internal MCPs.
- Ensure the GitHub App is installed for the repo so pushes trigger deployments.
- 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.