@agentpromocode/mcp

@agentpromocode/mcp

Stdio MCP server for agent checkout: resolve plausible public promo offers, then report whether the offer worked.

Install In Claude Desktop

{
  "mcpServers": {
    "agentpromocode": {
      "command": "npx",
      "args": ["-y", "@agentpromocode/mcp"],
      "env": {
        "AGENTPROMOCODE_API_KEY": "apc_...",
        "AGENTPROMOCODE_API_BASE": "https://api.agentpromocode.com"
      }
    }
  }
}

Install In Cursor

Add this server to your Cursor MCP configuration:

{
  "mcpServers": {
    "agentpromocode": {
      "command": "npx",
      "args": ["-y", "@agentpromocode/mcp"],
      "env": {
        "AGENTPROMOCODE_API_KEY": "apc_...",
        "AGENTPROMOCODE_API_BASE": "https://api.agentpromocode.com"
      }
    }
  }
}

Tools

resolve

Calls POST /v1/resolve.

Input:

{
  "domain": "nike.com",
  "basket": { "value": 99, "currency": "USD" },
  "agent_id": "optional-agent-id"
}

Returns ranked offer candidates, confidence labels, and an attribution_token.

feedback

Calls POST /v1/feedback.

Input:

{
  "attribution_token": "atk_...",
  "code": "WELCOME10",
  "outcome": "worked",
  "basket_value": 99,
  "geo": "US"
}

outcome must be one of worked, expired, ineligible, or error.

Env

• AGENTPROMOCODE_API_KEY (required)
• AGENTPROMOCODE_API_BASE (optional, default https://api.agentpromocode.com)

The Data Contract

/v1/feedback is mandatory. Sustained low feedback-to-resolve ratio can suspend the API key because feedback is what turns unverified public offers into a reliable agent-commerce dataset.

ACDP

This package is an MCP wrapper around the Agent Commerce Discount Protocol (ACDP) reference implementation.

• Spec: https://github.com/agentpromocode/acdp
• OpenAPI: https://api.agentpromocode.com/openapi.json
• Discovery: https://agentpromocode.com/llms.txt

Local

pnpm install
pnpm build
AGENTPROMOCODE_API_KEY=apc_... node dist/index.js

Publish

pnpm build
npm publish --access public

License

MIT.