Skip to main content

How to Connect the Mogul MCP to Gemini and What You Can Do With It

Learn how to add the Mogul MCP to Gemini via Google AI Studio, the Gemini CLI, or Cursor/VS Code, and use it to distribute music, register publishing, query royalty data, and more.

What is the Mogul MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect directly to external tools and services. The Mogul MCP brings your entire music business into your AI development environment — so you can distribute music, manage publishing, query royalty data, generate catalog reports, and more, all through natural conversation.

Note: Gemini's MCP support is currently available through Google AI Studio, the Gemini CLI, and coding tools like Cursor and VS Code with the Gemini extension. It is not yet available in the standard consumer Gemini chat app at gemini.google.com.

Option 1: Google AI Studio (Browser-Based)

Requirements

Steps

  1. Go to aistudio.google.com and sign in with your Google account

  2. Open a new chat or agent session

  3. Click the Tools or MCP Servers option in the sidebar or settings panel

  4. Click Add MCP Server (or Connect)

  5. Enter the following details:

    • Name: Mogul

    • Server URL: https://api.usemogul.com/mcp

  6. Save the configuration — Gemini will discover and load the tools your Mogul account exposes

  7. Start chatting and Mogul tools will be available in your session

Option 2: Gemini CLI (Terminal)

Requirements

  • Gemini CLI installed (npm install -g @google/gemini-cli)

  • A Google account authenticated with the CLI

  • A Mogul account

Steps

  1. Open your Gemini CLI configuration file (typically ~/.gemini/settings.json or gemini.json in your project root)

  2. Add Mogul under the mcpServers section:

    {
  "mcpServers": {
    "mogul": {
      "url": "https://api.usemogul.com/mcp"
    }
  }
}

  3. Save the file and restart the Gemini CLI

  4. Verify the connection by running: gemini mcp list — Mogul should appear as an active server

  5. You can now use Mogul tools in any CLI session

Option 3: Cursor or VS Code with Gemini Extension

Steps

  1. Open your IDE settings and navigate to Settings > Features > MCP (Cursor) or the Gemini extension's MCP configuration

  2. Add a new MCP server with:

    • Name: Mogul

    • URL: https://api.usemogul.com/mcp

  3. Restart your IDE completely to allow the agent to discover and index the new MCP tools

  4. Verify it's active by checking Settings > Features > MCP — the server should show as Connected

What You Can Do with Mogul + Gemini

Once connected, Gemini can act as your AI music business manager. Here's what's possible:

🎵 Distribute a Song

Kick off a distribution for a new release — specify the track, territories, platforms, and release date. Gemini will handle the process through your Mogul account.

Example prompts:

  • "Distribute my new single 'Wavelength' to all major platforms with a release date of July 1st."

  • "What's the current status of my last distribution submission?"

📝 Register Your Publishing

Register compositions, add co-writer splits, and manage your publishing metadata in plain language.

Example prompts:

  • "Register 'Wavelength' for publishing with a 50/50 split between me and my co-writer."

  • "Show me all compositions I haven't registered for publishing yet."

💰 Talk to Your Royalty Data

Query your earnings by song, platform, territory, or time period — no spreadsheets needed.

Example prompts:

  • "How much did I earn from Spotify streams last quarter?"

  • "Which of my songs generated the most mechanical royalties this year?"

  • "Compare my streaming royalties from Q1 vs Q2."

📊 Generate Custom Catalog Reports

Get performance reports by artist, release, platform, or date range — no CSV exports or pivot tables required.

Example prompts:

  • "Give me a full performance report for my album 'Night Sessions' across all platforms."

  • "Which 5 tracks have grown the most in streams over the last 6 months?"

  • "Summarize my top-earning songs for my accountant."

🗂️ Manage Your Catalog

Search and update catalog metadata — fix titles, add ISRC codes, update contributor credits, and keep everything accurate.

Example prompts:

  • "Show me all tracks missing an ISRC code."

  • "Update the featured artist credit on 'Wavelength' to include DJ Pulse."

📅 Stay on Top of Deadlines & Submissions

Track submission windows, pending tasks, and upcoming release or registration deadlines.

Example prompts:

  • "Do I have any pending submissions or tasks in Mogul right now?"

  • "What releases are scheduled in the next 30 days?"

Tips for Getting the Most Out of Mogul + Gemini

  • Restart fully after setup — Gemini agents (especially in IDEs) index MCP tools on startup. A full restart ensures Mogul's tools are properly loaded.

  • Verify the connection — run gemini mcp list in the CLI or check your IDE's MCP settings to confirm Mogul shows as Connected before starting a session.

  • Be specific — the more detail you give Gemini (song titles, dates, platforms), the more precise the results.

  • Combine tasks — distribute a song and register its publishing in a single conversation.

Troubleshooting

Gemini doesn't recognize Mogul tools.
Most Gemini agents index MCP tools only at startup. Completely restart your IDE or terminal session after adding the Mogul MCP configuration.

Mogul isn't connecting.
Double-check that the URL is entered exactly as https://api.usemogul.com/mcp. Even a small typo will prevent the connection from working.

I don't see an MCP option in AI Studio.
MCP support in Google AI Studio is rolling out progressively. If you don't see it yet, the Gemini CLI is a reliable alternative — see Option 2 above.

Need more help? Contact Mogul support at [email protected] or visit the Mogul Help Center.

Related Articles
Did this answer your question?