io.github.AceDataCloud/mcp-acedatacloud

AceDataCloudMCP

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

Account reads

Tool	Description
acedatacloud_check_frame_ancestor	Site Domains Frame
acedatacloud_check_site_domain	Site Domains Check
acedatacloud_export_orders	Export bounded order CSV.
acedatacloud_export_usage	Export bounded usage CSV.
acedatacloud_get_access_request	Access Detail
acedatacloud_get_application	Get one application and service details.
acedatacloud_get_auto_recharge	Get auto recharge.
acedatacloud_get_balance	Summarize remaining Credits.
acedatacloud_get_credential	Get one credential with secrets masked.
acedatacloud_get_deployment_events	Get deployment scheduling events.
acedatacloud_get_deployment_logs	Get bounded deployment logs.
acedatacloud_get_deployment_status	Get live deployment status.
acedatacloud_get_distribution_rank	Distribution Rank
acedatacloud_get_distribution_trend	Distribution Trend
acedatacloud_get_invoice	Get one invoice.
acedatacloud_get_invoice_download	Get a signed invoice URL.
acedatacloud_get_order	Get one order.
acedatacloud_get_order_invoice	Get an order's active invoice.
acedatacloud_get_order_summary	Summarize caller orders.
acedatacloud_get_platform_distribution_rank	Distribution Platform_Rank
acedatacloud_get_proxy_usage	Get proxy usage detail.
acedatacloud_get_site	Sites Detail
acedatacloud_get_site_banner	Site Banners Detail
acedatacloud_get_site_capability_override	Site Capability Detail
acedatacloud_get_site_document_override	Site Document Detail
acedatacloud_get_site_domain	Site Domains Detail
acedatacloud_get_site_service_override	Site Service Detail
acedatacloud_get_survey	Surveys Detail
acedatacloud_get_survey_response	Surveys Response
acedatacloud_get_translation_capabilities	Translations Capabilities
acedatacloud_get_usage	Get API usage detail.
acedatacloud_get_user_info	Current authenticated account profile.
acedatacloud_get_wallet_summary	Coin Wallet Summary
acedatacloud_get_x402_authorization	X402 Current
acedatacloud_list_access_requests	Access List
acedatacloud_list_applications	List account subscriptions.
acedatacloud_list_auto_recharges	List auto-recharge configs.
acedatacloud_list_billing_profiles	List billing profiles.
acedatacloud_list_coin_info	Coin Info
acedatacloud_list_credentials	List API credentials with secrets masked.
acedatacloud_list_distribution_levels	Distribution Levels
acedatacloud_list_distributions	Get referral status.
acedatacloud_list_email_preferences	Preferences List
acedatacloud_list_invoices	List invoices.
acedatacloud_list_models	List OpenAI-compatible chat models.
acedatacloud_list_orders	List recharge orders.
acedatacloud_list_platform_tokens	List management tokens with values masked.
acedatacloud_list_proxy_usage	List proxy usage.
acedatacloud_list_site_banners	Site Banners List
acedatacloud_list_site_capability_overrides	Site Capability List
acedatacloud_list_site_document_overrides	Site Document List
acedatacloud_list_site_domains	Site Domains List
acedatacloud_list_site_service_overrides	Site Service List
acedatacloud_list_sites	Sites List
acedatacloud_list_surveys	Surveys List
acedatacloud_list_usage	List recent API usage records.
acedatacloud_list_usage_status_codes	List usage status codes.
acedatacloud_preview_invoice	Preview invoice amount.
acedatacloud_quote_auto_recharge	Quote auto recharge.
acedatacloud_usage_summary	Aggregate API spend by API.

Catalog & docs

Tool	Description
acedatacloud_get_api_spec	Get one API's OpenAPI definition by path.
acedatacloud_get_doc	Fetch one documentation page by UUID.
acedatacloud_get_model	Find models by ID or name.
acedatacloud_get_pricing	Get one service's display pricing.
acedatacloud_get_service	Get one service by UUID or alias.
acedatacloud_list_announcements	List published announcements.
acedatacloud_list_apis	List API endpoints and billing metadata.
acedatacloud_list_datasets	List downloadable datasets.
acedatacloud_list_docs	Browse documentation pages.
acedatacloud_list_integrations	List platform integrations.
acedatacloud_list_model_catalog	List rich model metadata and pricing.
acedatacloud_list_services	List or search available services.
acedatacloud_search_docs	Search public documentation.

Writes

Tool	Description
acedatacloud_apply_invoice	Apply for an invoice.
acedatacloud_cancel_access_request	Access Cancel
acedatacloud_cancel_invoice	Cancel an invoice.
acedatacloud_confirm_auto_recharge_setup	Confirm saved card setup.
acedatacloud_confirm_wallet_challenge	Coin Wallet Confirm
acedatacloud_confirm_x402_authorization	X402 Confirm
acedatacloud_confirm_x402_revocation	X402 Revoke
acedatacloud_control_deployment	Start a stopped deployment.
acedatacloud_create_access_request	Access Create
acedatacloud_create_application	Create an application subscription.
acedatacloud_create_auto_recharge	Create auto recharge.
acedatacloud_create_credential	Create an API credential.
acedatacloud_create_order	Create a recharge order.
acedatacloud_create_platform_token	Create a management token.
acedatacloud_create_site_banner	Site Banners Create
acedatacloud_create_site_capability_override	Site Capability Create
acedatacloud_create_site_document_override	Site Document Create
acedatacloud_create_site_domain	Site Domains Create
acedatacloud_create_site_service_override	Site Service Create
acedatacloud_create_wallet_challenge	Coin Wallet Challenge
acedatacloud_delete_auto_recharge	Delete auto recharge.
acedatacloud_delete_credential	Revoke an API credential.
acedatacloud_delete_platform_token	Revoke a management token.
acedatacloud_delete_site_banner	Site Banners Delete
acedatacloud_delete_site_capability_override	Site Capability Delete
acedatacloud_delete_site_document_override	Site Document Delete
acedatacloud_delete_site_domain	Site Domains Delete
acedatacloud_delete_site_service_override	Site Service Delete
acedatacloud_deploy_application	Start or redeploy an application workload.
acedatacloud_disable_auto_recharge	Disable auto recharge.
acedatacloud_disable_translation	Translations Disable
acedatacloud_disable_x402_authorization	X402 Disable
acedatacloud_enable_translation	Translations Enable
acedatacloud_enable_x402_authorization	X402 Enable
acedatacloud_initialize_distribution	Distribution Initialize
acedatacloud_initialize_site	Sites Initialize
acedatacloud_pay_order	Create an order payment session.
acedatacloud_refresh_coin_info	Coin Refresh
acedatacloud_refresh_order	Refresh payment state.
acedatacloud_report_content	Reports Create
acedatacloud_rotate_credential	Rotate and disclose a credential secret once.
acedatacloud_save_deployment_config	Save a deployment configuration draft.
acedatacloud_set_site_menu_translation	Sites Menu Translation
acedatacloud_setup_auto_recharge	Create card setup state.
acedatacloud_setup_x402_authorization	X402 Setup
acedatacloud_submit_survey	Surveys Submit
acedatacloud_teardown_deployment	Destroy a workload and delete its application.
acedatacloud_update_application_balance_policy	Update global-balance fallback policy.
acedatacloud_update_auto_recharge	Update auto recharge.
acedatacloud_update_credential	Update credential limits and API scope.
acedatacloud_update_email_preference	Preferences Update
acedatacloud_update_site	Sites Update
acedatacloud_update_site_banner	Site Banners Update
acedatacloud_update_site_capability_override	Site Capability Update
acedatacloud_update_site_document_override	Site Document Update
acedatacloud_update_site_domain	Site Domains Update
acedatacloud_update_site_service_override	Site Service Update
acedatacloud_verify_apple_order	Verify and fulfill Apple IAP.
acedatacloud_verify_site_domain	Site Domains Verify

Admin

Tool	Description
acedatacloud_create_announcement	Publish a platform announcement.

Calling a write/admin tool without confirm=true returns a redacted dry-run preview and performs no HTTP request.

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

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.

Documentation

Documentation

License

MIT — see LICENSE.