ACE Music MCP
Create songs from an idea or custom lyrics, generate lyrics, and retrieve the original task through Ace Data Cloud.
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.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_acemusic-2026.11.17.2.tar.gz | 28.2 kB | Without provenance | Details for mcp_acemusic-2026.11.17.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_acemusic-2026.11.17.2-py3-none-any.whl | Python 3 | none | any | Details for mcp_acemusic-2026.11.17.2-py3-none-any.whl |
Total release size: 52.2 kB
Release files / mcp_acemusic-2026.11.17.2.tar.gz
| Download URL | mcp_acemusic-2026.11.17.2.tar.gz |
|---|---|
| Size | 28.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0a382436367de0a86e7ac278bf04660db35df922c042f3d40a311fc4748a9225
|
|
BLAKE2b-256 checksum How to use checksums |
dfd400238e1b3e79abb1586f973438c4aaa1ce6df9afeda732c5f51d69536730
|
| 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.2-py3-none-any.whl
| Download URL | mcp_acemusic-2026.11.17.2-py3-none-any.whl |
|---|---|
| Size | 23.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a1eb4bbd911b00e967d038c975443adf38f6fbc019ed384acc2f35b72c4aa56a
|
|
BLAKE2b-256 checksum How to use checksums |
f6cb0ad164f7440ad87bd4e951fc47b1b93a6179ccab23ca339ca397e16c1796
|
| 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.2
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.