{"_id":"@agentpromocode/mcp","_rev":"2-84b15856173934581bd3c825efebc25b","name":"@agentpromocode/mcp","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.0":{"name":"@agentpromocode/mcp","version":"0.2.0","keywords":["mcp","coupon","promo-code","discount","agent-commerce","acdp","cloudflare-workers"],"_id":"@agentpromocode/mcp@0.2.0","maintainers":[{"name":"fedepellegrini","email":"federico.pellegrini@outlook.com"}],"homepage":"https://agentpromocode.com","bugs":{"url":"https://github.com/agentpromocode/agentpromocode/issues"},"bin":{"agentpromocode-mcp":"dist/index.js"},"dist":{"shasum":"9722d61d59d1de34c7783fd9a7167f51611ef7ec","tarball":"https://registry.npmjs.org/@agentpromocode/mcp/-/mcp-0.2.0.tgz","fileCount":4,"integrity":"sha512-iud9gXc9czsIb99RW8wE2icj1rgTPOZdNVvlMkoZKtE1NALMMzb0C0XhwqrRTDg2CcpSMKyfM3XRIYIHHPGhCg==","signatures":[{"sig":"MEUCIQDrxhc7lEGb0b6MtLUk6W6anhwZfE4WIjjapt8lxIKApQIga/tTs+IeTr6MLGLJU6aMfpLSglAybmjCap61cAVXObU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6599},"type":"module","engines":{"node":">=20"},"gitHead":"3aa48243bc9e475f9a3aa19541f4559ad5e9472b","scripts":{"dev":"tsx src/index.ts","lint":"echo ok","build":"tsup","prepublishOnly":"tsup"},"_npmUser":{"name":"fedepellegrini","email":"federico.pellegrini@outlook.com"},"repository":{"url":"git+https://github.com/agentpromocode/agentpromocode.git","type":"git","directory":"apps/mcp-server"},"_npmVersion":"10.8.2","description":"MCP server for agentpromocode.com — resolve + feedback tools","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","tsup":"^8.3.5","typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1778173812427_0.8768442917862522","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agentpromocode/mcp","version":"0.2.1","mcpName":"io.github.fedepellegrini/agentpromocode","description":"MCP server for agentpromocode.com — resolve + feedback tools","type":"module","bin":{"agentpromocode-mcp":"dist/index.js"},"scripts":{"build":"tsup","dev":"tsx src/index.ts","lint":"echo ok","prepublishOnly":"tsup"},"keywords":["mcp","coupon","promo-code","discount","agent-commerce","acdp","cloudflare-workers"],"repository":{"type":"git","url":"git+https://github.com/agentpromocode/agentpromocode.git","directory":"apps/mcp-server"},"homepage":"https://agentpromocode.com","bugs":{"url":"https://github.com/agentpromocode/agentpromocode/issues"},"dependencies":{"@modelcontextprotocol/sdk":"^1.6.1","zod":"^3.24.1"},"devDependencies":{"@types/node":"^22.10.2","tsup":"^8.3.5","tsx":"^4.19.2","typescript":"^5.7.2"},"engines":{"node":">=20"},"publishConfig":{"access":"public"},"_id":"@agentpromocode/mcp@0.2.1","gitHead":"16bd74cc790f3d0de48cbff4a07c3c4a10891506","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-uRF0e6iI+ybrN6e37fA8DM2Jx6F0Oi/YVhYKJRPB3acyjTIJfONLZkz9/KYfRQsiBbwuHjZv2HufK8NIpUDJ2Q==","shasum":"8ee4a421bd6a90c114b5240f5db9e6e8a90c7abb","tarball":"https://registry.npmjs.org/@agentpromocode/mcp/-/mcp-0.2.1.tgz","fileCount":4,"unpackedSize":6655,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDT+tXGjf0gmpSy57K2c7epOeRyrd+l6ANEsRxKrO502AiBKLY/nXsxVPqfOT/d/TuqkcvSSWgjWajH6iM/1pTs67g=="}]},"_npmUser":{"name":"fedepellegrini","email":"federico.pellegrini@outlook.com"},"directories":{},"maintainers":[{"name":"fedepellegrini","email":"federico.pellegrini@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.1_1778199535277_0.11754571401026714"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-07T17:10:12.340Z","modified":"2026-05-08T00:18:55.555Z","0.2.0":"2026-05-07T17:10:12.571Z","0.2.1":"2026-05-08T00:18:55.429Z"},"bugs":{"url":"https://github.com/agentpromocode/agentpromocode/issues"},"homepage":"https://agentpromocode.com","keywords":["mcp","coupon","promo-code","discount","agent-commerce","acdp","cloudflare-workers"],"repository":{"type":"git","url":"git+https://github.com/agentpromocode/agentpromocode.git","directory":"apps/mcp-server"},"description":"MCP server for agentpromocode.com — resolve + feedback tools","maintainers":[{"name":"fedepellegrini","email":"federico.pellegrini@outlook.com"}],"readme":"# @agentpromocode/mcp\n\nStdio MCP server for agent checkout: resolve plausible public promo offers, then report whether the offer worked.\n\n## Install In Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"agentpromocode\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentpromocode/mcp\"],\n      \"env\": {\n        \"AGENTPROMOCODE_API_KEY\": \"apc_...\",\n        \"AGENTPROMOCODE_API_BASE\": \"https://api.agentpromocode.com\"\n      }\n    }\n  }\n}\n```\n\n## Install In Cursor\n\nAdd this server to your Cursor MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentpromocode\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentpromocode/mcp\"],\n      \"env\": {\n        \"AGENTPROMOCODE_API_KEY\": \"apc_...\",\n        \"AGENTPROMOCODE_API_BASE\": \"https://api.agentpromocode.com\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### `resolve`\n\nCalls `POST /v1/resolve`.\n\nInput:\n\n```json\n{\n  \"domain\": \"nike.com\",\n  \"basket\": { \"value\": 99, \"currency\": \"USD\" },\n  \"agent_id\": \"optional-agent-id\"\n}\n```\n\nReturns ranked offer candidates, confidence labels, and an `attribution_token`.\n\n### `feedback`\n\nCalls `POST /v1/feedback`.\n\nInput:\n\n```json\n{\n  \"attribution_token\": \"atk_...\",\n  \"code\": \"WELCOME10\",\n  \"outcome\": \"worked\",\n  \"basket_value\": 99,\n  \"geo\": \"US\"\n}\n```\n\n`outcome` must be one of `worked`, `expired`, `ineligible`, or `error`.\n\n## Env\n\n- `AGENTPROMOCODE_API_KEY` (**required**)\n- `AGENTPROMOCODE_API_BASE` (optional, default `https://api.agentpromocode.com`)\n\n## The Data Contract\n\n`/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.\n\n## ACDP\n\nThis package is an MCP wrapper around the Agent Commerce Discount Protocol (ACDP) reference implementation.\n\n- Spec: `https://github.com/agentpromocode/acdp`\n- OpenAPI: `https://api.agentpromocode.com/openapi.json`\n- Discovery: `https://agentpromocode.com/llms.txt`\n\n## Local\n\n```bash\npnpm install\npnpm build\nAGENTPROMOCODE_API_KEY=apc_... node dist/index.js\n```\n\n## Publish\n\n```bash\npnpm build\nnpm publish --access public\n```\n\n## License\n\nMIT.\n","readmeFilename":"README.md"}