Ambit Signal

api | install-astro | install-caddy | install-cloudflare | install-express | install-js-tag | install-netlify | install-nginx | install-shopify | install-squarespace | install-sveltekit | install-vercel-next | install-webflow | install-wix | install-wordpress | mcp | outcomes | privacy | quickstart | troubleshooting

Install: Cloudflare Worker (any origin behind Cloudflare)

Collection: server collector (sees bots and humans). Replace example.com and st_YOURSITEID with your site's values (dashboard, list_sites, or GET /v1/sites). The MCP tool get_install_snippet(platform="cloudflare", site_id=...) returns this page pre-filled.

Steps

  1. Cloudflare dashboard > Workers & Pages > Create > Worker. Name it ambit-signal.
  2. Replace the Worker code with worker.js from @ambit/signal (collectors/cloudflare-worker/worker.js) and deploy.
  3. Settings > Variables: add AMBIT_SIGNAL_SITE (text) and AMBIT_SIGNAL_SECRET (type Secret).
  4. Settings > Triggers > Routes: add example.com/ and www.example.com/ (the zone must be proxied, orange cloud).
  5. Or with Wrangler: npx wrangler deploy, then npx wrangler secret put AMBIT_SIGNAL_SECRET.

File: wrangler.toml

name = "ambit-signal"
main = "worker.js"
compatibility_date = "2026-09-01"
routes = [
  { pattern = "example.com/*", zone_name = "example.com" },
  { pattern = "www.example.com/*", zone_name = "example.com" },
]

[vars]
AMBIT_SIGNAL_SITE = "example.com"
# AMBIT_SIGNAL_SECRET: set with `wrangler secret put`

Configuration

Name Value
AMBIT_SIGNAL_SITE example.com
AMBIT_SIGNAL_SECRET <SECRET>

<SECRET> is the site secret shown once when the site was created. Lost it? Rotate it in the dashboard (Site > Keys) or ask ambit; the old secret stops working immediately.

Verify

Load any page of example.com once, then check: MCP tool verify_install(site_id="st_YOURSITEID") or GET https://signal.ambit.agency/v1/sites/st_YOURSITEID/status with your API key. "receiving": true means events are arriving (usually within a minute).

curl -s -H "Authorization: Bearer $AMBIT_SIGNAL_API_KEY" \
  https://signal.ambit.agency/v1/sites/st_YOURSITEID/status

Expected: "receiving": true. If not, see troubleshooting.

Notes