Metadata-Version: 2.4
Name: agentpromocode-mcp
Version: 0.2.0
Summary: Python MCP server for agentpromocode.com resolve + feedback tools
Project-URL: Homepage, https://agentpromocode.com
Project-URL: Repository, https://github.com/agentpromocode/agentpromocode
Project-URL: Spec, https://github.com/agentpromocode/acdp
Author: agentpromocode
License-Expression: MIT
License-File: LICENSE
Keywords: acdp,agent-commerce,coupon,discount,mcp,promo-code
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.6
Requires-Dist: pydantic>=2.7
Description-Content-Type: text/markdown

# agentpromocode-mcp

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

## Install

```bash
pip install agentpromocode-mcp
```

Or run with `uvx`:

```bash
AGENTPROMOCODE_API_KEY=apc_... uvx agentpromocode-mcp
```

## Claude Desktop

```json
{
  "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.
