Acedatacloud

PyPI version Python 3.10+ License: MIT MCP

A Model Context Protocol (MCP) server for managing your AceDataCloud account through the platform management API.

Check your balance, look up usage and spend, manage API keys, list services, create and pay recharge orders, manage platform tokens, list models, and (for admins) publish announcements — directly from Claude, VS Code, or any MCP-compatible client.

This is the management / console API (platform.acedata.cloud) — different from the data-generation MCP servers (Suno, Midjourney, …) that call api.acedata.cloud.

Tool Reference

Read (always safe)

Catalog & Docs (public — no token needed)

Write (require confirm=true)

Admin (superuser token)

Calling a write/admin tool without confirm=true returns a dry-run preview and changes nothing.

Quick Start

1. Get a platform token

Create one at platform.acedata.cloud/console/platform-tokens. It starts with platform- and never expires.

Use a platform token, not the per-service api.acedata.cloud token — the latter returns 401 against the management API.

2. Install

pip install mcp-acedatacloud

3. Configure your client

Claude Desktop / VS Code (stdio):

{
  "mcpServers": {
    "acedatacloud": {
      "command": "mcp-acedatacloud",
      "env": {
        "ACEDATACLOUD_PLATFORM_TOKEN": "platform-v1-xxxxxxxx"
      }
    }
  }
}

Hosted (HTTP) — token per request:

{
  "mcpServers": {
    "acedatacloud": {
      "url": "https://mcp.acedata.cloud/mcp",
      "headers": { "Authorization": "Bearer platform-v1-xxxxxxxx" }
    }
  }
}

Example prompts

• "How many credits do I have left?"
• "What did I spend on Suno in the last 7 days?"
• "List my API keys and show which ones have a spend cap."
• "Create a new API key on application <id> named ci." → previews, then run with confirm.
• "Top up application <id> with package <id> and give me the Stripe pay link."

Configuration

Development

pip install -e ".[dev,test,http]"
pytest -m "not integration"      # unit tests
ruff check .                      # lint
mypy core tools                   # type-check
mcp-acedatacloud --transport http --port 8000

Notes

• Amounts (remaining_amount, used_amount, totals) are in Credits, not USD.
• Newly created credential/platform tokens are returned in full only once — store them immediately.
• Credential rotation = delete + recreate (no in-place rotate endpoint).
• Announcement tools require a superuser token.

License

MIT — see LICENSE.