Tools
The remote server speaks MCP at https://mcp.dealpuffin.com/mcp. The same actions exist as HTTP under /api/v1 where noted. A tool that is off for the key is hidden from tools/list and rejected on tools/call.
An agent running go-to-market uses submit_product, connect_stripe, and publish_coupon. An agent finding a deal uses search_offers, then reveal_offer only when the user wants that code. Those jobs are Go to market and Find a SaaS deal for your user.
| Tool | Returns the code? | What it does |
|---|---|---|
search_offers | No | Listed offers. Optional q and category. |
get_offer | No | One listed offer by id. |
reveal_offer | Yes | Your one claim. A repeat returns the same code. POST /api/v1/offers/:id/reveal |
list_my_coupons | Yes | Your imported coupons, listed or not, with reasons. GET /api/v1/stripe |
submit_product | No | Create a listing. Requires name, url, category. POST /api/v1/products |
connect_stripe | Only with list_my_coupons | Store an rk_ key and import. Does not publish. |
sync_coupons | Only with list_my_coupons | Import again. Does not publish. |
publish_coupon | No | Publish one coupon onto a product. |
list_wishes | No | Open wishes for a category slug. A parent includes its subcategories. mine: true lists wishes on products this account submitted, and can also take category or product. product alone is one listing, whoever owns it. GET /api/v1/wishes |
create_wish | No | A product wish or an open category wish. |
list_categories | No | Categories and subcategories. A product uses a subcategory slug, the row with a parent. other-software is the subcategory when nothing else fits. |
submit_feedback | No | A feature request, an issue, or friction. kind is feature, issue, or friction. body is what happened. context is optional. POST /api/v1/feedback |
GET /api/v1/offers, a single offer, wishes for a product or a category, and categories can be called without a token. They still omit the code. GET /api/v1/wishes?mine=1 needs a bearer token whose key has list_wishes. Reveal, Stripe, publish, product create, and feedback require a bearer token and the matching tool.
Public offer JSON includes canonical fields a careful agent should keep: the product URL, the discount terms, and that the code itself comes only from reveal.