arvancai
Provides guidance and workflow support for obtaining Let's Encrypt TLS certificates using DNS-01 validation with acme.sh, integrated with ArvanCloud DNS.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@arvancai list my ArvanCloud cloud servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
arvancai
ArvanCloud MCP server + Agent Skill — manage ArvanCloud from any MCP-capable agent/IDE
(Cursor, Windsurf, Claude Desktop/Code, Codex, OpenCode, and more).
npm install -g arvancaiRepository: https://github.com/0xamirreza/arvancai
npm: https://www.npmjs.com/package/arvancai
Version: 0.6.2
Requires Node.js ≥ 20 and an ArvanCloud Machine User API key:
https://docs.arvancloud.ir/en/accounts/iam/machine-user
Any Agent / IDE ──► Skill (workflows) + MCP tools
│
▼
arvancai (stdio MCP server)
│ │
▼ ▼
napi / OpenAPI (local) mcp.arvancloud.ir (bridged)
CDN · DNS · IaaS · … Cloud Logs mgmt (+ future toolsets)1) Install (auto-wires clients)
export ARVANCLOUD_API_KEY="your-machine-user-key" # optional but recommended
npm install -g arvancaiOn global install, arvancai automatically:
merges itself into Cursor
~/.cursor/mcp.json(keeps your other MCP servers)copies the Agent Skill to
~/.cursor/skills/arvancai/wires Windsurf / Claude Desktop / Codex / OpenCode when their config directories already exist
Re-run anytime (e.g. after setting the API key):
export ARVANCLOUD_API_KEY="your-machine-user-key"
arvancai setupForce every known host path (even if the app is not installed yet):
arvancai setup --allSkip auto-setup during install:
ARVANCAI_SKIP_SETUP=1 npm install -g arvancaiCheck CLI (this must print help — it must not hang):
arvancai --help
which arvancaiThen reload Cursor (or reopen MCP settings) so arvancai shows up under MCP and Skills.
With no arguments, arvancai speaks MCP over stdio (for IDEs). Do not use it as a chat CLI.
Related MCP server: meshive-mcp
2) API key & extras
export ARVANCLOUD_API_KEY="your-machine-user-key"The env may be a bare UUID or already prefixed (Apikey … / apikey … / Bearer …).
Local tools always send Authorization: Apikey <uuid>.
The official MCP bridge sends Arvancloud-Api-Key: apikey <uuid>.
Optional Object Storage (S3 HMAC):
export ARVANCLOUD_S3_ACCESS_KEY_ID="..."
export ARVANCLOUD_S3_SECRET_ACCESS_KEY="..."Useful flags:
# Inventory / diagnosis only — blocks POST/PUT/PATCH/DELETE + S3 writes + bridged write tools
export ARVANCLOUD_READ_ONLY=1
# Disable hosted MCP bridge (Cloud Logs management)
export ARVANCLOUD_OFFICIAL_MCP=0
# Restrict bridged toolsets (default: all)
export ARVANCLOUD_OFFICIAL_MCP_TOOLSETS=logsSee .env.example. If setup ran without a key, configs keep <MU-KEY> until you re-run arvancai setup with the env set.
3) Manual MCP (optional)
Auto-setup is enough for most users. Manual shape (also under examples/):
{
"mcpServers": {
"arvancai": {
"command": "arvancai",
"env": {
"ARVANCLOUD_API_KEY": "<MU-KEY>"
}
}
}
}You do not need a separate arvancloud remote MCP entry for Logs — arvancai bridges mcp.arvancloud.ir by default. Official docs: developer-tools/mcp.
GUI apps that lack your shell PATH are fine: arvancai setup writes an absolute node + bin/arvancai.js path.
4) Skill vs MCP
Piece | Role | Portability |
MCP ( | Tools / resources / prompts over the MCP protocol | Works on all MCP clients |
Skill ( | Agent playbook (tool choice, TLS/acme.sh, Iran DNS gotchas, safety) | Best on Cursor-style Agent Skills; elsewhere paste/link as project instructions |
MCP alone is enough for tool calling. Skill improves agent behavior where the host supports skills/rules.
Coverage (short)
Official portal: https://www.arvancloud.ir/fa/dev/api
Area | Status |
CDN / DNS / Security / reports | Yes (+ |
DNS zone import/export |
|
Cloud Server (ECC) / partial DBaaS | Yes |
IaaS region quota |
|
Object Storage (S3 + management API) | Yes |
VOD / LIVE / Video Ads | Yes |
Edge Computing | Yes |
Cloud Container (CaaS) | Yes |
AI-as-a-Service | Yes |
CloudLogs ingest |
|
CloudLogs management (spaces / sinks / forwarders) | Official hosted MCP bridge ( |
Let's Encrypt DNS-01 (acme.sh) | Documented in Skill ( |
Drive / Accounts / Changelog | No public REST OpenAPI |
Details: ARCHITECTURE.md, docs/bridge-official-mcp.md, CHANGELOG.md, docs/, skill/SKILL.md.
Security
Never commit API keys.
Prefer READ tools first; destructive tools need exact IDs.
Use
ARVANCLOUD_READ_ONLY=1for audit-only agents.See SECURITY.md.
Local development
git clone https://github.com/0xamirreza/arvancai.git
cd arvancai
npm install
npm run build
npm test
export ARVANCLOUD_API_KEY=...
npm start
# wire this checkout into clients:
ARVANCAI_AUTO_SETUP=1 node scripts/postinstall.mjs
# or:
node dist/index.js setupSee DEVELOPMENT.md.
License
MIT
Available Tools
130 toolscheck_domain_nameserversCheck domain nameserversBRead-only
[READ] Check whether domain NS keys indicate activation. Official: GET /cdn/4.0/domains/{domain}/ns-keys/check
Inputs: domain (required).
create_bucketCreate Object Storage bucketC
[WRITE] S3 CreateBucket. Official API Usage curl + SDK create-bucket docs. ACL may be private|public-read per SDK sample.
Inputs: bucket (required), acl.
create_databaseCreate DBaaS instanceB
[WRITE] OpenAPI IaaS 1.0 CreateDatabaseRequest: POST /regions/{region}/databases with datastoreType + flavorRef from list_database_flavors — do not invent values.
Inputs: region (required), flavorRef (required), datastoreType (required).
create_dns_recordCreate DNS recordA
[WRITE] Create a DNS record. Official: POST /cdn/4.0/domains/{domain}/dns-records. value shape depends on type (see docs/adding-records). Inspect current records before creating duplicates.
Inputs: name (required), type (required), value (required), domain (required), +7 more.
create_edge_routeCreate Edge Computing routeB
[WRITE] OpenAPI Route schema: POST /edge-computes/{edgeComputeId}/routes — required domain, url, status (active|inactive).
Inputs: url (required), domain (required), status (required), edge_compute_id (required).
create_firewall_ruleCreate CDN firewall ruleC
[WRITE] POST /domains/{domain}/firewall/rules. Official FA samples: name, note, is_enabled, action (allow|deny|challenge|bypass), action_details, filter_expr.
Inputs: name (required), action (required), domain (required), filter_expr (required), +3 more.
create_rate_limit_ruleCreate rate-limit ruleC
[WRITE] POST /domains/{domain}/rate-limit/rules. Official samples include url_pattern, rate, time_duration, is_enabled, description, exclude_sources, burst, block_duration, allowed_methods, action, action_details.
Inputs: rate (required), domain (required), url_pattern (required), time_duration (required), +8 more.
create_serverCreate Cloud Server instanceA
[WRITE] Offline FA API Usage + OpenAPI IaaS 1.0: POST /ecc/v1/regions/{region}/servers with name, network_id, flavor_id, image_id, security_groups[{name}], ssh_key, key_name, count. Obtain IDs from list tools — never invent UUIDs.
Inputs: name (required), region (required), image_id (required), flavor_id (required), +5 more.
create_troubleshootCreate CDN troubleshootA
[WRITE] Start a new troubleshoot for a domain. Official: POST /domains/{domain}/troubleshoots. Body fields beyond empty POST are UNKNOWN / NOT DOCUMENTED in product samples — send empty object unless you have verified fields.
Inputs: domain (required), body.
create_vod_channelCreate VOD channelC
[WRITE] Official FA/EN API Usage + OpenAPI: POST /vod/2.0/channels with documented fields (title, description, secure_link_*, ads_enabled, present_type, campaign_id).
Inputs: title (required), ads_enabled, campaign_id, description, +4 more.
delete_bucketDelete Object Storage bucketADestructive
[DESTRUCTIVE] S3 DeleteBucket (FA SDK delete-bucket). Bucket must be empty per product docs.
Inputs: bucket (required).
delete_dns_recordDelete DNS recordADestructive
[DESTRUCTIVE] Permanently delete one DNS record. Official: DELETE /cdn/4.0/domains/{domain}/dns-records/{id}. Requires exact record_id — never infer or delete multiple.
Inputs: domain (required), record_id (required).
delete_edge_routeDelete Edge Computing routeCDestructive
[DESTRUCTIVE] OpenAPI: DELETE /edge-computes/{edgeComputeId}/routes/{route_id}
Inputs: route_id (required), edge_compute_id (required).
delete_firewall_ruleDelete CDN firewall ruleBDestructive
[DESTRUCTIVE] DELETE /domains/{domain}/firewall/rules/{id}. Requires exact rule_id — never delete multiple.
Inputs: domain (required), rule_id (required).
delete_objectDelete objectCDestructive
[DESTRUCTIVE] S3 DeleteObject (FA SDK delete-object). Requires exact bucket+key.
Inputs: key (required), bucket (required).
delete_rate_limit_ruleDelete rate-limit ruleCDestructive
[DESTRUCTIVE] DELETE /domains/{domain}/rate-limit/rules/{id}
Inputs: domain (required), rule_id (required).
deploy_edge_computeDeploy Edge ComputeC
[WRITE] OpenAPI: POST /edge-computes/deploy — required name, bundled_code; optional namespace, tag.
Inputs: name (required), bundled_code (required), tag, namespace.
get_accelerationGet CDN acceleration settingsCRead-only
[READ] GET /domains/{domain}/acceleration (CDN Go SDK). Offline FA documents PATCH bodies for CSS/JS optimization.
Inputs: domain (required).
get_ai_endpointGet AI endpointCRead-only
[READ] OpenAPI: GET /endpoints/{endpoint_id}
Inputs: endpoint_id (required).
get_ai_modelGet AI modelCRead-only
[READ] OpenAPI: GET /models/{model_id}
Inputs: model_id (required).
get_bucket_metricsGet Object Storage bucket metricsCRead-only
[READ] OpenAPI storage/1.0.0 + FA metrics: GET https://storage.arvanapis.ir/v1/buckets/{bucketName}/metrics
Inputs: bucket (required).
get_caas_deploymentGet CaaS deploymentCRead-only
[READ] OpenAPI: GET /apis/apps/v1/namespaces/{namespace}/deployments/{name}
Inputs: name (required), zone (required), namespace (required).
get_caas_podGet CaaS podCRead-only
[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/pods/{name}
Inputs: name (required), zone (required), namespace (required).
get_caas_pod_logsGet CaaS pod logsDRead-only
[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/pods/{name}/log
Inputs: name (required), zone (required), namespace (required).
get_caching_settingsGet CDN caching settingsARead-only
[READ] Get caching settings for a domain. Official: GET /cdn/4.0/domains/{domain}/caching
Inputs: domain (required).
get_cdn_geo_reportCDN geo traffic map reportCRead-only
[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/traffics/map?period=
Inputs: domain (required), period.
get_cdn_high_request_ipsCDN high-request IPs reportBRead-only
[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/high-request-ips?period= (Professional+ plans)
Inputs: domain (required), period.
get_cdn_response_time_reportCDN response-time reportCRead-only
[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/response-time?period=
Inputs: domain (required), period.
get_cdn_status_reportCDN HTTP status-code reportCRead-only
[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/status?period=
Inputs: domain (required), period.
get_cdn_traffic_reportCDN traffic/requests reportCRead-only
[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/traffics?period=
Inputs: domain (required), period.
get_cdn_visitors_reportCDN unique visitors reportCRead-only
[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/visitors?period=
Inputs: domain (required), period.
get_dns_recordGet DNS recordARead-only
[READ] Get one DNS record by id. Official: GET /cdn/4.0/domains/{domain}/dns-records/{id}. Never invent record_id — obtain from list_dns_records.
Inputs: domain (required), record_id (required).
get_dnssecGet DNSSEC statusBRead-only
[READ] Get DNSSEC status. Official CDN API: GET /domains/{domain}/dns-records/dnssec (CDN Go SDK). Offline FA also documents update actions.
Inputs: domain (required).
get_domainGet CDN domainBRead-only
[READ] Get information for one CDN domain. Official: GET /cdn/4.0/domains/{domain}
Inputs: domain (required).
get_edge_computeGet Edge ComputeDRead-only
[READ] OpenAPI: GET /edge-computes/{edgeComputeId}
Inputs: edge_compute_id (required).
get_edge_namespaceGet Edge namespace settingsCRead-only
[READ] OpenAPI: GET /namespace
Inputs: no named parameters.
get_firewall_ruleGet CDN firewall ruleDRead-only
[READ] GET /domains/{domain}/firewall/rules/{id}
Inputs: domain (required), rule_id (required).
get_firewall_settingsGet CDN firewall settingsCRead-only
[READ] GET /domains/{domain}/firewall/settings (CDN Go SDK; FA firewall API table).
Inputs: domain (required).
get_latest_troubleshootGet latest CDN troubleshootBRead-only
[READ] Get the latest troubleshoot for a domain. Official: GET /domains/{domain}/troubleshoots/latest
Inputs: domain (required).
get_live_domainGet LIVE domain settingsCRead-only
[READ] OpenAPI: GET /domain
Inputs: no named parameters.
get_live_streamGet LIVE streamCRead-only
[READ] OpenAPI: GET /streams/{stream}
Inputs: stream_id (required).
get_object_textDownload object as text (size-capped)ARead-only
[READ] S3 GetObject for text-ish content. Caps at max_bytes (default 256KiB) to avoid dumping large binaries into the agent context. Official API Usage getObject.
Inputs: key (required), bucket (required), max_bytes.
get_rate_limit_ruleGet rate-limit ruleCRead-only
[READ] GET /domains/{domain}/rate-limit/rules/{id}
Inputs: domain (required), rule_id (required).
get_rate_limit_settingsGet rate-limit settingsCRead-only
[READ] GET /domains/{domain}/rate-limit/settings (CDN Go SDK; EN/FA rate-limit API table).
Inputs: domain (required).
get_serverGet Cloud Server instanceCRead-only
[READ] OpenAPI IaaS 1.0: GET /regions/{region}/servers/{id} (ecc/v1).
Inputs: region (required), server_id (required).
get_ssl_settingsGet SSL/HTTPS settingsBRead-only
[READ] Get domain SSL settings. Official: GET /cdn/4.0/domains/{domain}/ssl
Inputs: domain (required).
get_storage_reportGet Object Storage usage reportCRead-only
[READ] OpenAPI: GET /v1/reports/storage on storage.arvanapis.ir
Inputs: no named parameters.
get_vads_campaignGet Video Ads campaignDRead-only
[READ] OpenAPI: GET /campaigns/{campaign}
Inputs: campaign_id (required).
get_vads_channelGet Video Ads channelCRead-only
[READ] OpenAPI: GET /channels/{channel}
Inputs: channel_id (required).
get_vads_domainGet Video Ads domainCRead-only
[READ] OpenAPI: GET /domain
Inputs: no named parameters.
get_vod_channelGet VOD channelCRead-only
[READ] OpenAPI Arvan VOD 2.0: GET /channels/{channel}
Inputs: channel_id (required).
get_vod_domainGet VOD domain settingsCRead-only
[READ] OpenAPI: GET /domain
Inputs: no named parameters.
get_vod_videoGet VOD videoDRead-only
[READ] OpenAPI: GET /videos/{video}
Inputs: video_id (required).
head_bucketCheck bucket existsCRead-only
[READ] S3 HeadBucket (FA SDK head-bucket).
Inputs: bucket (required).
head_objectHead object metadataDRead-only
[READ] S3 HeadObject (FA SDK head-object).
Inputs: key (required), bucket (required).
invoke_aiaas_apiInvoke AI-as-a-Service OpenAPIADestructive
[OPENAPI] Full ai-ml-backend 1.0 on /ai/v1. Paths may be /endpoints or /ai/v1/datasets — /ai/v1 prefix is stripped when present. Allowlist: 43 ops from aiaas-1.0.json (ai-ml-backend 1.0). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
invoke_caas_apiInvoke CaaS / Cloud Container OpenAPIBDestructive
[OPENAPI] Full Arvan CaaS 1.25 (Kubernetes-style) on caas/v2/zones/{zone}. Pass concrete path e.g. /api/v1/namespaces/my-ns/pods. Allowlist: 299 ops from paas-1.25.json (Arvan CaaS 1.25). Rejects unknown paths — does not invent APIs.
Inputs: path (required), zone (required), method (required), body, +1 more.
invoke_cdn_apiInvoke CDN OpenAPI operationADestructive
[OPENAPI] Call any path from CDN OpenAPI 4.181.3 on napi.../cdn/4.0. Prefer named CDN tools when available. Allowlist: 238 ops from cdn-4.0.yml (ArvanCloud CDN Services 4.181.3). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
invoke_edge_apiInvoke Edge Computing OpenAPIBDestructive
[OPENAPI] Full Edge Computing 1.8.1 surface on edge-computing/v1. Allowlist: 25 ops from ec-1.0.yaml (Edge Computing 1.8.1). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
invoke_iaas_v1_apiInvoke IaaS OpenAPI v1 (ecc/v1)ADestructive
[OPENAPI] Call napi.../ecc/v1 paths from iaas-1.0.json (servers, networks, float-ips, databases, …). Use concrete paths e.g. /regions/ir-thr-c2/servers. Allowlist: 136 ops from iaas-1.0.json (Arvancloud IaaS API 1.0.0). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
invoke_iaas_v3_apiInvoke IaaS OpenAPI v3BDestructive
[OPENAPI] Call ecc.{region}.arvanapis.ir/v3 paths from iaas-3.0.0.yaml (servers, volumes, firewalls, networks, …). Allowlist: 45 ops from iaas-3.0.0.yaml (Arvancloud IaaS API Documentation v3.0.1). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), region (required), body, +1 more.
invoke_live_apiInvoke LIVE OpenAPIBDestructive
[OPENAPI] Full Arvan LIVE 2.0 surface (streams, watermarks, reports, metrics). Allowlist: 36 ops from live-2.0.json (Arvan LIVE 2.0). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
invoke_storage_apiInvoke Object Storage management OpenAPIBDestructive
[OPENAPI] Call storage.arvanapis.ir management API (OpenAPI storage/1.0.0). Paths are /v1/...; base already includes /v1 so /v1 is stripped. Allowlist: 58 ops from storage-1.0.0.yaml (Object Storage API 1.0.0). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
invoke_vads_apiInvoke Video Ads OpenAPICDestructive
[OPENAPI] Full VADS 2.0 surface (channels, campaigns, ads, transactions). Allowlist: 29 ops from vads-2.0.json (ArvanCloud Video Advertising Service 2.0). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
invoke_vod_apiInvoke VOD OpenAPIBDestructive
[OPENAPI] Full Arvan VOD 2.0 surface (channels, videos, files, reports, …). Allowlist: 54 ops from vod-2.0.json (Arvan VOD 2.0). Rejects unknown paths — does not invent APIs.
Inputs: path (required), method (required), body, query.
list_ai_bucketsList AI region bucketsCRead-only
[READ] OpenAPI: GET /ai/v1/buckets/{region} (called as buckets/{region} on /ai/v1).
Inputs: region (required).
list_ai_datasetsList AI datasetsCRead-only
[READ] OpenAPI: GET /ai/v1/datasets → buckets path under /ai/v1 base as datasets
Inputs: no named parameters.
list_ai_endpointsList AI endpointsCRead-only
[READ] OpenAPI: GET /endpoints
Inputs: no named parameters.
list_ai_knowledge_basesList AI knowledge basesCRead-only
[READ] OpenAPI: GET /knowledge-bases
Inputs: no named parameters.
list_ai_modelsList AI modelsCRead-only
[READ] OpenAPI: GET /models
Inputs: no named parameters.
list_ai_providersList AI providersCRead-only
[READ] OpenAPI ai-ml-backend: GET /providers
Inputs: no named parameters.
list_bucketsList Object Storage bucketsBRead-only
[READ] S3 ListBuckets via official AWS-compatible SDK pattern (FA developer-tools/sdk/object-storage/list-bucket).
Inputs: no named parameters.
list_caas_configmapsList CaaS configmapsCRead-only
[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/configmaps
Inputs: zone (required), namespace (required).
list_caas_deploymentsList CaaS deploymentsCRead-only
[READ] OpenAPI: GET /apis/apps/v1/namespaces/{namespace}/deployments
Inputs: zone (required), namespace (required).
list_caas_podsList CaaS podsCRead-only
[READ] OpenAPI Arvan CaaS 1.25: GET /api/v1/namespaces/{namespace}/pods on zone base.
Inputs: zone (required), namespace (required).
list_caas_servicesList CaaS servicesCRead-only
[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/services
Inputs: zone (required), namespace (required).
list_database_flavorsList DBaaS flavorsCRead-only
[READ] OpenAPI IaaS 1.0: GET /regions/{region}/databases/flavors (ecc/v1).
Inputs: region (required).
list_dns_recordsList DNS recordsBRead-only
[READ] List DNS records for a domain. Official: GET /cdn/4.0/domains/{domain}/dns-records
Inputs: domain (required).
list_domainsList CDN domainsARead-only
[READ] List domains registered in the ArvanCloud CDN account. Official: GET /cdn/4.0/domains
Inputs: no named parameters.
list_edge_computesList Edge ComputesCRead-only
[READ] OpenAPI Edge Computing: GET /edge-computes (optional query: application, q, page, per_page).
Inputs: q, page, per_page, application.
list_edge_deploymentsList Edge Compute deploymentsCRead-only
[READ] OpenAPI: GET /edge-computes/{edgeComputeId}/deployments
Inputs: edge_compute_id (required).
list_edge_env_variablesList Edge Compute env variablesCRead-only
[READ] OpenAPI: GET /edge-computes/{edgeComputeId}/env-variables
Inputs: edge_compute_id (required).
list_edge_plansList Edge Computing plansCRead-only
[READ] OpenAPI: GET /plans
Inputs: no named parameters.
list_edge_routesList Edge Compute routesCRead-only
[READ] OpenAPI: GET /edge-computes/{edgeComputeId}/routes
Inputs: edge_compute_id (required).
list_edge_templatesList Edge Computing templatesCRead-only
[READ] OpenAPI: GET /templates
Inputs: no named parameters.
list_firewall_rulesList CDN firewall rulesCRead-only
[READ] GET /domains/{domain}/firewall/rules (CDN Go SDK FirewallRulesIndex).
Inputs: domain (required).
list_flavorsList Cloud Server flavors (IaaS v3)CRead-only
[READ] OpenAPI iaas/3.0.0: GET https://ecc.{region}.arvanapis.ir/v3/flavors
Inputs: region (required).
list_imagesList Cloud Server imagesARead-only
[READ] List images/OS available in a region. Official: GET /ecc/v1/regions/{region}/images.
Inputs: region (required).
list_live_streamsList LIVE streamsBRead-only
[READ] OpenAPI Arvan LIVE 2.0: GET /streams (base napi.../live/2.0).
Inputs: no named parameters.
list_live_watermarksList LIVE watermarksCRead-only
[READ] OpenAPI: GET /watermarks
Inputs: no named parameters.
list_networksList Cloud Server networksCRead-only
[READ] OpenAPI IaaS 1.0: GET /regions/{region}/networks (ecc/v1).
Inputs: region (required).
list_objectsList objects in a bucketCRead-only
[READ] S3 ListObjectsV2. Official API Usage listObjects sample + SDK object-list.
Inputs: bucket (required), prefix, max_keys, continuation_token.
list_rate_limit_rulesList rate-limit rulesDRead-only
[READ] GET /domains/{domain}/rate-limit/rules
Inputs: domain (required).
list_serversList Cloud Server instancesBRead-only
[READ] List instances in a data center region. Official: GET /ecc/v1/regions/{region}/servers. Example region from docs: ir-thr-c2.
Inputs: region (required).
list_servers_v3List Cloud Servers (IaaS API v3)DRead-only
[READ] OpenAPI iaas/3.0.0: GET https://ecc.{region}.arvanapis.ir/v3/servers
Inputs: region (required), page, perPage.
list_storage_api_bucketsList buckets via Storage management APIARead-only
[READ] OpenAPI Object Storage API 1.0.0: GET /v1/buckets (storage.arvanapis.ir) — optional status=all|shared|owned, page, perPage. Uses Machine User key (not S3 HMAC).
Inputs: page, status, perPage.
list_troubleshootsList CDN troubleshootsBRead-only
[READ] List troubleshoot runs for a domain. Official CDN API: GET /domains/{domain}/troubleshoots
Inputs: domain (required).
list_vads_channel_campaignsList campaigns for a Video Ads channelCRead-only
[READ] OpenAPI: GET /channels/{channel}/campaigns
Inputs: channel_id (required).
list_vads_channelsList Video Ads channelsCRead-only
[READ] OpenAPI VADS 2.0: GET /channels (host napi.arvancloud.ir/vads/2.0).
Inputs: no named parameters.
list_vod_channelsList VOD channelsBRead-only
[READ] Official FA/EN API Usage: GET https://napi.arvancloud.ir/vod/2.0/channels
Inputs: no named parameters.
list_vod_tagsList VOD tagsCRead-only
[READ] OpenAPI: GET /tags
Inputs: no named parameters.
list_vod_videosList videos in a VOD channelCRead-only
[READ] Offline FA API Usage: GET /vod/2.0/channels/{channel-id}/videos
Inputs: channel_id (required).
power_off_serverPower off Cloud ServerC
[WRITE] OpenAPI IaaS 1.0: POST /regions/{region}/servers/{id}/power-off
Inputs: region (required), server_id (required).
power_on_serverPower on Cloud ServerC
[WRITE] OpenAPI IaaS 1.0: POST /regions/{region}/servers/{id}/power-on
Inputs: region (required), server_id (required).
purge_cachePurge CDN cacheADestructive
[DESTRUCTIVE] Purge CDN cache. Official: POST /cdn/4.0/domains/{domain}/caching/purge. purge=all clears entire domain cache (service impact). purge=individual requires exact purge_urls. Never broaden scope.
Inputs: purge (required), domain (required), purge_urls.
put_object_textUpload text objectB
[WRITE] S3 PutObject with string body (FA SDK upload-object). For binary uploads use other clients; this tool is text-oriented for agent safety.
Inputs: key (required), body (required), bucket (required), acl, +1 more.
reboot_serverReboot Cloud ServerC
[WRITE] OpenAPI IaaS 1.0: POST /regions/{region}/servers/{id}/reboot
Inputs: region (required), server_id (required).
register_domainRegister CDN domainB
[WRITE] Register a domain for CDN/DNS service. Official: POST /cdn/4.0/domains/dns-service. domain_type full = NS delegation; partial = CNAME setup.
Inputs: domain (required), domain_type (required), plan_level.
reprioritize_firewall_rulesReprioritize CDN firewall rulesC
[WRITE] POST /domains/{domain}/firewall/actions/reprioritize (CDN Go SDK). Pass the priority payload exactly as required by the API (product pages list the operation; body schema details may come from API portal).
Inputs: body (required), domain (required).
reprioritize_rate_limit_rulesReprioritize rate-limit rulesC
[WRITE] POST /domains/{domain}/rate-limit/actions/reprioritize (CDN Go SDK / EN rate-limit API table).
Inputs: body (required), domain (required).
set_dns_record_cloudToggle DNS record cloud (CDN proxy)B
[WRITE] Toggle cloud/proxy status for a DNS record. Official: PUT /cdn/4.0/domains/{domain}/dns-records/{id}/cloud
Inputs: cloud (required), domain (required), record_id (required).
set_domain_nameserversSet custom domain nameserversC
[WRITE] Set custom NS keys. Offline FA (cdn/dns-records/change-default-ns): PUT /domains/{domain}/ns-keys body {"ns_keys":[...]}
Inputs: domain (required), ns_keys (required).
set_domain_planSet CDN domain planB
[WRITE] Set domain plan_level (1=basic, 2=growth, 3=professional per domain docs). Official: PUT /cdn/4.0/domains/{domain}/plan
Inputs: domain (required), plan_level (required).
set_edge_env_variableSet Edge Compute env variableC
[WRITE] OpenAPI EnvVariable: POST /edge-computes/{edgeComputeId}/env-variables — key, value, type (string|json), is_secret.
Inputs: key (required), type (required), value (required), is_secret (required), +1 more.
update_accelerationUpdate CDN acceleration settingsB
[WRITE] Offline FA (cdn/acceleration): PATCH /domains/{domain}/acceleration e.g. {"status":"on","extensions":["css"]}
Inputs: domain (required), status, extensions.
update_caching_settingsUpdate CDN caching settingsC
[WRITE] Patch caching settings. Official: PATCH /cdn/4.0/domains/{domain}/caching. Documented fields include cache_status (off|uri|query_string), cache_page_200, cache_page_any, cache_browser, cache_ignore_sc, cache_developer_mode, cache_consistent_uptime.
Inputs: domain (required), cache_status, cache_browser, cache_page_200, +4 more.
update_ddos_protection_modeUpdate DDoS protection modeC
[WRITE] Offline FA (cdn/security/ddos): PATCH /domains/{domain}/ddos with protection_mode (cookie|javascript|recaptcha|captcha). Note: CDN Go SDK lists /ddos/settings — this tool follows FA product docs path /ddos.
Inputs: domain (required), protection_mode (required), ttl, captcha_service.
update_dns_recordUpdate DNS recordA
[WRITE] Update an existing DNS record. Official: PUT /cdn/4.0/domains/{domain}/dns-records/{id}. Requires exact record_id. Read current state first.
Inputs: name (required), type (required), value (required), domain (required), +8 more.
update_dnssecEnable or disable DNSSECC
[WRITE] Update DNSSEC. Offline FA (cdn/dns-records/dnssec): PUT /domains/{domain}/dns-records/dnssec/actions body {"enable":true|false}.
Inputs: domain (required), enable (required).
update_edge_routeUpdate Edge Computing routeD
[WRITE] OpenAPI: PUT /edge-computes/{edgeComputeId}/routes/{route_id}
Inputs: route_id (required), edge_compute_id (required), url, domain, +1 more.
update_firewall_ruleUpdate CDN firewall ruleC
[WRITE] PATCH /domains/{domain}/firewall/rules/{id}. Requires exact rule_id. Use documented fields from create samples.
Inputs: domain (required), rule_id (required), name, note, +4 more.
update_firewall_settingsUpdate CDN firewall settingsC
[WRITE] PATCH /domains/{domain}/firewall/settings. Offline FA known-bots sample includes skip_global_firewall. Pass only documented fields.
Inputs: domain (required), settings, skip_global_firewall.
update_image_resizeUpdate image resize settingsC
[WRITE] Offline FA (cdn/acceleration): PATCH /domains/{domain}/image-resize e.g. {"status":"on"}
Inputs: domain (required), status (required).
update_origin_connection_settingsUpdate origin / load-balancer connection settingsC
[WRITE] Offline FA (https-settings + advanced-settings): PATCH /domains/{domain}/load-balancers/settings. Documented fields include protocol (http|https|auto), method, keepalive, max_fails, fail_timeout, next_upstream_tcp.
Inputs: domain (required), method, protocol, keepalive, +3 more.
update_rate_limit_ruleUpdate rate-limit ruleC
[WRITE] PATCH /domains/{domain}/rate-limit/rules/{id}
Inputs: domain (required), rule_id (required), rate, burst, +9 more.
update_rate_limit_settingsUpdate rate-limit settingsC
[WRITE] PATCH /domains/{domain}/rate-limit/settings
Inputs: domain (required), settings (required).
update_ssl_settingsUpdate SSL/HTTPS settingsA
[WRITE] Patch SSL settings. Official: PATCH /cdn/4.0/domains/{domain}/ssl. Documented fields: ssl_status, https_redirect, replace_http, tls_version, hsts_status, hsts_max_age, hsts_subdomain, hsts_preload. HSTS changes can be hard to reverse until max-age expires.
Inputs: domain (required), ssl_status, hsts_status, tls_version, +5 more.
update_waf_modeUpdate WAF modeB
[WRITE] Offline FA / EN WAF docs: PATCH /domains/{domain}/waf with mode off|detect|protect. Note: CDN Go SDK lists /waf/settings — this tool follows product docs path /waf.
Inputs: mode (required), domain (required).
use_optional_nameserversSwitch to optional ArvanCloud NS keysC
[WRITE] Use optional NS keys (.net/.com style). Offline FA: POST /domains/{domain}/ns-keys/use-optional-keys
Inputs: domain (required).
write_cloud_logsWrite CloudLogs entriesA
[WRITE] Ingest logs via POST /logging/v1/entries/write (Fluent Bit ArvanCloud CloudLogs plugin). Body: { logs: [{ logType, timestamp?, severity?, resource?, payload }] }. Auth: Apikey header. Not a full CloudLogs management API.
Inputs: logs (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 130 tools
The server has many product-specific tools with clear prefixes (vod, live, vads, caas, ai, edge, storage), but generic invoke_*_api tools overlap heavily with the named tools, and similarly named operations exist across products (e.g., list_buckets vs list_ai_buckets vs list_storage_api_buckets, multiple get_domain variants). Descriptions give exact endpoints, but an agent could still misselect when product context is absent.
Nearly all tools use snake_case verb_noun, but consistency is only mostly maintained: some tools carry product prefixes (list_vod_videos), some do not (list_domains, list_servers), and version suffixes appear (list_servers_v3 vs list_servers). The generic invoke_*_api tools follow a predictable pattern, and S3 head_* verbs are conventional. These are minor deviations rather than chaotic naming.
130 tools is far beyond typical scoped MCP server size, and many named tools are made redundant by generic invoke_*_api tools that already cover large API surfaces. While the server spans many products, the count is overwhelming and likely to burden tool selection and agent reliability.
The surface is extremely broad across CDN, DNS, VOD, Live, VADS, IaaS, CaaS, AI, Edge, and Storage, with CRUD for many resources and generic API invokers to fill undocumented or missing operations. However, some named product areas lack full lifecycle operations (e.g., VOD channels/videos) and rely on generic invokers, so coverage is strong but not seamless.
Maintenance
Related MCP Connectors
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Official xCloud MCP: manage servers, sites, WordPress, SSL, backups and deploys from any MCP client.
Build, test, publish and manage real MCP servers from APIs with a live developer studio.
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables MCP-capable agents to create and invoke OpenServerless endpoints, manage secrets, and configure integrations such as S3, PostgreSQL, Redis, Milvus, and MongoDB.13Apache 2.0

meshive-mcpofficial
AlicenseAqualityBmaintenanceEnables MCP-capable agents to manage Meshive GPU Cloud resources, including account, workspaces, pods, storage, GPUs, templates, serverless deployments, tasks, assets, machines, and billing history.71Apache 2.0- AlicenseNot gradedqualityBmaintenanceEnables developers to build, test, debug, and operate MCP servers from VS Code or CI, while also exposing trusted MCP capabilities to AI agents.MIT
- AlicenseCqualityCmaintenanceEnables any MCP client to triage cloud agents, projects, conversations, transcripts, pull requests, and files, including listing agents, reading transcripts, following runs, and sending follow-ups, using an API key or browser sign-in.29MIT