# Zeodyn

> Agent commerce assessment platform. Can AI agents do business with you?

Zeodyn™ is an AI commerce readiness platform built by Virtual Factory Solutions Ltd. The primary product is the Zeodyn Scanner™, which evaluates websites across six dimensions of the Agent Commerce Stack™ framework.

## Products

- [Zeodyn Scanner](https://zeodyn.com/scan): Free tool that scans any URL and produces a Zeodyn Score™ (1–100) across six dimensions — Discovery & Access, Structured Data, Commerce Data, Protocol Support, Security & Trust, and Technical Performance.

## Public API (no auth required)

- `POST /api/scan` — Submit a URL for scanning. Rate limited to 3/day per IP without an account.
- `GET /api/results/{id}` — Retrieve a scan result by UUID.
- `GET /api/pricing` — Machine-readable pricing for all tiers and products.
- `GET /api/health` — Service health check.

## Authenticated API (Bearer token, `zd_live_` prefix)

- `POST /api/v1/scan` — Submit a URL for scanning (higher rate limits with account).
- `GET /api/v1/scan/{id}` — Retrieve a scan result.
- `GET /api/v1/scans` — List scan history with pagination.
- `POST /api/v1/batch/scan` — Submit a batch scan of up to 50 URLs per request (Growth tier).
- `GET /api/v1/batch/scan/{id}` — Check batch scan status and results.
- `GET /api/v1/batch/scans` — List batch scan history.

## Account Management API (Bearer token)

- `POST /api/v1/auth/register` — Send a magic-link sign-in email (no auth required, 3/hour rate limit).
- `GET /api/v1/account` — Get account info, tier, usage stats (limits use "unlimited" for uncapped).
- `GET /api/v1/account/plans` — List available plans with human-readable pricing (no auth required).
- `POST /api/v1/account/subscribe` — Create Stripe checkout (returns checkoutUrl, expiresAt, note) or upgrade tier.
- `POST /api/v1/account/manage` — Open Stripe billing portal (returns portalUrl, note).
- `GET /api/v1/account/api-keys` — List API keys (masked).
- `POST /api/v1/account/api-keys` — Create an API key.
- `DELETE /api/v1/account/api-keys/{id}` — Revoke an API key.

## Watched Sites API (Bearer token — preferred shorter paths)

- `GET /api/v1/watched-sites` — List watched sites with inline thresholds.
- `POST /api/v1/watched-sites` — Add a watched site (SSRF validated).
- `GET /api/v1/watched-sites/{id}` — Get site with thresholds and score history.
- `PATCH /api/v1/watched-sites/{id}` — Update label, alertEnabled, or isCompetitor.
- `DELETE /api/v1/watched-sites/{id}` — Remove a watched site (cascades to thresholds).
- `GET /api/v1/watched-sites/{id}/thresholds` — List threshold records (Growth+).
- `POST /api/v1/watched-sites/{id}/thresholds` — Create/upsert a threshold (Growth+).
- `DELETE /api/v1/watched-sites/{id}/thresholds/{thresholdId}` — Delete a threshold (Growth+).

## Webhooks API (Bearer token — preferred shorter paths)

- `GET /api/v1/webhooks` — List webhooks (Pro+).
- `POST /api/v1/webhooks` — Create a webhook (HTTPS only, SSRF validated, Pro+).
- `DELETE /api/v1/webhooks/{id}` — Delete a webhook (Pro+).
- `POST /api/v1/webhooks/{id}/test` — Test a webhook (Pro+, 5/hour rate limit).

## Legacy Account Sub-Paths (still operational)

- `GET /api/v1/account/watched-sites` — List watched sites (use /api/v1/watched-sites instead).
- `POST /api/v1/account/watched-sites` — Add a watched site.
- `GET /api/v1/account/watched-sites/{id}` — Get site with score history.
- `PATCH /api/v1/account/watched-sites/{id}` — Update a watched site.
- `DELETE /api/v1/account/watched-sites/{id}` — Remove a watched site.
- `GET /api/v1/account/watched-sites/{id}/thresholds` — Get thresholds (Growth+).
- `PUT /api/v1/account/watched-sites/{id}/thresholds` — Set thresholds (Growth+).
- `GET /api/v1/account/webhooks` — List webhooks (Pro+).
- `POST /api/v1/account/webhooks` — Create a webhook (Pro+).
- `DELETE /api/v1/account/webhooks/{id}` — Delete a webhook (Pro+).
- `POST /api/v1/account/webhooks/{id}/test` — Test a webhook (Pro+).

## Agentic Commerce (ACP)

Zeodyn implements the Agentic Commerce Protocol (ACP) for AI agent-driven purchases.

- Discovery manifest: `GET /.well-known/acp/config.json`
- 5 checkout endpoints at `/api/acp/checkouts`:
  - `POST /api/acp/checkouts` — Create a checkout session.
  - `GET /api/acp/checkouts/{id}` — Retrieve a checkout session.
  - `PUT /api/acp/checkouts/{id}` — Update a checkout session.
  - `POST /api/acp/checkouts/{id}/complete` — Complete checkout with a Stripe SharedPaymentToken.
  - `POST /api/acp/checkouts/{id}/cancel` — Cancel a checkout session.
- Products: Scanner Pro (£19/month), Scanner Growth (£49/month).
- Digital fulfilment — instant access upon payment.
- Payment via Stripe SharedPaymentTokens.
- Requires API key authentication (Bearer token, `zd_live_` prefix).
- ACP specification: https://agenticcommerce.dev

## Webhooks

Pro and Growth tiers support HMAC-SHA256 signed webhooks with these event types:
- `score_change` — Fired when a watched site's score changes (Pro+).
- `scan_complete` — Fired after every scan for a watched site (Growth+).
- `threshold_alert` — Fired when a score crosses a custom threshold (Growth+).
- `batch_complete` — Fired when a batch scan finishes (Growth+).

## Pricing

- Free: 3 scans/day, 3 watched sites, 100 API calls/month.
- Pro (£19/month): Unlimited scans, 10 watched sites, weekly re-scans, trend charts, PDF export, AI recommendations, 1,000 API calls/month.
- Growth (£49/month): Unlimited API calls, batch scanning (500 URLs), team workspaces, competitive benchmarking, 5 webhooks.
- Enterprise: Custom pricing, SLA, dedicated support.
- Machine-readable pricing: GET /api/pricing or GET /api/v1/account/plans.

## Documentation (24 pages)

- [Documentation Home](https://zeodyn.com/docs): Overview and navigation.
- [Getting Started](https://zeodyn.com/docs/getting-started): First scan guide, account setup, tier comparison.
- [Scanner Features](https://zeodyn.com/docs/scanner): Overview of scanner capabilities.
- [Watched Sites](https://zeodyn.com/docs/scanner/watched-sites): Monitor sites for score changes.
- [Trend Charts](https://zeodyn.com/docs/scanner/trend-charts): Score history visualisation.
- [Benchmarking](https://zeodyn.com/docs/scanner/benchmarking): Compare scores against competitors.
- [Batch Scanning](https://zeodyn.com/docs/scanner/batch-scanning): Scan up to 50 URLs per request.
- [PDF Export](https://zeodyn.com/docs/scanner/pdf-export): Generate score certificates.
- [AI Recommendations](https://zeodyn.com/docs/scanner/ai-recommendations): AI-enhanced improvement guidance.
- [Thresholds](https://zeodyn.com/docs/scanner/thresholds): Custom score alert thresholds.
- [API Reference](https://zeodyn.com/docs/api): Authentication, rate limits, all endpoint schemas.
- [Scan API](https://zeodyn.com/docs/api/scan): Submit and retrieve scans.
- [Results API](https://zeodyn.com/docs/api/results): Retrieve scan results by ID.
- [Batch API](https://zeodyn.com/docs/api/batch): Batch scanning endpoints.
- [Account API](https://zeodyn.com/docs/api/account): Account management, subscription, billing, API keys.
- [Watched Sites API](https://zeodyn.com/docs/api/watched-sites): CRUD for watched sites with SSRF validation.
- [Webhooks API](https://zeodyn.com/docs/api/webhooks-api): Webhook CRUD, test delivery, HMAC verification.
- [Thresholds API](https://zeodyn.com/docs/api/thresholds): Score threshold management (Growth+).
- [Webhooks Guide](https://zeodyn.com/docs/webhooks): Setup, event types, payload schemas, signature verification.
- [Teams](https://zeodyn.com/docs/teams): Team workspaces, roles, shared data.
- [MCP Server](https://zeodyn.com/docs/mcp): MCP integration guide — endpoint, authentication, 8 tools, JSON-RPC methods.
- [A2A Endpoint](https://zeodyn.com/docs/a2a): A2A integration guide — natural language tasks, intent detection, task lifecycle.
- [ACP Checkout](https://zeodyn.com/docs/acp): Agentic Commerce Protocol — checkout lifecycle, endpoints, SharedPaymentTokens, digital fulfilment.
- [FAQ](https://zeodyn.com/docs/faq): Common questions and answers.

## Agent Protocols

- [MCP Server](https://zeodyn.com/api/mcp): Model Context Protocol endpoint for native agent integration. Streamable HTTP transport, JSON-RPC 2.0. 8 tools: scan_website, get_scan_results, list_scans, get_plans, get_account, list_watched_sites, add_watched_site, compare_sites.
- [MCP Manifest](https://zeodyn.com/.well-known/mcp.json): MCP discovery manifest with tool schemas, authentication info, and provider metadata.
- [A2A Endpoint](https://zeodyn.com/api/a2a): Agent-to-Agent protocol endpoint for task-based interaction. Natural language input, JSON-RPC 2.0 methods: tasks/send, tasks/get, tasks/cancel.
- [UCP Profile](https://zeodyn.com/.well-known/ucp): Universal Commerce Protocol capability declaration.
- [A2A Agent Card](https://zeodyn.com/.well-known/agent-card.json): Google Agent-to-Agent protocol agent card with skills and A2A runtime declaration.
- [ACP Manifest](https://zeodyn.com/.well-known/acp/config.json): Agentic Commerce Protocol discovery manifest with product catalogue, payment provider, and checkout endpoints.
- [OpenAI Plugin Manifest](https://zeodyn.com/.well-known/ai-plugin.json): ChatGPT plugin discovery manifest.
- [OpenAPI Specification](https://zeodyn.com/openapi.json): Machine-readable API specification (OpenAPI 3.1, 40+ endpoints).
- [Agent Manifest](https://zeodyn.com/agent.json): Agent discovery metadata with full API catalogue.
- [Security Policy](https://zeodyn.com/.well-known/security.txt): Security contact and disclosure policy.

## Methodology

- [Agent Commerce Stack™](https://zeodyn.com/methodology): Full published methodology — six dimensions, weighted geometric mean, fail gates, scoring pipeline, and governance model.

## Blog

- [Insights](https://zeodyn.com/blog): Research, guides, and analysis on AI agent commerce.
- [What Is Agent Commerce?](https://zeodyn.com/blog/what-is-agent-commerce): A definitive guide to AI agents that discover, evaluate, and buy on behalf of consumers.
- [Zeodyn Score Explained](https://zeodyn.com/blog/zeodyn-score-explained): How the Zeodyn Score™ works — dimensions, weights, geometric aggregation, fail gates, and what your score means.
- [Shopify AI Agent Readiness](https://zeodyn.com/blog/shopify-ai-agent-readiness): Seven practical steps to prepare your Shopify store for AI agent commerce.
- [UCP vs ACP Protocol Guide](https://zeodyn.com/blog/ucp-vs-acp-protocol-guide): Google told retailers to get ready for AI shoppers.

## RSS Feed

- [RSS Feed](https://zeodyn.com/feed.xml): Subscribe to new articles via RSS.

## Key Pages

- [Homepage](https://zeodyn.com)
- [Scan](https://zeodyn.com/scan)
- [Documentation](https://zeodyn.com/docs)
- [Methodology](https://zeodyn.com/methodology)
- [Pricing](https://zeodyn.com/pricing)
- [Blog](https://zeodyn.com/blog)
- [About](https://zeodyn.com/about)
- [Press](https://zeodyn.com/press)
- [Contact](https://zeodyn.com/contact)
- [Terms](https://zeodyn.com/legal/terms)
- [Privacy](https://zeodyn.com/legal/privacy)
- [Cookie Policy](https://zeodyn.com/legal/cookies)
- [Trademark Usage](https://zeodyn.com/legal/trademark)

## Contact

- Email: hello@zeodyn.com
- Legal: legal@zeodyn.com
- Privacy: privacy@zeodyn.com