Agent integrations (MCP)

Connect an AI assistant — ChatGPT, Claude, Cursor or any MCP client — to AI BOOMBOX MUSIC. The assistant acts strictly as you: it sees only what your account is allowed to see.

Connection details

MCP server URLhttps://sonic-roots-africa.lovable.app/mcp
TransportStreamable HTTP
Manifesthttps://sonic-roots-africa.lovable.app/.mcp/list-tools
Resource metadatahttps://sonic-roots-africa.lovable.app/.well-known/oauth-protected-resource
OAuth issuerhttps://oipyinaeobbtofehklxd.supabase.co/auth/v1
Consent screenhttps://sonic-roots-africa.lovable.app/.lovable/oauth/consent

How to complete consent

  1. In your MCP client, add a custom connector and paste the MCP server URL above.
  2. The client registers itself automatically and opens our sign-in page. Sign in (or create an account) with the email you use here.
  3. You land on the consent screen, which names the requesting client. Review it and choose Approve — or Deny to cancel.
  4. You are redirected back to the client, which now holds a token scoped to your account. The tools below become available in that conversation.
  5. To revoke access, disconnect the connector in your MCP client. Tokens expire on their own and never leave the client.

Available tools

  • Search music catalogsearch_catalogread-only

    Search approved tracks by title, genre or language.

  • Get track detailsget_trackread-only

    Full metadata for one approved track.

  • List my uploadslist_my_tracksread-only

    Your own uploads with review status, paged (limit/offset) and filterable by status, genre, language and licence price.

  • List my purchaseslist_my_purchasesread-only

    Your purchase history with track metadata, amount and purchase timestamps.

  • Download a purchased trackdownload_purchased_trackwrites

    Secure download URL, valid 5 minutes, only for tracks you bought.

  • List my notificationslist_my_notificationsread-only

    Approval, rejection and change-request notifications.

  • Mark notification readmark_notification_readwrites

    Clear a notification from your unread list.

Every call is authorised with your OAuth token and runs under the same database rules as the website. Downloads only work for tracks you have actually purchased, and download links expire after five minutes.