Skip to main content

ACE Music MCP

Create songs from an idea or custom lyrics, generate lyrics, and retrieve the original task through Ace Data Cloud.

Documentation

This new service package is prepared for release alongside the ACE Music API. Package publication, hosted deployment and real generation are separate release checks; source code does not confirm their availability.

Configure a credential

Get an application API key at Applications. Use a general application with ACE Music access or an ACE Music application; check balance, expiration and allowed APIs. Store the raw key in ACEDATACLOUD_API_TOKEN, never in a prompt or commit. Account management tokens do not replace generation API keys.

export ACEDATACLOUD_API_TOKEN="your-api-key"
# After the package is published:
uvx mcp-acemusic

For source development: pip install -e ".[dev,test]", then mcp-acemusic.

The hosted target after deployment is https://acemusic.mcp.acedata.cloud/mcp. Configure a Bearer API key in the client or use its OAuth connection flow when registration is enabled. The deployer must sync ACE Music's own AuthBackend OAuth seed and provision its state secret; credentials from another service must not be reused.

Tools

Tool Purpose
acemusic_generate_music One paid idea-to-song submission
acemusic_generate_custom_music One paid submission with lyrics, style and title
acemusic_generate_lyrics Separately priced title/lyrics assistant
acemusic_get_task Free authenticated lookup of the original task
acemusic_get_tasks_batch Query up to 50 original tasks
acemusic_list_tasks Paginated caller history
acemusic_list_models Local model discovery
acemusic_get_capabilities Supported workflows and recovery boundaries

Models: acemusic-v1.1 (default), acemusic-v1. A music task targets two MP3 candidates. Use lyrics section markers such as [Verse] and [Chorus]; the platform request field is lyric, not lyrics.

Save task_id immediately. Poll the same task every 10 seconds, inspecting its persisted response and group state. Partial failure is terminal and may include one playable candidate. A nonempty URL or a task ID alone does not mean full success. A client timeout must preserve the task identity for recovery rather than triggering another paid generation. If submission times out before a task ID arrives, reconcile the original request.

The package does not promise upload, cover, extend, stems, voice cloning, WAV, MIDI or video export. Check current pricing before submitting; task lookup is free and still requires authorization.

Development and deployment

Run ruff check ., ruff format --check ., mypy core tools main.py, pytest, and python -m build. Tests mock HTTP and do not spend account credit.

deploy/production targets the shared nginx-router ingress. Provision mcp-acemusic-oauth-state with state_key, the shared OAuth Redis secret, DNS/TLS and package/image publication before enabling the hosted entry. deploy/run.sh uses the repository's normal release mechanism.

The official ACE Music icon comes from the immutable CDN URL and SHA256 in brand-assets.json. VS Code and JetBrains builds download and verify that asset before packaging; generated icon files are ignored and are not source assets.

Metadata

Release files for mcp-acemusic 2026.11.17.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-acemusic 2026.11.17.1
File Size Uploaded Provenance Actions
mcp_acemusic-2026.11.17.1.tar.gz 28.1 kB Without provenance Details for mcp_acemusic-2026.11.17.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-acemusic 2026.11.17.1
File Interpreter ABI Platform Actions
mcp_acemusic-2026.11.17.1-py3-none-any.whl Python 3 none any Details for mcp_acemusic-2026.11.17.1-py3-none-any.whl

Total release size: 52.0 kB

Release files / mcp_acemusic-2026.11.17.1.tar.gz

Download URL mcp_acemusic-2026.11.17.1.tar.gz
Size 28.1 kB
Tags Source
SHA-256 checksum
How to use checksums
a101d38b8c88add55053d9c8847f9d8da5f3271c6f78d1b6ba38c0241d78eccb
BLAKE2b-256 checksum
How to use checksums
5e6468cb044d03f03e14145728ceaa387208ad871239a47559878d1ff612d287
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.14.4

Release files / mcp_acemusic-2026.11.17.1-py3-none-any.whl

Download URL mcp_acemusic-2026.11.17.1-py3-none-any.whl
Size 23.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5b5cecbce361c610c31c4676b92d30a8ad446c68c5ac1ebdd47e143ef6815bb4
BLAKE2b-256 checksum
How to use checksums
5df0ecbb9b805d116461aff9794a1aa15a1b307c83f450d5645ad80cf92dedbb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.14.4

Security for mcp-acemusic 2026.11.17.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page