Edge Network
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Deploy and manage Edge Network cloud: sites, VMs, storage, DNS, Shield, Assist. Agent self-signup.
| Author | network.edge |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 2063 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"Edge Network": {
"url": "https://edge.network/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (28)
edge_discoverGet everything about the connected Edge account: plan, budget, enabled products with limits and regions, current projects, and full API documentation. Call this first in every session.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_deploy_static_siteDeploy a static website to Edge in one call: creates a storage bucket, uploads files (or clones a git repo), configures the global CDN with SSL, and wires DNS if the zone is on Edge. Free tier covers it. Provide either files (base64) or a git repo.
Parameters:
project(required) — string — Project name (created if it does not exist), e.g. "my-portfolio"repo— string — Git repository to deploy instead of files: "user/repo" or a full GitHub/GitLab URLfiles— array — Files to upload, base64-encoded.branch— string — Git branch or tag (default: main)domain— string — Custom domain to serve from, e.g. "app.example.com". SSL is auto-provisioned.dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.spa_mode— boolean — Enable single-page-app mode (all routes serve index.html)git_token— string — Personal access token for private repositoriessource_path— string — Subdirectory of the repo to deploy, e.g. "dist" or "build"
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_deploy_appDeploy a full application on a VM: provisions compute, runs a setup script, and optionally adds CDN and DNS. This is BILLABLE — always dry_run first and report the monthly cost to the user. Pass ssh_key (a public key string) to enable SSH access.
Parameters:
project(required) — string — Project namesize(required) — string — nano: 1vCPU/1GB, small: 1/2GB, medium: 2/4GB, large: 4/8GB, xlarge: 8/16GBos— string — Operating system template id (default ubuntu-24.04)cdn— boolean — Put the Edge CDN in front of the VMdomain— string — Domain for the appregion— string — Deployment region (default london) — list regions via edge_discoverscript— string — Startup script id from the Edge library (e.g. "docker", "nodejs") — preferred over setup_scriptdry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.ssh_key— string — SSH public key string (e.g. "ssh-ed25519 AAAA...") to bake into the VMsetup_script— string — Inline bash script to run on first boot (use script instead when a library script exists)script_params— object — Parameters for the chosen library script
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_update_deploymentUpdate an existing deployment: upload changed files and optionally purge the CDN cache.
Parameters:
project_id(required) — string — Project id (from edge_list_projects)files(required) — array — Files to upload, base64-encoded.dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.purge_cdn— boolean — Purge the CDN cache after uploadchanged_only— boolean — Skip files whose content has not changed (MD5 comparison)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_list_projectsList all projects (groupings of resources) on the connected Edge account.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_project_healthComprehensive health check for every resource in a project: status, metrics, and actionable suggestions.
Parameters:
project_id(required) — string — Project id (from edge_list_projects)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_scale_projectScale the compute resources in a project up or down. BILLABLE — dry_run first and report the cost change to the user.
Parameters:
project_id(required) — string — Project idsize(required) — string — Target VM sizereason— string — Why you are scaling (recorded in the audit log)dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_teardown_projectPERMANENTLY delete a project and every resource in it (VMs, buckets, CDN deployments, DNS zones). Irreversible — only use when the user has clearly asked. Set confirm to true to execute.
Parameters:
project_id(required) — string — Project idconfirm— boolean — Must be true to actually delete. Without it the call fails with a summary of what would be deleted.dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_list_vmsList all virtual machines on the account with status, size, and IPs.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_get_vmGet one VM: live status, metrics, IPs, attached SSH keys, and the ready-to-use SSH command. Poll until status is "running" before attempting SSH.
Parameters:
vm_id(required) — string — VM id (from edge_list_vms)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_vm_powerStart, stop, restart, suspend, resume or hard-reset a VM. Stopped VMs keep their disk and IP and are still billed. Returns the VM with its new status.
Parameters:
vm_id(required) — string — VM id (from edge_list_vms)action(required) — string — Power action. Use "reset" only when "restart" does not respond.dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_rename_vmChange the display name of a VM (does not change the guest hostname).
Parameters:
vm_id(required) — string — VM id (from edge_list_vms)name(required) — string — New namedry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_delete_vmPERMANENTLY delete one VM, its disk and its IP. Irreversible — only use when the user has clearly asked. Set confirm to true to execute; without it the call returns a summary of what would be deleted. Requires the "delete" permission.
Parameters:
vm_id(required) — string — VM id (from edge_list_vms)confirm— boolean — Must be true to actually delete.dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_list_bucketsList storage buckets on the account.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_create_bucketCreate an object storage bucket (S3-compatible). Free tier includes a limited number of buckets.
Parameters:
name(required) — string — Bucket name: 3-63 chars, lowercase letters, numbers, hyphensdry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_upload_filesUpload files to an existing storage bucket.
Parameters:
bucket(required) — string — Bucket namefiles(required) — array — Files to upload, base64-encoded.dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.changed_only— boolean — Skip files whose content has not changed (MD5 comparison)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_list_dns_zonesList DNS zones on the account.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_create_dns_zoneCreate a DNS zone for a domain on Edge authoritative DNS. Free.
Parameters:
domain(required) — string — Domain name, e.g. "example.com"dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_add_dns_recordAdd a DNS record to a zone.
Parameters:
zone_id(required) — string — Zone id (from edge_list_dns_zones)type(required) — string — Record typename(required) — string — Record name, e.g. "www" or "@" for the rootdata(required) — string — Record value, e.g. an IP address or target domainttl— number — TTL in seconds (default 300)dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.priority— number — Priority — required for MX records
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_update_dns_recordChange an existing DNS record in place — e.g. repoint an A record when a VM gets a new IP. Prefer this over adding a second record. Only the fields you pass are changed. Record ids come from the zone detail (GET /agent/dns/zones/{id}).
Parameters:
zone_id(required) — string — Zone id (from edge_list_dns_zones)record_id(required) — string — Record id (from the zone detail)ttl— number — New TTL in secondsdata— string — New value, e.g. the new IP addressname— string — New record nametype— string — New record typedry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.priority— number — New priority (MX only)
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_delete_dns_recordDelete one DNS record from a zone.
Parameters:
zone_id(required) — string — Zone id (from edge_list_dns_zones)record_id(required) — string — Record id (from the zone detail)dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_delete_dns_zonePERMANENTLY delete a DNS zone and all its records; the domain stops resolving via Edge. Irreversible — only use when the user has clearly asked. Set confirm to true to execute. Requires the "delete" permission.
Parameters:
zone_id(required) — string — Zone id (from edge_list_dns_zones)confirm— boolean — Must be true to actually delete.dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_list_shield_widgetsList Edge Shield widgets (free, privacy-first CAPTCHA alternative).
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_create_shield_widgetCreate an Edge Shield widget to protect a form or page from bots. Free. Returns the sitekey, the secret (shown once — store it server-side), and a ready-to-paste embed snippet.
Parameters:
name(required) — string — Friendly name, e.g. "Contact form"mode— string — managed: invisible for humans, one-click check for suspicious traffic (default)dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.hostnames— array — Hostnames allowed to use this widget, e.g. ["example.com"]. Empty = any hostname.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_list_assist_sitesList Edge Assist sites (AI answers widget) with usage and index status.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_create_assist_siteCreate an Edge Assist site: AI answers for a website, grounded in its own content. Free tier: 1 site, 250 answered questions/month. Returns the sitekey and a one-line embed snippet.
Parameters:
name(required) — string — Friendly name, e.g. "Docs site"hostname(required) — string — Hostname the widget will run on, e.g. "docs.example.com" (origin-enforced)dry_run— boolean — Preview the action without executing it. Returns what would happen, including cost estimates. Always dry-run first for anything that costs money.index_url— string — Public URL of the content index JSON: { "pages": [{ "url", "title", "text" }] }. Can be set later.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_account_statusCheck whether the connected account is a self-signed-up guest (explore tier) or fully claimed, and how to unlock it.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
edge_request_claimNominate the human operator of a self-signed-up (explore tier) account. They receive an email with a claim link; claiming unlocks billable resources and stops the ~7 day auto-purge. Ask the user for their email address first.
Parameters:
email(required) — string — The human operator's email address
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.