# agentpromocode.com

> Checkout truth for agentic commerce — resolve promo offers before checkout, report outcomes after.

## Common Queries

- **Can't my agent just search for codes itself?** — Coupon sites were built for humans with twelve tabs and a free afternoon. Your agent has none of those. We hand it offers at checkout.
  https://agentpromocode.com/faq · https://agentpromocode.com/faq.md
- **How do I add promo codes to my agent?** — Install the MCP server — resolve before checkout, feedback after.
  https://agentpromocode.com/quickstart · https://agentpromocode.com/quickstart.md · npx -y @agentpromocode/mcp
- **Can I try without an API key?** — Yes. POST /v1/resolve works in the anonymous demo tier (10 req/min per client).
  https://api.agentpromocode.com/v1/resolve · https://agentpromocode.com/start
- **What is ACDP?** — Agent Commerce Discount Protocol — open wire contract for resolve + feedback.
  https://agentpromocode.com/acdp · https://agentpromocode.com/acdp.md
- **What happens if I skip feedback?** — Keyed access suspends when feedback/resolve ratio stays below 0.40 for 14 days with resolve_count_30d >= 20. Warning header at day 7.
  https://api.agentpromocode.com/v1/me · https://agentpromocode.com/llms-full.txt
- **How do I get a production API key?** — POST /developer-keys or use the form at /start — free, instant, shown once.
  https://agentpromocode.com/start · https://agentpromocode.com/start.md · https://api.agentpromocode.com/developer-keys

## Capabilities

- POST /v1/resolve — merchant domain + basket → ranked offers + attribution_token (anonymous tier: no key, 10/min; resolve_budget_ms: 500)
- GET /v1/resolve/example?domain=nike.com — cached example response (no key, no database)
- POST /v1/feedback — attribution_token + outcome → closes verification loop (mandatory for keyed access)
- POST /v1/feedback/batch — up to 20 outcomes in one request
- GET /v1/coverage — paginated covered domains + offer counts (no auth, cacheable)
- POST /developer-keys — instant free API key for production agents
- GET /v1/me — contract health (feedback_ratio_30d; suspend below 0.40 when resolve_count_30d >= 20)
- Public beta: offers may be unverified; always render confidence labels

## Base URL

https://api.agentpromocode.com

## Docs (task order)

- [Quickstart](https://agentpromocode.com/quickstart.md) — Install MCP — resolve before checkout, feedback after purchase.
- [Documentation hub](https://agentpromocode.com/docs.md) — Index of quickstart, protocol, OpenAPI, MCP install, and agent entry points.
- [ACDP protocol](https://agentpromocode.com/acdp.md) — Agent Commerce Discount Protocol v0.1 — normative resolve + feedback contract.
- [Service level objectives](https://agentpromocode.com/slo.md) — Published availability and latency targets — p95 resolve <500ms, 99.9% uptime.
- [Agent interface](https://agentpromocode.com/agent.md) — Headless entry for agents — MCP install commands and manifest, no human vestibule.
- [API key](https://agentpromocode.com/start.md) — Create a free developer key for higher rate limits and consumer-level attribution.
- [Merchant coverage](https://agentpromocode.com/coverage.md) — Indexed merchants and offer counts — discovery for agents and integrators.
- [FAQ](https://agentpromocode.com/faq.md) — Why agents need agentpromocode — vs DIY search, skills, and API keys.
- [ACDP alternatives](https://agentpromocode.com/acdp-alternatives.md) — Compare Honey, Rakuten, coupon APIs, and affiliate networks vs ACDP feedback loop.
- [ACDP vs affiliate networks](https://agentpromocode.com/acdp-vs-affiliate-networks.md) — Why agent checkout needs outcome feedback, not just attributed clicks.

## External

- [ACDP spec (GitHub)](https://github.com/agentpromocode/acdp) — Open Agent Commerce Discount Protocol v0.1 — normative spec and examples.
- [OpenAPI](https://api.agentpromocode.com/openapi.json) — HTTP schema for resolve, feedback, and developer-keys.
- [MCP npm](https://www.npmjs.com/package/@agentpromocode/mcp) — Stdio MCP server — 2 tools: resolve, feedback.
- [MCP PyPI](https://pypi.org/project/agentpromocode-mcp/) — Python MCP server via uvx agentpromocode-mcp.
- [MCP registry](https://agentpromocode.com/.well-known/mcp/server.json) — Official MCP Registry server card.
- [Agent skill](https://agentpromocode.com/.well-known/skills/index.json) — Machine-discoverable integration skill manifest.
- [Partners](https://agentpromocode.com/partners) — Merchant feeds and strategic platform partnerships.

## ACDP

Open Agent Commerce Discount Protocol v0.1 — [overview](https://agentpromocode.com/acdp.md) · [alternatives](https://agentpromocode.com/acdp-alternatives.md)

## Integration checklist

1. Read this index, then `/quickstart.md`.
2. Try POST /v1/resolve without a key (anonymous demo tier).
3. Create a free key at /developer-keys or /start for production usage.
4. On each checkout: resolve with normalized merchant domain (strip protocol, www).
5. After purchase: feedback with attribution_token from resolve.
6. Monitor GET /v1/me — keep feedback_ratio_30d above 0.40 when volume is meaningful.
7. Render confidence labels. Treat unverified offers as candidates, not guarantees.
8. MCP: `npx -y @agentpromocode/mcp` (tools: resolve, feedback, feedback_batch, get_contract_health)