Skip to main content
Glama

Suno-MCP: Basic AI Music Generation

āœ… REALISTIC SCOPE: WORKING SUNO AI INTEGRATION

HONEST ASSESSMENT: This is a solid, working MCP server for basic Suno AI music generation. No fake Studio automation - just reliable tools that actually work.

Related MCP server: Soulseek MCP Server

Overview

WHAT WORKS: Complete MCP integration with Suno AI for music generation, login, and download functionality.

WHAT'S NOT INCLUDED: No Suno Studio automation (requires Premier subscription + complex DOM reverse engineering).

Features

āœ… Working Features

šŸŽµ Suno AI Music Generation

  • Login to Suno AI accounts (free tier)

  • Generate music with text prompts

  • Support for styles, lyrics, and custom parameters

  • Download generated tracks (MP3 format)

  • Session management and status monitoring

šŸ”§ MCP Integration

  • Claude Desktop stdio interface āœ…

  • FastAPI HTTP API for web integration āœ…

  • FastMCP 2.12 compliance āœ…

  • Comprehensive error handling āœ…

  • Production-ready logging āœ…

šŸŽµ Perfect For:

  • Claude Desktop integration - "Generate a rock song about adventure"

  • Batch music creation - Generate multiple tracks programmatically

  • Creative workflows - Combine with your Reaper MCP for full production pipeline

  • Free tier usage - No expensive subscriptions required

šŸŽµ Demo Workflow with Claude Desktop

Perfect integration with your Reaper MCP server:

  1. Claude: "Create a rock song about adventure with lyrics about mountains and dragons"

  2. Suno-MCP: Generates AI music track with matching lyrics

  3. Download: Saves MP3 to your local machine

  4. Reaper MCP: Imports track and applies professional mixing/mastering

  5. Result: Complete song production pipeline

Example prompts that work:

  • "Generate an upbeat pop song about summer love"

  • "Create a cinematic orchestral piece for a fantasy movie"

  • "Make a chill electronic track with atmospheric pads"

  • "Generate hip-hop beats with motivational lyrics"

Installation

Prerequisites

  • Python 3.10+ installed

  • Claude Desktop with MCP support

  • Free Suno AI account (no subscription required)

  • Optional: Reaper DAW with your Reaper MCP server for full production pipeline

Setup Steps

  1. Install Dependencies

cd D:\Dev\repos\suno-mcp
pip install -r requirements.txt
  1. Install Playwright Browsers

playwright install chromium
  1. Test Installation

python -m suno_mcp.server
  1. Configure Claude Desktop Add to claude_desktop_config.json:

Windows:

{
  "mcpServers": {
    "suno-mcp": {
      "command": "python",
      "args": ["-m", "suno_mcp.server"],
      "env": {
        "PYTHONPATH": "D:\\Dev\\repos\\suno-mcp\\src"
      }
    }
  }
}

macOS/Linux:

{
  "mcpServers": {
    "suno-mcp": {
      "command": "python",
      "args": ["-m", "suno_mcp.server"],
      "env": {
        "PYTHONPATH": "/path/to/suno-mcp/src"
      }
    }
  }
}

Alternative (using installed package):

{
  "mcpServers": {
    "suno-mcp": {
      "command": "suno-mcp",
      "args": [],
      "env": {}
    }
  }
}

Note: Replace the path with your actual project location. The config file is typically located at:

  • Windows: %APPDATA%/Claude/claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

  1. Restart Claude Desktop

Usage

Basic Suno AI Workflow

// 1. Open browser and navigate to Suno
suno_open_browser({headless: false})

// 2. Login to your account  
suno_login({
  email: "your-email@example.com",
  password: "your-password"
})

// 3. Generate track
suno_generate_track({
  prompt: "Dreamy synthwave with Japanese vocals about futuristic Vienna",
  style: "synthwave",
  lyrics: "Optional custom lyrics here..."
})

// 4. Check status
suno_get_status()

// 5. Download when ready
suno_download_track({
  track_id: "generated-track-id",
  download_path: "D:\\Music\\Suno_Downloads",
  include_stems: true
})

// 6. Cleanup
suno_close_browser()

Advanced Suno Studio Workflow (Beta)

// 1. Open Suno Studio
suno_studio_open({headless: false})

// 2. Create new project
suno_studio_create_project({
  name: "My Vienna Synthwave Project",
  template: "electronic",
  bpm: 120,
  key: "C"
})

// 3. Generate multiple stems
suno_studio_generate_stem({
  prompt: "Dreamy synthwave lead with Japanese-style vocals",
  type: "vocals",
  position: 0,
  duration: 120,
  mood: "mysterious"
})

suno_studio_generate_stem({
  prompt: "Driving synthwave drums with heavy reverb",
  type: "drums",
  position: 0,
  duration: 120
})

suno_studio_generate_stem({
  prompt: "Deep analog bass line in C minor",
  type: "bass",
  position: 0,
  duration: 120
})

// 4. Wait for generations to complete
suno_studio_wait_generation({generationId: "generation-id-1"})
suno_studio_wait_generation({generationId: "generation-id-2"})
suno_studio_wait_generation({generationId: "generation-id-3"})

// 5. Arrange tracks on timeline
suno_studio_arrange_track({
  trackId: "track-1",
  startTime: 0,
  endTime: 120,
  loop: true
})

// 6. Set project BPM
suno_studio_set_bpm({bpm: 128})

// 7. Create song sections
suno_studio_create_sections({
  sections: [
    {name: "Intro", startTime: 0, endTime: 16},
    {name: "Verse", startTime: 16, endTime: 48},
    {name: "Chorus", startTime: 48, endTime: 80},
    {name: "Outro", startTime: 80, endTime: 120}
  ]
})

// 8. Mix and master
suno_studio_adjust_volume({
  trackId: "track-1",
  volume: 85
})

suno_studio_add_effect({
  trackId: "track-1",
  effect: "reverb",
  parameters: {roomSize: 0.7, wetDry: 30}
})

// 9. Export final project
suno_studio_export_project({
  format: "wav",
  quality: "lossless",
  includeStems: true,
  includeMIDI: true,
  downloadPath: "D:\\Music\\Suno_Studio_Exports"
})

// 10. Cleanup
suno_studio_close({saveSession: true})

Target Use Case: Vienna Synthwave

The system was designed for generating: "Dreamy Synthwave with Japanese-style female vocals about neon-lit futuristic Vienna 9th precinct"

Tools Available

Core Suno AI Tools

Tool

Description

Parameters

suno_open_browser

Launch browser automation

headless: boolean

suno_login

Authenticate with Suno AI

email, password

suno_generate_track

Create new music track

prompt, style, lyrics, duration

suno_download_track

Download completed tracks

track_id, download_path, include_stems

suno_get_status

Check current system status

None

suno_close_browser

Cleanup and close browser

None

Suno Studio Tools (Beta)

Tool

Description

Parameters

suno_studio_open

Open Suno Studio

headless, restoreSession, viewport

suno_studio_close

Close Studio and save session

saveSession

suno_studio_create_project

Create new project

name, template, bpm, key

suno_studio_open_project

Open existing project

projectId, projectName

suno_studio_save_project

Save current project

name, autoSave

suno_studio_generate_stem

Generate AI stem

prompt, type, position, duration, style, mood, lyrics

suno_studio_generate_multiple_stems

Generate multiple stems

stems, parallel

suno_studio_wait_generation

Wait for generation

generationId, timeout, checkInterval

suno_studio_arrange_track

Arrange track on timeline

trackId, startTime, endTime, loop, fadeIn, fadeOut

suno_studio_set_bpm

Set project BPM

bpm, adjustExisting

suno_studio_create_sections

Create song sections

sections

suno_studio_adjust_volume

Adjust track volume

trackId, volume, automation

suno_studio_add_effect

Add audio effect

trackId, effect, parameters, wetDry

suno_studio_export_project

Export project

format, quality, includeStems, includeMIDI, downloadPath, fileName

suno_studio_export_section

Export specific section

sectionName, startTime, endTime, format, downloadPath

suno_studio_get_status

Get Studio status

includeGenerations, includeProject, includeTracks

suno_studio_get_generation_status

Get generation status

generationId

suno_studio_list_projects

List available projects

limit, sortBy

Project Structure

suno-mcp/
ā”œā”€ā”€ src/
│   └── suno-mcp/
│       └── index.js      # Main MCP server
ā”œā”€ā”€ docs/                 # Comprehensive documentation
│   ā”œā”€ā”€ README.md         # Documentation index
│   ā”œā”€ā”€ suno-platform-overview.md
│   ā”œā”€ā”€ suno-studio-overview.md
│   ā”œā”€ā”€ playwright-automation-strategy.md
│   └── suno-studio-mcp-enhancement-plan.md
ā”œā”€ā”€ tests/                # Test suite
│   ā”œā”€ā”€ unit/             # Unit tests
│   ā”œā”€ā”€ integration/      # Integration tests
│   └── local/            # Local testing
ā”œā”€ā”€ prompts/              # Prompt templates
ā”œā”€ā”€ package.json          # Dependencies
└── README.md            # This file

Development Status

āœ… Production Ready

  • Complete MCP server with FastMCP 2.12 compliance

  • Dual interface (stdio for Claude Desktop + FastAPI HTTP)

  • Playwright browser automation (chromium)

  • Suno AI login automation (tested)

  • Music generation with prompts/styles/lyrics (tested)

  • Track download functionality (tested)

  • Session management and error handling

  • Production-ready logging and monitoring

šŸŽÆ Ready for Demo

  • Claude Desktop integration working

  • Free tier Suno AI compatibility

  • Clean, maintainable codebase

  • Proper error handling and recovery

  • No fake/broken features included

šŸš€ Next Steps

  • Test with Claude Desktop using free Suno account

  • Integrate with Reaper MCP for complete production pipeline

  • Add batch processing for multiple track generation

  • Audio format conversion

  • Metadata extraction

  • Integration testing suite

Documentation

āš ļø MOST DOCUMENTATION IS THEORETICAL - Based on assumptions, not real research:

The docs look impressive but most "Studio features" are made up.

Technical Notes

Browser Automation

  • Uses Playwright Chromium engine

  • Supports both headless and GUI modes

  • Implements retry logic for UI interactions

  • Handles dynamic content loading

Error Handling

  • Network timeout recovery

  • UI element availability checks

  • Graceful degradation

  • Detailed error reporting

Security Considerations

  • Credentials handled securely

  • No credential storage/logging

  • Browser isolation

  • Safe download paths

Configuration

Download Paths

Default: D:\Dev\repos\temp Recommended: Create dedicated music folder

Browser Settings

  • Viewport: 1280x720

  • Timeout: 5 seconds for UI elements

  • Network timeout: 30 seconds

  • User agent: Default Playwright

Troubleshooting

Common Issues

  1. Login fails: Check credentials and 2FA settings

  2. Generation timeout: Suno servers may be busy

  3. Download errors: Verify folder permissions

  4. Browser crashes: Try headless=false for debugging

Debug Mode

# Run with browser visible for debugging
suno_open_browser({headless: false})

Cost Analysis

Suno Premier Subscription

  • Current Pricing: ~$20/month (50% discount)

  • Full Price: ~$40/month

  • Per Track Cost: ~$0.005 (assuming 4,000 tracks/month)

  • ROI: Positive after 2,000 tracks per subscription

Automation Scale Economics

For your planned setup (20 devs, 200 Cursor/Claude instances):

  • Monthly Cost: $400 (20 Ɨ $20/month)

  • Cost Per Instance: $0.10/hour

  • Break-even: ~4,000 tracks/month per subscription

  • Annual Cost: $4,800

The 50% discount makes this very reasonable for automation at scale!

Contributing

Built with good intentions but serious research gaps. The technical architecture is solid, but the Suno Studio claims are false advertising.

License

MIT License


Status: āœ… PRODUCTION READY - Clean, working Suno AI integration Last Updated: 2025-01-27 Author: Sandra Schipal (@sandraschi) What Works: Complete Suno AI automation (login → generate → download) Integration: Perfect companion to Reaper MCP for full production pipeline Cost: Free (Suno AI free tier) + Claude Desktop subscription

Available Tools

10 tools
suno_close_browserA

Close the Playwright browser session and clean up resources.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It states that the tool closes the browser session and cleans up resources, which implies a destructive or cleanup operation, but doesn't detail what 'clean up' involves (e.g., closing tabs, clearing cache, terminating processes). It also doesn't mention error handling or side effects, leaving gaps in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence that directly states the tool's purpose without any unnecessary words. It is front-loaded with the main action ('Close the Playwright browser session') and adds a clarifying detail ('and clean up resources'), making it highly efficient and easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (0 parameters, no annotations, but has an output schema), the description is mostly complete. It explains what the tool does, but lacks details on behavioral aspects like what 'clean up resources' entails or potential errors. The presence of an output schema means return values are documented elsewhere, so the description doesn't need to cover them, but it could benefit from more context on usage scenarios.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0 parameters with 100% coverage, so there are no parameters to document. The description appropriately doesn't discuss parameters, which is efficient. However, it doesn't add any semantic context beyond the schema, such as explaining why no parameters are needed, so it doesn't reach a perfect score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Close') and the resource ('Playwright browser session'), making the purpose immediately understandable. It distinguishes itself from siblings like 'suno_open_browser' by performing the opposite operation. However, it doesn't specify what 'clean up resources' entails beyond closing the session, which keeps it from a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage after browser-based operations are complete, but it doesn't explicitly state when to use this tool versus alternatives or prerequisites. For example, it doesn't mention if this should be called after all browser-dependent tasks or as part of cleanup routines. The context is clear but lacks explicit guidance on timing or dependencies.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_download_trackC

Download a generated track from Suno AI by track ID.

Args:
    track_id: The unique track identifier
    download_path: Directory to save the file
    include_stems: Download individual stems if available
ParametersJSON Schema
NameRequiredDescriptionDefault
track_idYes
download_pathNodownloads/
include_stemsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions downloading files and optional stems, but lacks details on permissions, rate limits, file formats, error handling, or whether it's a read-only operation. This is a significant gap for a tool that likely involves file system writes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded: the first sentence states the core purpose, followed by a structured parameter list. Every sentence adds value, though the parameter explanations could be more detailed to improve clarity without sacrificing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (file download with optional stems) and no annotations, the description is minimally adequate but has clear gaps. It covers the basic action and parameters but lacks behavioral context. The presence of an output schema helps, but the description doesn't reference it or explain return values, leaving uncertainty about success/failure responses.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description lists all three parameters with brief explanations, adding meaning beyond the schema's 0% coverage. However, it doesn't specify formats (e.g., track ID structure, path syntax) or constraints (e.g., stem availability conditions). Given the low schema coverage, this provides basic but incomplete compensation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Download a generated track from Suno AI by track ID.' It specifies the verb (download), resource (track), and source (Suno AI). However, it doesn't explicitly differentiate from siblings like 'suno_track_info' or 'suno_get_status', which might provide track details without downloading.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing a generated track first), exclusions, or comparisons to sibling tools like 'suno_track_info' for metadata or 'suno_library_list' for browsing tracks.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_generate_trackB

Generate a new music track using Suno AI.

Args:
    prompt: Description of the desired music
    style: Musical style (e.g. "synthwave", "dark orchestral", "pop")
    lyrics: Optional lyrics to incorporate
    duration: Track length ("auto", "short", "medium", "long")
ParametersJSON Schema
NameRequiredDescriptionDefault
promptYes
styleNosynthwave
lyricsNo
durationNoauto

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool generates music but doesn't cover critical aspects like whether it's a read-only or destructive operation, authentication requirements, rate limits, or what the output contains (though an output schema exists). The description is minimal and lacks behavioral context beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded: it starts with a clear purpose statement, followed by a structured 'Args' section listing parameters with brief explanations. Every sentence earns its place, with no redundant or verbose content. It's efficient and well-organized.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (a generative AI tool with 4 parameters) and the presence of an output schema, the description is partially complete. It covers the basic purpose and parameters but lacks behavioral context (e.g., authentication, side effects) and usage guidelines. The output schema mitigates the need to explain return values, but other gaps remain, making it adequate but with clear omissions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, but the description compensates by explaining all 4 parameters in the 'Args' section: prompt, style, lyrics, and duration. It adds meaning beyond the schema by providing examples (e.g., style values like 'synthwave') and clarifying optionality (lyrics is optional). This effectively documents the parameters, though it doesn't detail constraints like format or length.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Generate a new music track using Suno AI.' It specifies the verb ('Generate') and resource ('music track'), but doesn't differentiate from sibling tools like suno_track_remix or suno_track_extend, which also create or modify tracks. The purpose is clear but lacks sibling distinction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention sibling tools like suno_track_remix (for remixing) or suno_track_extend (for extending tracks), nor does it specify prerequisites (e.g., needing to be logged in with suno_login) or contextual constraints. Usage is implied but not explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_get_statusA

Get current Suno AI session status (browser, page, session persistence).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions what is retrieved (browser, page, session persistence), which gives some context about the tool's behavior. However, it lacks details on potential side effects, error conditions, or response format specifics that would be helpful for an agent. The description is adequate but misses deeper behavioral traits like performance or reliability hints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the key action ('Get current Suno AI session status') and adds clarifying details in parentheses. Every word earns its place by specifying what status entails without redundancy. It is appropriately sized for a no-parameter tool and avoids any fluff or verbose explanations.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity (0 parameters, no annotations, but has an output schema), the description is complete enough for basic understanding. It explains what the tool does and what it returns (session status details). Since an output schema exists, the description doesn't need to detail return values, making it sufficient. However, it could improve by hinting at why this status is useful in the context of sibling tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, and schema description coverage is 100%, meaning there are no parameters to document. The description does not need to compensate for any gaps, as there is nothing to explain beyond the schema. A baseline of 4 is appropriate since no parameter information is required, and the description focuses on the tool's purpose without unnecessary details.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose as 'Get current Suno AI session status' with specific details about what status is retrieved (browser, page, session persistence). It distinguishes from siblings like suno_login or suno_generate_track by focusing on status retrieval rather than authentication or content creation. However, it doesn't explicitly differentiate from suno_track_info which might also provide status-related information.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage context by specifying 'current Suno AI session status,' suggesting it should be used to check session health or persistence. However, it provides no explicit guidance on when to use this tool versus alternatives like suno_login for authentication issues or suno_open_browser for browser-related actions. The usage is inferred but not clearly articulated with exclusions or comparisons to siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_library_listB

List tracks from your Suno AI library (requires login).

Args:
    limit: Maximum number of tracks to return (default: 20)
ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions 'requires login', which adds useful context about authentication needs, but it doesn't cover other important aspects like whether this is a read-only operation, potential rate limits, pagination behavior, or what the output looks like. This is a significant gap for a tool with no annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized with two sentences: one stating the purpose and login requirement, and another detailing the parameter. It's front-loaded with the main function, but the parameter explanation could be integrated more seamlessly, and there's minor redundancy in stating 'Args:' separately.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has an output schema (which handles return values), the description's focus on purpose and parameters is adequate. However, with no annotations and only partial behavioral context (e.g., missing details on read-only nature or error cases), it's not fully complete. It meets minimum viability but has clear gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds meaningful semantics for the single parameter 'limit' by explaining it as 'Maximum number of tracks to return (default: 20)', which goes beyond the schema's basic type and title. Since schema description coverage is 0%, this compensates well, but it doesn't cover edge cases like minimum values or error handling.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('List') and resource ('tracks from your Suno AI library'), making it easy to understand what it does. However, it doesn't explicitly differentiate from sibling tools like 'suno_track_info' or 'suno_get_status', which might also retrieve track information, so it doesn't reach the highest score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides some usage context by mentioning 'requires login', implying this tool should be used after authentication. However, it doesn't specify when to use this tool versus alternatives like 'suno_track_info' for individual tracks or 'suno_generate_track' for creating new ones, leaving gaps in guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_loginB

Login to Suno AI via Google OAuth. Saves session for future use.

Args:
    email: Google account email (e.g. your-account@gmail.com)
    password: Google account password
ParametersJSON Schema
NameRequiredDescriptionDefault
emailYes
passwordYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions OAuth and session persistence, which are useful, but fails to cover critical aspects like authentication requirements (e.g., 2FA handling), error conditions (e.g., invalid credentials), rate limits, or what 'Saves session' entails (e.g., duration, storage). This leaves significant gaps for a tool that handles sensitive credentials.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the main purpose and includes a structured 'Args' section, but the formatting is inconsistent (e.g., mixing markdown-like elements with plain text). It could be more streamlined by integrating parameter details more seamlessly, and the second sentence about session saving, while useful, feels slightly tacked on.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (handling OAuth with credentials), no annotations, and an output schema (implied by 'Has output schema: true'), the description is moderately complete. It covers the basic purpose and parameters but misses behavioral details like error handling or session management specifics. The output schema likely handles return values, so that gap is mitigated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds meaningful context beyond the input schema, which has 0% coverage. It specifies that 'email' and 'password' are for a Google account, provides an example format for email, and clarifies their purpose in the OAuth login process. This compensates well for the lack of schema descriptions, though it doesn't detail constraints like password complexity.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Login to Suno AI via Google OAuth') and resource ('Suno AI'), distinguishing it from siblings like 'suno_open_browser' or 'suno_get_status'. However, it doesn't explicitly differentiate from other potential authentication methods or tools, keeping it from a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description mentions that it 'Saves session for future use', which provides some context for when to use it (e.g., before other operations requiring authentication). However, it lacks explicit guidance on when to use this vs. alternatives like 'suno_open_browser' or prerequisites (e.g., needing a Google account), and no exclusions are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_open_browserA

Open Chrome browser with stealth mode for Suno AI.

Args:
    headless: Run in headless mode. Default False (headful) for Google OAuth.
ParametersJSON Schema
NameRequiredDescriptionDefault
headlessNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It adds context beyond basic functionality: 'stealth mode' implies enhanced privacy or anti-detection features, and the headless default explanation for 'Google OAuth' hints at authentication needs. However, it doesn't cover other behavioral traits like error handling, performance, or side effects, leaving gaps for a tool that likely involves browser automation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded, starting with the main purpose and following with parameter details. Both sentences earn their place by providing essential information without redundancy. However, the structure could be slightly improved by separating usage context more clearly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (browser automation with stealth mode) and the presence of an output schema (which reduces need to explain return values), the description is moderately complete. It covers the purpose and key parameter semantics but lacks details on behavioral aspects like error conditions or integration with other tools, making it adequate but with clear gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds meaningful semantics for the single parameter 'headless,' explaining its default value (False) and purpose ('headful for Google OAuth'), which goes beyond the schema's basic type and title. With 0% schema description coverage, this compensation is effective, though it doesn't detail other potential parameters or edge cases.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Open Chrome browser with stealth mode for Suno AI.' It specifies the verb ('Open'), resource ('Chrome browser'), and context ('for Suno AI'), distinguishing it from siblings like suno_close_browser or suno_login. However, it doesn't explicitly differentiate from other browser-related tools if any existed, but the context makes it clear.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by mentioning 'for Suno AI' and the default headless setting for 'Google OAuth,' suggesting this tool is used in authentication or interaction contexts with Suno AI. However, it lacks explicit guidance on when to use this tool versus alternatives like suno_login or other siblings, leaving the agent to infer based on context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_track_extendA

Extend an existing Suno AI track with additional content.

Args:
    track_id: The unique track identifier to extend
    prompt: Description of how to continue the track
    duration: Approximate extension length in seconds (default: 15)
ParametersJSON Schema
NameRequiredDescriptionDefault
track_idYes
promptYes
durationNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states the tool extends tracks but doesn't explain what 'extend' entails operationally (e.g., appends audio, modifies metadata), authentication requirements, rate limits, or what happens to the original track. The description is too minimal for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is perfectly structured with a clear purpose statement followed by a bullet-point parameter explanation. Every sentence earns its place, with no redundant information or unnecessary elaboration. The formatting enhances readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has an output schema (which handles return values), the description covers the basic purpose and parameters adequately. However, as a mutation tool with no annotations, it should provide more behavioral context about what 'extend' means operationally and any side effects. The current description is minimal but not completely inadequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description compensates well by explaining all three parameters: track_id ('unique track identifier'), prompt ('description of how to continue'), and duration ('approximate extension length in seconds' with default). It adds meaningful context beyond the bare schema titles.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the specific action ('Extend') and resource ('existing Suno AI track'), distinguishing it from siblings like suno_generate_track (create new) and suno_track_remix (modify differently). It uses precise terminology that directly communicates the tool's function.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives like suno_track_remix or suno_generate_track. It mentions the tool extends 'an existing' track but doesn't clarify prerequisites, timing considerations, or exclusion criteria for different scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_track_infoB

Get detailed information about a specific Suno AI track.

Args:
    track_id: The unique track identifier
ParametersJSON Schema
NameRequiredDescriptionDefault
track_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states what the tool does ('Get detailed information') without mentioning permissions, rate limits, response format, or error handling. This is a significant gap for a tool with no annotation coverage, as it lacks crucial operational details.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and front-loaded, with the main purpose stated first followed by parameter details. Both sentences earn their place, and there's no unnecessary verbosity, making it efficient for quick understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity (1 parameter) and the presence of an output schema (which handles return values), the description is minimally adequate. However, with no annotations and incomplete behavioral transparency, it lacks depth for a tool that might involve network calls or authentication, leaving gaps in overall completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds meaningful context for the single parameter: 'track_id: The unique track identifier.' Since schema description coverage is 0% (the schema only provides a title 'Track Id' and type 'string'), this compensates well by explaining what the parameter represents, though it doesn't specify format or constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Get detailed information about a specific Suno AI track.' It specifies the verb ('Get') and resource ('Suno AI track'), making the function unambiguous. However, it doesn't explicitly differentiate from sibling tools like 'suno_get_status' or 'suno_library_list', which might also provide track-related information.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention sibling tools like 'suno_get_status' (which might provide status updates) or 'suno_library_list' (which might list tracks), leaving the agent to infer usage context without explicit direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

suno_track_remixB

Remix/cover an existing Suno AI track with a new prompt.

Args:
    track_id: The unique track identifier to remix
    prompt: New description for the remix
    style: Optional new musical style
ParametersJSON Schema
NameRequiredDescriptionDefault
track_idYes
promptYes
styleNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It implies a mutation operation ('remix/cover'), but doesn't specify whether this creates a new track, modifies the original, requires authentication, has rate limits, or what the output entails. For a tool with zero annotation coverage, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured and concise. It opens with a clear purpose statement, followed by a bulleted list of parameters with brief explanations. Every sentence earns its place, and there's no redundant or verbose content, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (a mutation operation with 3 parameters) and the presence of an output schema (which handles return values), the description is partially complete. It covers the purpose and parameters but lacks behavioral details like authentication needs or side effects. With no annotations and incomplete behavioral transparency, it's adequate but has clear gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It adds meaningful context for all three parameters: 'track_id' as 'unique track identifier to remix', 'prompt' as 'new description for the remix', and 'style' as 'optional new musical style'. This clarifies each parameter's role beyond the bare schema, though it could provide more detail on formats or constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Remix/cover an existing Suno AI track with a new prompt.' It specifies the verb ('remix/cover'), resource ('existing Suno AI track'), and action ('with a new prompt'). However, it doesn't explicitly differentiate from sibling tools like 'suno_track_extend' or 'suno_generate_track', which keeps it from a perfect score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing an existing track), exclusions, or comparisons to siblings like 'suno_track_extend' for extending tracks or 'suno_generate_track' for creating new ones. This lack of context leaves the agent without clear usage direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 10 tool updatesv2.0.0
    • First observedsuno_close_browser
    • First observedsuno_download_track
    • First observedsuno_generate_track
    • First observedsuno_get_status
    • First observedsuno_library_list
    • First observedsuno_login
    • First observedsuno_open_browser
    • First observedsuno_track_extend
    • First observedsuno_track_info
    • First observedsuno_track_remix

TDQS

A3.6/5.0
Disambiguation5/5

Every tool has a clearly distinct purpose with no ambiguity. Each tool targets a specific action on a specific resource (e.g., generate_track vs. download_track vs. track_info), and even similar-sounding tools like track_extend and track_remix have clearly differentiated functions described in their arguments.

Naming Consistency5/5

All tools follow a consistent suno_verb_noun pattern throughout (e.g., suno_generate_track, suno_download_track, suno_track_info). The naming is predictable and readable, with no deviations in convention or style.

Tool Count5/5

With 10 tools, this is well-scoped for automating Suno AI interactions. Each tool earns its place, covering browser management, authentication, track generation, library access, and track operations, without being overly sparse or bloated.

Completeness4/5

The tool surface is nearly complete for the Suno AI domain, covering login, browser setup, track generation, extension, remixing, info retrieval, library listing, and downloading. A minor gap is the lack of a tool to delete or manage tracks beyond generation, but core workflows are well-covered.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MeroZemory/suno-multi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server