Skip to content

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 toolScope
edge_namespace_get(signed in) — returns the workspace bound to the token, not a list

Distributions ​

MCP toolScope
edge_slug_checkdistribution.read
edge_distribution_listdistribution.read
edge_distribution_createdistribution.write
edge_distribution_getdistribution.read
edge_distribution_updatedistribution.write
edge_distribution_copydistribution.write
edge_distribution_destroydistribution.destroy

Deployments ​

MCP toolScope
edge_deployment_listdeployment.read
edge_deployment_createdeployment.write
edge_deployment_checkdeployment.write
edge_deployment_getdeployment.read
edge_deployment_commitdeployment.write
edge_deployment_promotedeployment.promote
edge_deployment_diffdeployment.read
edge_deployment_rollbackdeployment.promote
edge_deployment_schedule_listdeployment.read
edge_deployment_schedule_canceldeployment.promote
edge_distribution_takedowndeployment.promote
edge_distribution_restoredeployment.promote
edge_content_listdeployment.read
edge_content_writedeployment.write
edge_content_deletedeployment.write
edge_content_getdeployment.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 toolScope
edge_document_listdocument.read
edge_document_writedocument.write
edge_document_deletedocument.write
edge_document_getdocument.read
edge_document_historydocument.read
edge_document_rollbackdocument.write
edge_document_grant_getfunction.read
edge_document_grant_setfunction.write
edge_document_prefix_getfunction.read
edge_document_prefix_setfunction.write
edge_private_document_listfunction.read
edge_private_document_getfunction.read
edge_private_document_writefunction.write
edge_private_document_deletefunction.write

See Serve a data object and Read and write data objects from a function.

Domains ​

MCP toolScope
edge_domain_listdomain.read
edge_domain_createdomain.manage
edge_domain_getdomain.read
edge_domain_verifydomain.manage
edge_domain_attachdomain.manage
edge_domain_detachdomain.manage
edge_domain_destroydomain.destroy

Checks ​

MCP toolScope
edge_distribution_invalidatedeployment.promote
edge_redirect_checkdistribution.read
edge_redirect_importdistribution.write
edge_redirect_exportdistribution.read
edge_header_checkdistribution.read
edge_health_checkanalytics.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 toolScope
edge_analytics_queryanalytics.read
edge_analytics_exploreanalytics.read
edge_analytics_realtimeanalytics.read
edge_log_listlogs.read
edge_log_getlogs.read

Goals ​

MCP toolScope
edge_goal_checkgoals.read
edge_goal_listgoals.read
edge_goal_getgoals.read
edge_goal_creategoals.write
edge_goal_upsertgoals.write
edge_goal_updategoals.write
edge_goal_archivegoals.write

Analytics groups and funnels ​

MCP toolScope
edge_group_listfunnels.read
edge_group_getfunnels.read
edge_group_createfunnels.write
edge_group_updatefunnels.write
edge_funnel_checkfunnels.read
edge_funnel_listfunnels.read
edge_funnel_getfunnels.read
edge_funnel_createfunnels.write
edge_funnel_upsertfunnels.write
edge_funnel_updatefunnels.write
edge_funnel_archivefunnels.write
edge_funnel_queryfunnels.read

Properties and PII ​

MCP toolScope
edge_property_checkanalytics.read
edge_property_listanalytics.read
edge_property_declareproperties.write
edge_property_updateproperties.write
edge_property_archiveproperties.write
edge_pii_policy_getpii.read
edge_pii_policy_setpii.policy.write
edge_pii_exemption_createpii.policy.write
edge_pii_exemption_revokepii.policy.write
edge_pii_detector_listpii.read
edge_pii_reportpii.read

Webhooks and hooks ​

Subscribing to form.* also needs form.forward, and creates nothing until confirm is true. See Events, webhooks, and hooks.

MCP toolScope
edge_webhook_listwebhook.read
edge_webhook_getwebhook.read
edge_webhook_createwebhook.write
edge_webhook_updatewebhook.write
edge_webhook_destroywebhook.write
edge_webhook_testwebhook.write
edge_webhook_rotate_secretwebhook.write
edge_webhook_delivery_listwebhook.read
edge_webhook_redeliverwebhook.write
edge_hook_listhook.read
edge_hook_gethook.read
edge_hook_createhook.write
edge_hook_updatehook.write
edge_hook_destroyhook.write
edge_hook_receipt_listhook.read
edge_hook_receipt_gethook.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 toolScope
edge_function_createfunction.write
edge_function_getfunction.read
edge_function_listfunction.read
edge_function_updatefunction.write
edge_function_deletefunction.write
edge_function_invokefunction.read
edge_function_logsfunction.read
edge_file_prefix_getfunction.read
edge_file_prefix_setfunction.write
edge_function_upload_grant_setfunction.write
edge_file_listfunction.read
edge_file_getfunction.read
edge_file_deletefunction.write
edge_job_runsfunction.read
edge_store_grant_getfunction.read
edge_store_grant_setfunction.write
edge_kv_listfunction.read
edge_kv_getfunction.read
edge_kv_putfunction.write
edge_kv_deletefunction.write
edge_sql_executefunction.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 toolScope
edge_cron_createcron.write
edge_cron_listcron.read
edge_cron_getcron.read
edge_cron_updatecron.write
edge_cron_deletecron.write
edge_cron_triggercron.write
edge_cron_runscron.read
edge_cron_checkcron.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 toolScope
edge_queue_createqueue.write
edge_queue_listqueue.read
edge_queue_getqueue.read
edge_queue_updatequeue.write
edge_queue_deletequeue.write
edge_queue_sendqueue.send
edge_queue_peekqueue.read
edge_queue_purgequeue.write
edge_queue_redrivequeue.write
edge_queue_statsqueue.read
edge_queue_runsqueue.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 toolScope
edge_workflow_startworkflow.write
edge_workflow_listworkflow.read
edge_workflow_getworkflow.read
edge_workflow_signalworkflow.write
edge_workflow_cancelworkflow.write
edge_workflow_retryworkflow.write

Form submissions ​

MCP toolScope
edge_submission_listsubmission.read
edge_submission_getsubmission.read
edge_submission_file_getsubmission.read
edge_submission_access_logsubmission.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 ​

ToolScope
edge_access_rule_listaccess.read
edge_access_rule_createaccess.write
edge_access_rule_deleteaccess.write
edge_access_rule_checkaccess.read
edge_access_revocation_listaccess.read
edge_access_session_revokeaccess.write
edge_network_rule_listaccess.read
edge_network_rule_createaccess.write
edge_network_rule_deleteaccess.write
edge_network_checkaccess.read
edge_network_mode_setaccess.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 toolScope
edge_token_listsigned in; all=true needs token.admin
edge_token_createsigned in, not with a personal access token
edge_token_revokesigned 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 toolScope
edge_feedback_submit(signed in)

See also ​