Skip to main content

Preview Docs

Bandruption MCP Connector

This preview route renders the same MCP connector document that ships from `docs-public`, so PR previews stay reviewable even though Firebase preview deploys only the web app.

Bandruption MCP Connector

Bandruption hosts a Model Context Protocol (MCP) server at https://mcp.bandruption.com/mcp. Adding it as a connector lets Claude — or any MCP-aware assistant — read your artist context and run admin operations on your behalf, with you in the loop for every change.

Status: OAuth 2.1 + PKCE is live on the production MCP endpoint. Keep this page synchronized with the currently deployed transport, scope, and tool surface.

What you can do with it

Once the connector is added and you've signed in, your assistant can:

  • Read your data — fetch artist context (profile, loyalty program, counts), event lists, affiliate summaries, and bounty details.
  • Run your fan-engagement programs — create, update, archive, and review claims on loyalty bounties for the artists or music-industry profiles you own.
  • Set up events and ticketing — create draft events, add ticket types with pricing, capacity, and member-only options.
  • Manage your storefront — create merch products with pricing, inventory, and variants.

Every write tool requires you to confirm the action in chat before it executes. Your assistant proposes the change first; you approve.

What you can't do (yet)

The MCP exposes admin operations only — the same actions you could perform in Bandruption's web admin. It does not:

  • Move money or process payments
  • Generate AI images or audio
  • Access fan personal data outside your audit reach
  • Modify other artists you don't own

Add the connector to Claude

Claude.ai (web)

  1. Open Settings → Connectors → Add custom connector.
  2. Enter https://mcp.bandruption.com/mcp as the URL.
  3. Click Connect. You'll be redirected to Bandruption to sign in (or jump straight to consent if you're already signed in).
  4. Review the requested access (admin scope on the artists you own) and click Approve.
  5. The connector is now available in any chat. Try: "List my active bounties on <your-artist>."

Claude Desktop

  1. Open Settings → Developer → Edit Config.
  2. Add the Bandruption server to the mcpServers block:
    {
      "mcpServers": {
        "bandruption": {
          "url": "https://mcp.bandruption.com/mcp"
        }
      }
    }
    
  3. Restart Claude Desktop. The OAuth flow runs in your browser the first time you call a Bandruption tool.

Other MCP-aware clients

Any client that implements the MCP Authorization spec (OAuth 2.1 + Dynamic Client Registration) can connect:

  • Server URL: https://mcp.bandruption.com/mcp
  • Authorization Server discovery: the server returns WWW-Authenticate: Bearer resource_metadata=… on an unauthenticated request, pointing at the protected-resource metadata for https://bandruption.fun/api/oauth
  • Canonical OAuth resource: https://mcp.bandruption.com/mcp
  • Compatibility note: older clients that still send https://mcp.bandruption.com are accepted during rollout, but Bandruption normalizes tokens to the canonical /mcp audience
  • Required scope: mcp:admin

What the assistant sees

The server exposes:

Read tools

  • bounty.list — list bounties for an artist or industry entity
  • bounty.get — fetch a single bounty by ID

Write tools (all require explicit confirmed: true)

  • uploads.create_signed_url — mint a Bandruption-managed upload URL and return the filePath you can reuse in later MCP calls
  • entity.update_profile — update an artist or music-industry profile, including avatar paths returned by uploads.create_signed_url
  • entity.update_tabs — update the enabled/default tab configuration for an artist or music-industry profile
  • event.create — draft an in-person or virtual event
  • ticket_type.create — add a ticket type to an event
  • merch.create — add a merch product to an artist's storefront
  • bounty.create — create a fan-engagement bounty
  • bounty.update — change an existing bounty (criteria/rewards may be replaced)
  • bounty.archive — hide a bounty from fans
  • bounty.add_criterion — append a criterion to a bounty
  • bounty.add_reward — append a reward to a bounty
  • bounty.approve_claim — approve a fan's bounty claim
  • bounty.reject_claim — reject a fan's bounty claim

For entity-scoped MCP tool arguments, use lowercase public entityType values:

  • artist
  • music_industry

Older draft examples that showed uppercase enum constants (ARTIST, MUSIC_INDUSTRY) are not the public MCP contract.

Resources

  • bandruption://admin/artists/{username}/context — full artist + loyalty-program snapshot
  • bandruption://admin/artists/{username}/events — upcoming and past events
  • bandruption://admin/artists/{username}/affiliate-summary — affiliate offering, links, and recent attributions

Security and privacy

  • OAuth 2.1 + PKCE. Every connection runs through Bandruption's standard sign-in, and access tokens are short-lived (15 minutes) and refreshable until you revoke them.
  • You're in control. Write tools never run without your explicit approval in chat. The server enforces a confirmed: true flag on every mutation.
  • Scope is yours. The connector can only act on artists or music-industry profiles you own. It can't read or modify other accounts.
  • Audit trail. Every tool call is logged to your Bandruption account's audit history. View it in the admin dashboard.
  • Privacy. See the Bandruption Privacy Policy for details on how your data is handled.

Revoke access

Open Settings → Connectors → Bandruption → Disconnect in your assistant. The next refresh attempt will fail and the access token will expire within 15 minutes.

You can also revoke from Bandruption: Settings → Connected Apps, find the entry for your assistant, and click Revoke.

Support

With your permission, we use privacy-conscious analytics to understand which pages and journeys work. Declining does not affect sign-in, purchases, or any product feature.