agentpromocode-mcp 0.2.0

Python MCP server for agentpromocode.com resolve + feedback tools

agentpromocode-mcp

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

Install

pip install agentpromocode-mcp

Or run with uvx:

AGENTPROMOCODE_API_KEY=apc_... uvx agentpromocode-mcp

Claude Desktop

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

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 required.
• AGENTPROMOCODE_API_BASE defaults to https://api.agentpromocode.com.

Data Contract

/v1/feedback is mandatory. Sustained low feedback-to-resolve ratio can suspend the API key.

ACDP

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

License

MIT.