{
  "markdown": "# AceDataCloudMCP\n\n<!-- mcp-name: io.github.AceDataCloud/mcp-acedatacloud -->\n\n[![PyPI version](https://img.shields.io/pypi/v/mcp-acedatacloud.svg)](https://pypi.org/project/mcp-acedatacloud/)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for\n**managing your [AceDataCloud](https://platform.acedata.cloud) account** through\nthe [platform management API](https://platform.acedata.cloud/documents/platform-token).\n\nCheck your balance, look up usage and spend, manage API keys, list services,\ncreate and pay recharge orders, manage platform tokens, list models, and (for\nadmins) publish announcements — directly from Claude, VS Code, or any\nMCP-compatible client.\n\n> This is the **management / console** API (`platform.acedata.cloud`) — different\n> from the data-generation MCP servers (Suno, Midjourney, …) that call\n> `api.acedata.cloud`.\n\n<!-- BEGIN GENERATED TOOL REFERENCE -->\n## Tool Reference\n\n### Account reads\n\n| Tool | Description |\n|------|-------------|\n| `acedatacloud_check_frame_ancestor` | Site Domains Frame |\n| `acedatacloud_check_site_domain` | Site Domains Check |\n| `acedatacloud_export_orders` | Export bounded order CSV. |\n| `acedatacloud_export_usage` | Export bounded usage CSV. |\n| `acedatacloud_get_access_request` | Access Detail |\n| `acedatacloud_get_application` | Get one application and service details. |\n| `acedatacloud_get_auto_recharge` | Get auto recharge. |\n| `acedatacloud_get_balance` | Summarize remaining Credits. |\n| `acedatacloud_get_credential` | Get one credential with secrets masked. |\n| `acedatacloud_get_deployment_events` | Get deployment scheduling events. |\n| `acedatacloud_get_deployment_logs` | Get bounded deployment logs. |\n| `acedatacloud_get_deployment_status` | Get live deployment status. |\n| `acedatacloud_get_distribution_rank` | Distribution Rank |\n| `acedatacloud_get_distribution_trend` | Distribution Trend |\n| `acedatacloud_get_invoice` | Get one invoice. |\n| `acedatacloud_get_invoice_download` | Get a signed invoice URL. |\n| `acedatacloud_get_order` | Get one order. |\n| `acedatacloud_get_order_invoice` | Get an order's active invoice. |\n| `acedatacloud_get_order_summary` | Summarize caller orders. |\n| `acedatacloud_get_platform_distribution_rank` | Distribution Platform_Rank |\n| `acedatacloud_get_proxy_usage` | Get proxy usage detail. |\n| `acedatacloud_get_site` | Sites Detail |\n| `acedatacloud_get_site_banner` | Site Banners Detail |\n| `acedatacloud_get_site_capability_override` | Site Capability Detail |\n| `acedatacloud_get_site_document_override` | Site Document Detail |\n| `acedatacloud_get_site_domain` | Site Domains Detail |\n| `acedatacloud_get_site_service_override` | Site Service Detail |\n| `acedatacloud_get_survey` | Surveys Detail |\n| `acedatacloud_get_survey_response` | Surveys Response |\n| `acedatacloud_get_translation_capabilities` | Translations Capabilities |\n| `acedatacloud_get_usage` | Get API usage detail. |\n| `acedatacloud_get_user_info` | Current authenticated account profile. |\n| `acedatacloud_get_wallet_summary` | Coin Wallet Summary |\n| `acedatacloud_get_x402_authorization` | X402 Current |\n| `acedatacloud_list_access_requests` | Access List |\n| `acedatacloud_list_applications` | List account subscriptions. |\n| `acedatacloud_list_auto_recharges` | List auto-recharge configs. |\n| `acedatacloud_list_billing_profiles` | List billing profiles. |\n| `acedatacloud_list_coin_info` | Coin Info |\n| `acedatacloud_list_credentials` | List API credentials with secrets masked. |\n| `acedatacloud_list_distribution_levels` | Distribution Levels |\n| `acedatacloud_list_distributions` | Get referral status. |\n| `acedatacloud_list_email_preferences` | Preferences List |\n| `acedatacloud_list_invoices` | List invoices. |\n| `acedatacloud_list_models` | List OpenAI-compatible chat models. |\n| `acedatacloud_list_orders` | List recharge orders. |\n| `acedatacloud_list_platform_tokens` | List management tokens with values masked. |\n| `acedatacloud_list_proxy_usage` | List proxy usage. |\n| `acedatacloud_list_site_banners` | Site Banners List |\n| `acedatacloud_list_site_capability_overrides` | Site Capability List |\n| `acedatacloud_list_site_document_overrides` | Site Document List |\n| `acedatacloud_list_site_domains` | Site Domains List |\n| `acedatacloud_list_site_service_overrides` | Site Service List |\n| `acedatacloud_list_sites` | Sites List |\n| `acedatacloud_list_surveys` | Surveys List |\n| `acedatacloud_list_usage` | List recent API usage records. |\n| `acedatacloud_list_usage_status_codes` | List usage status codes. |\n| `acedatacloud_preview_invoice` | Preview invoice amount. |\n| `acedatacloud_quote_auto_recharge` | Quote auto recharge. |\n| `acedatacloud_usage_summary` | Aggregate API spend by API. |\n\n### Catalog & docs\n\n| Tool | Description |\n|------|-------------|\n| `acedatacloud_get_api_spec` | Get one API's OpenAPI definition by path. |\n| `acedatacloud_get_doc` | Fetch one documentation page by UUID. |\n| `acedatacloud_get_model` | Find models by ID or name. |\n| `acedatacloud_get_pricing` | Get one service's display pricing. |\n| `acedatacloud_get_service` | Get one service by UUID or alias. |\n| `acedatacloud_list_announcements` | List published announcements. |\n| `acedatacloud_list_apis` | List API endpoints and billing metadata. |\n| `acedatacloud_list_datasets` | List downloadable datasets. |\n| `acedatacloud_list_docs` | Browse documentation pages. |\n| `acedatacloud_list_integrations` | List platform integrations. |\n| `acedatacloud_list_model_catalog` | List rich model metadata and pricing. |\n| `acedatacloud_list_services` | List or search available services. |\n| `acedatacloud_search_docs` | Search public documentation. |\n\n### Writes\n\n| Tool | Description |\n|------|-------------|\n| `acedatacloud_apply_invoice` | Apply for an invoice. |\n| `acedatacloud_cancel_access_request` | Access Cancel |\n| `acedatacloud_cancel_invoice` | Cancel an invoice. |\n| `acedatacloud_confirm_auto_recharge_setup` | Confirm saved card setup. |\n| `acedatacloud_confirm_wallet_challenge` | Coin Wallet Confirm |\n| `acedatacloud_confirm_x402_authorization` | X402 Confirm |\n| `acedatacloud_confirm_x402_revocation` | X402 Revoke |\n| `acedatacloud_control_deployment` | Start a stopped deployment. |\n| `acedatacloud_create_access_request` | Access Create |\n| `acedatacloud_create_application` | Create an application subscription. |\n| `acedatacloud_create_auto_recharge` | Create auto recharge. |\n| `acedatacloud_create_credential` | Create an API credential. |\n| `acedatacloud_create_order` | Create a recharge order. |\n| `acedatacloud_create_platform_token` | Create a management token. |\n| `acedatacloud_create_site_banner` | Site Banners Create |\n| `acedatacloud_create_site_capability_override` | Site Capability Create |\n| `acedatacloud_create_site_document_override` | Site Document Create |\n| `acedatacloud_create_site_domain` | Site Domains Create |\n| `acedatacloud_create_site_service_override` | Site Service Create |\n| `acedatacloud_create_wallet_challenge` | Coin Wallet Challenge |\n| `acedatacloud_delete_auto_recharge` | Delete auto recharge. |\n| `acedatacloud_delete_credential` | Revoke an API credential. |\n| `acedatacloud_delete_platform_token` | Revoke a management token. |\n| `acedatacloud_delete_site_banner` | Site Banners Delete |\n| `acedatacloud_delete_site_capability_override` | Site Capability Delete |\n| `acedatacloud_delete_site_document_override` | Site Document Delete |\n| `acedatacloud_delete_site_domain` | Site Domains Delete |\n| `acedatacloud_delete_site_service_override` | Site Service Delete |\n| `acedatacloud_deploy_application` | Start or redeploy an application workload. |\n| `acedatacloud_disable_auto_recharge` | Disable auto recharge. |\n| `acedatacloud_disable_translation` | Translations Disable |\n| `acedatacloud_disable_x402_authorization` | X402 Disable |\n| `acedatacloud_enable_translation` | Translations Enable |\n| `acedatacloud_enable_x402_authorization` | X402 Enable |\n| `acedatacloud_initialize_distribution` | Distribution Initialize |\n| `acedatacloud_initialize_site` | Sites Initialize |\n| `acedatacloud_pay_order` | Create an order payment session. |\n| `acedatacloud_refresh_coin_info` | Coin Refresh |\n| `acedatacloud_refresh_order` | Refresh payment state. |\n| `acedatacloud_report_content` | Reports Create |\n| `acedatacloud_rotate_credential` | Rotate and disclose a credential secret once. |\n| `acedatacloud_save_deployment_config` | Save a deployment configuration draft. |\n| `acedatacloud_set_site_menu_translation` | Sites Menu Translation |\n| `acedatacloud_setup_auto_recharge` | Create card setup state. |\n| `acedatacloud_setup_x402_authorization` | X402 Setup |\n| `acedatacloud_submit_survey` | Surveys Submit |\n| `acedatacloud_teardown_deployment` | Destroy a workload and delete its application. |\n| `acedatacloud_update_application_balance_policy` | Update global-balance fallback policy. |\n| `acedatacloud_update_auto_recharge` | Update auto recharge. |\n| `acedatacloud_update_credential` | Update credential limits and API scope. |\n| `acedatacloud_update_email_preference` | Preferences Update |\n| `acedatacloud_update_site` | Sites Update |\n| `acedatacloud_update_site_banner` | Site Banners Update |\n| `acedatacloud_update_site_capability_override` | Site Capability Update |\n| `acedatacloud_update_site_document_override` | Site Document Update |\n| `acedatacloud_update_site_domain` | Site Domains Update |\n| `acedatacloud_update_site_service_override` | Site Service Update |\n| `acedatacloud_verify_apple_order` | Verify and fulfill Apple IAP. |\n| `acedatacloud_verify_site_domain` | Site Domains Verify |\n\n### Admin\n\n| Tool | Description |\n|------|-------------|\n| `acedatacloud_create_announcement` | Publish a platform announcement. |\n\nCalling a write/admin tool **without** `confirm=true` returns a redacted\ndry-run preview and performs no HTTP request.\n\n<!-- END GENERATED TOOL REFERENCE -->\n\n## Quick Start\n\n### 1. Get a platform token\n\nCreate one at [platform.acedata.cloud/console/platform-tokens](https://platform.acedata.cloud/console/platform-tokens).\nIt starts with `platform-` and never expires.\n\n> Use a **platform token**, not the per-service `api.acedata.cloud` token — the\n> latter returns 401 against the management API.\n\n### 2. Install\n\n```bash\npip install mcp-acedatacloud\n```\n\n### 3. Configure your client\n\n**Claude Desktop / VS Code (stdio):**\n\n```json\n{\n  \"mcpServers\": {\n    \"acedatacloud\": {\n      \"command\": \"mcp-acedatacloud\",\n      \"env\": {\n        \"ACEDATACLOUD_PLATFORM_TOKEN\": \"platform-v1-xxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n**Hosted (HTTP) — token per request:**\n\n```json\n{\n  \"mcpServers\": {\n    \"acedatacloud\": {\n      \"url\": \"https://mcp.acedata.cloud/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer platform-v1-xxxxxxxx\" }\n    }\n  }\n}\n```\n\n## Example prompts\n\n- \"How many credits do I have left?\"\n- \"What did I spend on Suno in the last 7 days?\"\n- \"List my API keys and show which ones have a spend cap.\"\n- \"Create a new API key on application `<id>` named ci.\" → previews, then run with confirm.\n- \"Top up application `<id>` with package `<id>` and give me the Stripe pay link.\"\n\n## Configuration\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `ACEDATACLOUD_PLATFORM_TOKEN` | — | **Required.** Platform token. |\n| `PLATFORM_API_BASE_URL` | `https://platform.acedata.cloud` | Management API base. |\n| `PLATFORM_REQUEST_TIMEOUT` | `30` | Request timeout (seconds). |\n| `LOG_LEVEL` | `INFO` | Logging level. |\n\n## Development\n\n```bash\npip install -e \".[dev,test,http]\"\npytest -m \"not integration\"      # unit tests\nruff check .                      # lint\nmypy core tools                   # type-check\nmcp-acedatacloud --transport http --port 8000\n```\n\n## Notes\n\n- Amounts (`remaining_amount`, `used_amount`, totals) are in **Credits**, not USD.\n- Newly created credential/platform tokens are returned in full **only once** —\n  store them immediately.\n- Credential rotation = delete + recreate (no in-place rotate endpoint).\n- Announcement tools require a **superuser** token.\n\n## Documentation\n\n<!-- canonical-documentation -->\n[Documentation](https://platform.acedata.cloud/documents/acedatacloud-mcp)\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 12549,
  "sha": "45058c3e27d5055c0aa156a55489761dca2cd6906dde6af9b182e4ef23715e63",
  "repo_slug": "acedatacloud/acedatacloudmcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_acedatacloud_mcp_acedatacloud_067a55d0/readme"
}