agentpromocode-mcp

Agents shouldn't pay full price. Python MCP server for the incentive layer for agentic commerce — resolve before checkout, feedback after.

Runs without an API key in the anonymous demo tier. Create a free key at https://agentpromocode.com/start for higher limits and consumer-level feedback health.

Install

pip install agentpromocode-mcp

Or run with uvx:

uvx agentpromocode-mcp

Claude Desktop

{
  "mcpServers": {
    "agentpromocode": {
      "command": "uvx",
      "args": ["agentpromocode-mcp"]
    }
  }
}

Tools

• resolve(domain, basket?, agent_id?) → POST /v1/resolve
• feedback(attribution_token, code?, outcome, basket_value?, geo?) → POST /v1/feedback

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

Env

• AGENTPROMOCODE_API_KEY is optional; omit it for anonymous demo tier.
• AGENTPROMOCODE_API_BASE defaults to https://api.agentpromocode.com.

Data Contract

/v1/feedback is mandatory for serious keyed integrations. Sustained low feedback-to-resolve ratio can suspend an API key.

ACDP

• Spec: https://agentpromocode.com/acdp
• OpenAPI: https://api.agentpromocode.com/openapi.json

License

MIT.