Bandruption MCP Connector
Bandruption hosts a Model Context Protocol (MCP) server at https://mcp.bandruption.fun/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.
Host migration: the former
.comendpoint and OAuth audience are retired. Remove the old connector and re-register it with the.funURL; old registrations and tokens are not accepted on the new audience.
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)
- Open Settings → Connectors → Add custom connector.
- Enter
https://mcp.bandruption.fun/mcpas the URL. - Click Connect. You'll be redirected to Bandruption to sign in (or jump straight to consent if you're already signed in).
- Review the requested access (admin scope on the artists you own) and click Approve.
- The connector is now available in any chat. Try: "List my active bounties on <your-artist>."
Claude Desktop
- Open Settings → Developer → Edit Config.
- Add the Bandruption server to the
mcpServersblock:{ "mcpServers": { "bandruption": { "url": "https://mcp.bandruption.fun/mcp" } } } - 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.fun/mcp - Authorization Server discovery: the server returns
WWW-Authenticate: Bearer resource_metadata=…on an unauthenticated request, pointing at the protected-resource metadata forhttps://bandruption.fun/api/oauth - Canonical OAuth resource:
https://mcp.bandruption.fun/mcp - Compatibility note: older clients that still send
https://mcp.bandruption.funare accepted during rollout, but Bandruption normalizes tokens to the canonical/mcpaudience - Required scope:
mcp:admin
What the assistant sees
The server exposes:
Read tools
| Tool | What it does |
|---|---|
bounty.list | List bounties for an artist or industry entity |
bounty.get | Fetch a single bounty by ID |
Write tools
All write tools require explicit confirmed: true.
| Tool | What it does |
|---|---|
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:
artistmusic_industry
Older draft examples that showed uppercase enum constants (ARTIST, MUSIC_INDUSTRY) are not the public MCP contract.
Resources
| Resource | Contents |
|---|---|
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: trueflag 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
- Bug reports / feature requests: support@bandruption.fun
- MCP spec: modelcontextprotocol.io

