MCP
Connect at https://mcp.edge.deca-dev.com. See Connect your agent for how to wire a coding agent or DECA Agent. Tools need a bearer token for the MCP audience on that host. See Environments and domains.
Each tool needs the scope shown below. Organization comes from the token and is never a tool argument. Workspace is optional for most tools; omitted, Edge uses your organization's default workspace.
Tools
Workspaces
| MCP tool | Scope |
|---|---|
edge_namespace_get | (signed in) — returns the workspace bound to the token, not a list |
Distributions
| MCP tool | Scope |
|---|---|
edge_slug_check | distribution.read |
edge_distribution_list | distribution.read |
edge_distribution_create | distribution.write |
edge_distribution_get | distribution.read |
edge_distribution_update | distribution.write |
edge_distribution_copy | distribution.write |
edge_distribution_destroy | distribution.destroy |
Deployments
| MCP tool | Scope |
|---|---|
edge_deployment_list | deployment.read |
edge_deployment_create | deployment.write |
edge_deployment_check | deployment.write |
edge_deployment_get | deployment.read |
edge_deployment_commit | deployment.write |
edge_deployment_promote | deployment.promote |
edge_deployment_diff | deployment.read |
edge_deployment_rollback | deployment.promote |
edge_deployment_schedule_list | deployment.read |
edge_deployment_schedule_cancel | deployment.promote |
edge_distribution_takedown | deployment.promote |
edge_distribution_restore | deployment.promote |
edge_content_list | deployment.read |
edge_content_write | deployment.write |
edge_content_delete | deployment.write |
edge_content_get | deployment.read |
edge_deployment_promote, edge_distribution_takedown and edge_distribution_restore take an optional at; with it they schedule the action instead of running it now. See Schedule a launch and a takedown.
Data objects
| MCP tool | Scope |
|---|---|
edge_document_list | document.read |
edge_document_write | document.write |
edge_document_delete | document.write |
edge_document_get | document.read |
edge_document_history | document.read |
edge_document_rollback | document.write |
edge_document_grant_get | function.read |
edge_document_grant_set | function.write |
edge_document_prefix_get | function.read |
edge_document_prefix_set | function.write |
edge_private_document_list | function.read |
edge_private_document_get | function.read |
edge_private_document_write | function.write |
edge_private_document_delete | function.write |
See Serve a data object and Read and write data objects from a function.
Domains
| MCP tool | Scope |
|---|---|
edge_domain_list | domain.read |
edge_domain_create | domain.manage |
edge_domain_get | domain.read |
edge_domain_verify | domain.manage |
edge_domain_attach | domain.manage |
edge_domain_detach | domain.manage |
edge_domain_destroy | domain.destroy |
Checks
| MCP tool | Scope |
|---|---|
edge_distribution_invalidate | deployment.promote |
edge_redirect_check | distribution.read |
edge_redirect_import | distribution.write |
edge_redirect_export | distribution.read |
edge_header_check | distribution.read |
edge_health_check | analytics.read |
Redirect and header checks inspect stored config only. edge_redirect_import is a dry run unless dry_run is false. See Redirects. A permissions-policy value must be one of the two strings in Permissions-Policy. Setting headers creates a deployment; visitors see it after that deployment is promoted.
Analytics and logs
| MCP tool | Scope |
|---|---|
edge_analytics_query | analytics.read |
edge_analytics_explore | analytics.read |
edge_analytics_realtime | analytics.read |
edge_log_list | logs.read |
edge_log_get | logs.read |
Goals
| MCP tool | Scope |
|---|---|
edge_goal_check | goals.read |
edge_goal_list | goals.read |
edge_goal_get | goals.read |
edge_goal_create | goals.write |
edge_goal_upsert | goals.write |
edge_goal_update | goals.write |
edge_goal_archive | goals.write |
Analytics groups and funnels
| MCP tool | Scope |
|---|---|
edge_group_list | funnels.read |
edge_group_get | funnels.read |
edge_group_create | funnels.write |
edge_group_update | funnels.write |
edge_funnel_check | funnels.read |
edge_funnel_list | funnels.read |
edge_funnel_get | funnels.read |
edge_funnel_create | funnels.write |
edge_funnel_upsert | funnels.write |
edge_funnel_update | funnels.write |
edge_funnel_archive | funnels.write |
edge_funnel_query | funnels.read |
Properties and PII
| MCP tool | Scope |
|---|---|
edge_property_check | analytics.read |
edge_property_list | analytics.read |
edge_property_declare | properties.write |
edge_property_update | properties.write |
edge_property_archive | properties.write |
edge_pii_policy_get | pii.read |
edge_pii_policy_set | pii.policy.write |
edge_pii_exemption_create | pii.policy.write |
edge_pii_exemption_revoke | pii.policy.write |
edge_pii_detector_list | pii.read |
edge_pii_report | pii.read |
Webhooks and hooks
Subscribing to form.* also needs form.forward, and creates nothing until confirm is true. See Events, webhooks, and hooks.
| MCP tool | Scope |
|---|---|
edge_webhook_list | webhook.read |
edge_webhook_get | webhook.read |
edge_webhook_create | webhook.write |
edge_webhook_update | webhook.write |
edge_webhook_destroy | webhook.write |
edge_webhook_test | webhook.write |
edge_webhook_rotate_secret | webhook.write |
edge_webhook_delivery_list | webhook.read |
edge_webhook_redeliver | webhook.write |
edge_hook_list | hook.read |
edge_hook_get | hook.read |
edge_hook_create | hook.write |
edge_hook_update | hook.write |
edge_hook_destroy | hook.write |
edge_hook_receipt_list | hook.read |
edge_hook_receipt_get | hook.read |
Endpoints
Function runtimes are managed only through MCP. Map a handler onto /_api with edge_distribution_update and a wasm route. See Add an endpoint and Function runtimes.
| MCP tool | Scope |
|---|---|
edge_function_create | function.write |
edge_function_get | function.read |
edge_function_list | function.read |
edge_function_update | function.write |
edge_function_delete | function.write |
edge_function_invoke | function.read |
edge_function_logs | function.read |
edge_file_prefix_get | function.read |
edge_file_prefix_set | function.write |
edge_function_upload_grant_set | function.write |
edge_file_list | function.read |
edge_file_get | function.read |
edge_file_delete | function.write |
edge_job_runs | function.read |
edge_store_grant_get | function.read |
edge_store_grant_set | function.write |
edge_kv_list | function.read |
edge_kv_get | function.read |
edge_kv_put | function.write |
edge_kv_delete | function.write |
edge_sql_execute | function.read for read-only statements, function.write otherwise |
The same store, key, and SQL tools are on the HTTP API. Creating and invoking a function stays MCP-only. See Use key-value and SQL storage from a function.
Crons
A cron runs a function runtime or a platform action on a schedule. See Run a function on a schedule and Cron syntax.
| MCP tool | Scope |
|---|---|
edge_cron_create | cron.write |
edge_cron_list | cron.read |
edge_cron_get | cron.read |
edge_cron_update | cron.write |
edge_cron_delete | cron.write |
edge_cron_trigger | cron.write |
edge_cron_runs | cron.read |
edge_cron_check | cron.read |
Queues
A queue hands messages to a function runtime or an HTTPS endpoint in batches. See Process work in the background with a queue and Handle failed queue messages.
| MCP tool | Scope |
|---|---|
edge_queue_create | queue.write |
edge_queue_list | queue.read |
edge_queue_get | queue.read |
edge_queue_update | queue.write |
edge_queue_delete | queue.write |
edge_queue_send | queue.send |
edge_queue_peek | queue.read |
edge_queue_purge | queue.write |
edge_queue_redrive | queue.write |
edge_queue_stats | queue.read |
edge_queue_runs | queue.read |
Workflows
A workflow runs a function once per step, with sleeps, waits for signals and retries in between. See Build a multi-step workflow.
| MCP tool | Scope |
|---|---|
edge_workflow_start | workflow.write |
edge_workflow_list | workflow.read |
edge_workflow_get | workflow.read |
edge_workflow_signal | workflow.write |
edge_workflow_cancel | workflow.write |
edge_workflow_retry | workflow.write |
Form submissions
| MCP tool | Scope |
|---|---|
edge_submission_list | submission.read |
edge_submission_get | submission.read |
edge_submission_file_get | submission.read |
edge_submission_access_log | submission.read |
Every read is logged and counts toward a daily cap. Agents read edge://submissions and, for the upload policy, edge://runtime/uploads. A form's upload policy is set with edge_distribution_update (runtime.uploads). See Accept file uploads on a form and Let an agent read form submissions.
Access
| Tool | Scope |
|---|---|
edge_access_rule_list | access.read |
edge_access_rule_create | access.write |
edge_access_rule_delete | access.write |
edge_access_rule_check | access.read |
edge_access_revocation_list | access.read |
edge_access_session_revoke | access.write |
edge_network_rule_list | access.read |
edge_network_rule_create | access.write |
edge_network_rule_delete | access.write |
edge_network_check | access.read |
edge_network_mode_set | access.write |
Read edge://access before changing config.access or network rules; its network section has the rule kinds, evaluation order, and modes. See Access control.
Personal access tokens
| MCP tool | Scope |
|---|---|
edge_token_list | signed in; all=true needs token.admin |
edge_token_create | signed in, not with a personal access token |
edge_token_revoke | signed in; another person's token needs token.admin |
edge_token_create creates nothing until the person has agreed (confirm: true). See Create a personal access token.
Feedback
| MCP tool | Scope |
|---|---|
edge_feedback_submit | (signed in) |