AceDataCloudMCP
<!-- mcp-name: io.github.AceDataCloud/mcp-acedatacloud -->
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 callapi.acedata.cloud.
Tool Reference
Read (always safe)
| Tool | Description |
|---|---|
acedatacloud_get_balance | Remaining credits per subscription, plus a total. |
acedatacloud_list_applications | Your subscriptions with balance/spend. |
acedatacloud_list_services | List or search available services. |
acedatacloud_list_usage | Recent API call records (status, latency, credits). |
acedatacloud_usage_summary | Spend aggregated by API over N days. |
acedatacloud_list_credentials | Your API keys (token values masked). |
acedatacloud_list_orders | Recharge orders. |
acedatacloud_list_platform_tokens | Platform tokens (masked). |
acedatacloud_list_models | Available chat models. |
acedatacloud_list_announcements | Published announcements. |
acedatacloud_list_distributions | Your referral/affiliate status + commission history. |
Catalog & Docs (public — no token needed)
| Tool | Description |
|---|---|
acedatacloud_get_service | One service's detail (type, unit, free_amount, cost), by alias or id. |
acedatacloud_get_pricing | A service's billing unit, free_amount and display pricing. |
acedatacloud_list_apis | API endpoints, optionally scoped to one service (path, method, cost). |
acedatacloud_get_api_spec | One API's OpenAPI definition + cost, by path. |
acedatacloud_list_datasets | Downloadable datasets (price, download/preview URLs). |
acedatacloud_list_integrations | Third-party integrations. |
acedatacloud_search_docs | Full-text search the documentation (alias/title/snippet/url). |
acedatacloud_list_docs | Browse documentation pages. |
acedatacloud_get_doc | Fetch one doc's full content by UUID. |
acedatacloud_list_model_catalog | Rich model catalog (provider, modality, credit pricing). |
acedatacloud_get_model | Look up a model's pricing & capabilities by id/name. |
Write (require confirm=true)
| Tool | Description |
|---|---|
acedatacloud_create_credential | Create an API key on an application. |
acedatacloud_delete_credential | Revoke an API key. |
acedatacloud_create_order | Create a recharge order. |
acedatacloud_pay_order | Create a payment session and return pay_url. |
acedatacloud_create_platform_token | Create a new platform token. |
acedatacloud_delete_platform_token | Revoke a platform token. |
Admin (superuser token)
| Tool | Description |
|---|---|
acedatacloud_create_announcement | Publish a platform announcement (confirm=true). |
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.cloudtoken — 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
| Variable | Default | Description |
|---|---|---|
ACEDATACLOUD_PLATFORM_TOKEN | — | Required. Platform token. |
PLATFORM_API_BASE_URL | https://platform.acedata.cloud | Management API base. |
PLATFORM_REQUEST_TIMEOUT | 30 | Request timeout (seconds). |
LOG_LEVEL | INFO | Logging level. |
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.