Skip to main content

Connecting to the MCP server

Stagemates exposes its MCP server at a single endpoint. Any MCP client that supports remote servers with OAuth sign-in can connect — no API keys, tokens, or client IDs to copy around.

The endpoint​

https://api.stagemates.live/mcp

The server uses the standard Streamable HTTP transport, and authentication is OAuth 2.1 with automatic discovery and client registration — your MCP client figures out the sign-in flow on its own from that one URL.

Connect​

  1. In your MCP client, add a new remote server (often called a connector, integration, or custom MCP server) and paste the endpoint URL above. Name it whatever you like — "Stagemates" works.
  2. The client will report that the server requires authorization and open your browser to Stagemates.
  3. Sign in if you aren't already — the usual email code flow, using the same account you use in the app.
  4. You'll land on the consent screen, which shows which client is asking to connect and what access it's requesting. Review and approve.
  5. Back in your MCP client, the connection completes. You're done — ask your assistant to check your Stagemates library to confirm it works.

The connection is tied to your account: the assistant sees only your songs, bands, and setlists, and every action it takes runs under your plan's limits and quotas, exactly as if you did it in the app.

Disconnecting​

Remove the Stagemates server from your MCP client's connector/integration settings. Reconnecting later just repeats the same sign-in and consent flow.

Troubleshooting​

  • "Unauthorized" or a sign-in loop — make sure the server URL is exactly https://api.stagemates.live/mcp, including the /mcp path. The path matters: it's part of the server's identity.
  • No code email arrives during sign-in — Stagemates is invite-only; the account email must already have access. See Signing in.
  • Client asks for an API key or credentials — leave those blank and look for an OAuth/"sign in with browser" option; Stagemates doesn't use API keys.

For what a connected assistant can actually do, see Connecting an AI assistant.