Skip to main content
Glama

arvancai

ArvanCloud MCP server + Agent Skill — manage ArvanCloud from any MCP-capable agent/IDE
(Cursor, Windsurf, Claude Desktop/Code, Codex, OpenCode, and more).

npm GitHub

npm install -g arvancai

Repository: 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 arvancai

On 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 setup

Force every known host path (even if the app is not installed yet):

arvancai setup --all

Skip auto-setup during install:

ARVANCAI_SKIP_SETUP=1 npm install -g arvancai

Check CLI (this must print help — it must not hang):

arvancai --help
which arvancai

Then 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=logs

See .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 (arvancai)

Tools / resources / prompts over the MCP protocol

Works on all MCP clients

Skill (skill/SKILL.md)

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 (+ invoke_cdn_api)

DNS zone import/export

import_dns_zone / export_dns_zone

Cloud Server (ECC) / partial DBaaS

Yes

IaaS region quota

get_region_quota (limits, not wallet)

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

write_cloud_logs (local)

CloudLogs management (spaces / sinks / forwarders)

Official hosted MCP bridge (mcp.arvancloud.ir)

Let's Encrypt DNS-01 (acme.sh)

Documented in Skill (skill/references/dns.md)

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=1 for 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 setup

See DEVELOPMENT.md.

License

MIT

Available Tools

130 tools
check_domain_nameserversCheck domain nameserversB
Read-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 bucketA
Destructive

[DESTRUCTIVE] S3 DeleteBucket (FA SDK delete-bucket). Bucket must be empty per product docs.

Inputs: bucket (required).

delete_dns_recordDelete DNS recordA
Destructive

[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 routeC
Destructive

[DESTRUCTIVE] OpenAPI: DELETE /edge-computes/{edgeComputeId}/routes/{route_id}

Inputs: route_id (required), edge_compute_id (required).

delete_firewall_ruleDelete CDN firewall ruleB
Destructive

[DESTRUCTIVE] DELETE /domains/{domain}/firewall/rules/{id}. Requires exact rule_id — never delete multiple.

Inputs: domain (required), rule_id (required).

delete_objectDelete objectC
Destructive

[DESTRUCTIVE] S3 DeleteObject (FA SDK delete-object). Requires exact bucket+key.

Inputs: key (required), bucket (required).

delete_rate_limit_ruleDelete rate-limit ruleC
Destructive

[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 settingsC
Read-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 endpointC
Read-only

[READ] OpenAPI: GET /endpoints/{endpoint_id}

Inputs: endpoint_id (required).

get_ai_modelGet AI modelC
Read-only

[READ] OpenAPI: GET /models/{model_id}

Inputs: model_id (required).

get_bucket_metricsGet Object Storage bucket metricsC
Read-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 deploymentC
Read-only

[READ] OpenAPI: GET /apis/apps/v1/namespaces/{namespace}/deployments/{name}

Inputs: name (required), zone (required), namespace (required).

get_caas_podGet CaaS podC
Read-only

[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/pods/{name}

Inputs: name (required), zone (required), namespace (required).

get_caas_pod_logsGet CaaS pod logsD
Read-only

[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/pods/{name}/log

Inputs: name (required), zone (required), namespace (required).

get_caching_settingsGet CDN caching settingsA
Read-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 reportC
Read-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 reportB
Read-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 reportC
Read-only

[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/response-time?period=

Inputs: domain (required), period.

get_cdn_status_reportCDN HTTP status-code reportC
Read-only

[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/status?period=

Inputs: domain (required), period.

get_cdn_traffic_reportCDN traffic/requests reportC
Read-only

[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/traffics?period=

Inputs: domain (required), period.

get_cdn_visitors_reportCDN unique visitors reportC
Read-only

[READ] OpenAPI + ar-prometheus-exporter: GET /domains/{domain}/reports/visitors?period=

Inputs: domain (required), period.

get_dns_recordGet DNS recordA
Read-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 statusB
Read-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 domainB
Read-only

[READ] Get information for one CDN domain. Official: GET /cdn/4.0/domains/{domain}

Inputs: domain (required).

get_edge_computeGet Edge ComputeD
Read-only

[READ] OpenAPI: GET /edge-computes/{edgeComputeId}

Inputs: edge_compute_id (required).

get_edge_namespaceGet Edge namespace settingsC
Read-only

[READ] OpenAPI: GET /namespace

Inputs: no named parameters.

get_firewall_ruleGet CDN firewall ruleD
Read-only

[READ] GET /domains/{domain}/firewall/rules/{id}

Inputs: domain (required), rule_id (required).

get_firewall_settingsGet CDN firewall settingsC
Read-only

[READ] GET /domains/{domain}/firewall/settings (CDN Go SDK; FA firewall API table).

Inputs: domain (required).

get_latest_troubleshootGet latest CDN troubleshootB
Read-only

[READ] Get the latest troubleshoot for a domain. Official: GET /domains/{domain}/troubleshoots/latest

Inputs: domain (required).

get_live_domainGet LIVE domain settingsC
Read-only

[READ] OpenAPI: GET /domain

Inputs: no named parameters.

get_live_streamGet LIVE streamC
Read-only

[READ] OpenAPI: GET /streams/{stream}

Inputs: stream_id (required).

get_object_textDownload object as text (size-capped)A
Read-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 ruleC
Read-only

[READ] GET /domains/{domain}/rate-limit/rules/{id}

Inputs: domain (required), rule_id (required).

get_rate_limit_settingsGet rate-limit settingsC
Read-only

[READ] GET /domains/{domain}/rate-limit/settings (CDN Go SDK; EN/FA rate-limit API table).

Inputs: domain (required).

get_serverGet Cloud Server instanceC
Read-only

[READ] OpenAPI IaaS 1.0: GET /regions/{region}/servers/{id} (ecc/v1).

Inputs: region (required), server_id (required).

get_ssl_settingsGet SSL/HTTPS settingsB
Read-only

[READ] Get domain SSL settings. Official: GET /cdn/4.0/domains/{domain}/ssl

Inputs: domain (required).

get_storage_reportGet Object Storage usage reportC
Read-only

[READ] OpenAPI: GET /v1/reports/storage on storage.arvanapis.ir

Inputs: no named parameters.

get_vads_campaignGet Video Ads campaignD
Read-only

[READ] OpenAPI: GET /campaigns/{campaign}

Inputs: campaign_id (required).

get_vads_channelGet Video Ads channelC
Read-only

[READ] OpenAPI: GET /channels/{channel}

Inputs: channel_id (required).

get_vads_domainGet Video Ads domainC
Read-only

[READ] OpenAPI: GET /domain

Inputs: no named parameters.

get_vod_channelGet VOD channelC
Read-only

[READ] OpenAPI Arvan VOD 2.0: GET /channels/{channel}

Inputs: channel_id (required).

get_vod_domainGet VOD domain settingsC
Read-only

[READ] OpenAPI: GET /domain

Inputs: no named parameters.

get_vod_videoGet VOD videoD
Read-only

[READ] OpenAPI: GET /videos/{video}

Inputs: video_id (required).

head_bucketCheck bucket existsC
Read-only

[READ] S3 HeadBucket (FA SDK head-bucket).

Inputs: bucket (required).

head_objectHead object metadataD
Read-only

[READ] S3 HeadObject (FA SDK head-object).

Inputs: key (required), bucket (required).

invoke_aiaas_apiInvoke AI-as-a-Service OpenAPIA
Destructive

[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 OpenAPIB
Destructive

[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 operationA
Destructive

[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 OpenAPIB
Destructive

[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)A
Destructive

[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 v3B
Destructive

[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 OpenAPIB
Destructive

[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 OpenAPIB
Destructive

[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 OpenAPIC
Destructive

[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 OpenAPIB
Destructive

[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 bucketsC
Read-only

[READ] OpenAPI: GET /ai/v1/buckets/{region} (called as buckets/{region} on /ai/v1).

Inputs: region (required).

list_ai_datasetsList AI datasetsC
Read-only

[READ] OpenAPI: GET /ai/v1/datasets → buckets path under /ai/v1 base as datasets

Inputs: no named parameters.

list_ai_endpointsList AI endpointsC
Read-only

[READ] OpenAPI: GET /endpoints

Inputs: no named parameters.

list_ai_knowledge_basesList AI knowledge basesC
Read-only

[READ] OpenAPI: GET /knowledge-bases

Inputs: no named parameters.

list_ai_modelsList AI modelsC
Read-only

[READ] OpenAPI: GET /models

Inputs: no named parameters.

list_ai_providersList AI providersC
Read-only

[READ] OpenAPI ai-ml-backend: GET /providers

Inputs: no named parameters.

list_bucketsList Object Storage bucketsB
Read-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 configmapsC
Read-only

[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/configmaps

Inputs: zone (required), namespace (required).

list_caas_deploymentsList CaaS deploymentsC
Read-only

[READ] OpenAPI: GET /apis/apps/v1/namespaces/{namespace}/deployments

Inputs: zone (required), namespace (required).

list_caas_podsList CaaS podsC
Read-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 servicesC
Read-only

[READ] OpenAPI: GET /api/v1/namespaces/{namespace}/services

Inputs: zone (required), namespace (required).

list_database_flavorsList DBaaS flavorsC
Read-only

[READ] OpenAPI IaaS 1.0: GET /regions/{region}/databases/flavors (ecc/v1).

Inputs: region (required).

list_dns_recordsList DNS recordsB
Read-only

[READ] List DNS records for a domain. Official: GET /cdn/4.0/domains/{domain}/dns-records

Inputs: domain (required).

list_domainsList CDN domainsA
Read-only

[READ] List domains registered in the ArvanCloud CDN account. Official: GET /cdn/4.0/domains

Inputs: no named parameters.

list_edge_computesList Edge ComputesC
Read-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 deploymentsC
Read-only

[READ] OpenAPI: GET /edge-computes/{edgeComputeId}/deployments

Inputs: edge_compute_id (required).

list_edge_env_variablesList Edge Compute env variablesC
Read-only

[READ] OpenAPI: GET /edge-computes/{edgeComputeId}/env-variables

Inputs: edge_compute_id (required).

list_edge_plansList Edge Computing plansC
Read-only

[READ] OpenAPI: GET /plans

Inputs: no named parameters.

list_edge_routesList Edge Compute routesC
Read-only

[READ] OpenAPI: GET /edge-computes/{edgeComputeId}/routes

Inputs: edge_compute_id (required).

list_edge_templatesList Edge Computing templatesC
Read-only

[READ] OpenAPI: GET /templates

Inputs: no named parameters.

list_firewall_rulesList CDN firewall rulesC
Read-only

[READ] GET /domains/{domain}/firewall/rules (CDN Go SDK FirewallRulesIndex).

Inputs: domain (required).

list_flavorsList Cloud Server flavors (IaaS v3)C
Read-only

[READ] OpenAPI iaas/3.0.0: GET https://ecc.{region}.arvanapis.ir/v3/flavors

Inputs: region (required).

list_imagesList Cloud Server imagesA
Read-only

[READ] List images/OS available in a region. Official: GET /ecc/v1/regions/{region}/images.

Inputs: region (required).

list_live_streamsList LIVE streamsB
Read-only

[READ] OpenAPI Arvan LIVE 2.0: GET /streams (base napi.../live/2.0).

Inputs: no named parameters.

list_live_watermarksList LIVE watermarksC
Read-only

[READ] OpenAPI: GET /watermarks

Inputs: no named parameters.

list_networksList Cloud Server networksC
Read-only

[READ] OpenAPI IaaS 1.0: GET /regions/{region}/networks (ecc/v1).

Inputs: region (required).

list_objectsList objects in a bucketC
Read-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 rulesD
Read-only

[READ] GET /domains/{domain}/rate-limit/rules

Inputs: domain (required).

list_serversList Cloud Server instancesB
Read-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)D
Read-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 APIA
Read-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 troubleshootsB
Read-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 channelC
Read-only

[READ] OpenAPI: GET /channels/{channel}/campaigns

Inputs: channel_id (required).

list_vads_channelsList Video Ads channelsC
Read-only

[READ] OpenAPI VADS 2.0: GET /channels (host napi.arvancloud.ir/vads/2.0).

Inputs: no named parameters.

list_vod_channelsList VOD channelsB
Read-only

[READ] Official FA/EN API Usage: GET https://napi.arvancloud.ir/vod/2.0/channels

Inputs: no named parameters.

list_vod_tagsList VOD tagsC
Read-only

[READ] OpenAPI: GET /tags

Inputs: no named parameters.

list_vod_videosList videos in a VOD channelC
Read-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 cacheA
Destructive

[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

    C2.6/5.0

    Scored across 130 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP-capable agents to manage Meshive GPU Cloud resources, including account, workspaces, pods, storage, GPUs, templates, serverless deployments, tasks, assets, machines, and billing history.
      71
      Apache 2.0
    • A
      license
      C
      quality
      C
      maintenance
      Enables 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.
      29
      MIT