Tools
The remote server speaks MCP at https://mcp.dealpuffin.com/mcp. Matching HTTP routes live under /api/v1 where noted. A tool that is off for the API key is hidden from tools/list and rejected on tools/call.
Every tool includes a title and either readOnlyHint or destructiveHint for Claude Connectors directory review. Read and write stay in separate tools.
| Tool | Code? | What it does |
|---|---|---|
search_offers | No | Search by q / category, or pass id for one offer. Public proof points may be included. |
reveal_offer | Yes | One claim per user per coupon. POST /api/v1/offers/:id/reveal |
get_product | No | Listing copy, media, public proofs, reviews, verification_status. Public https listings (pending or verified); owners also get dns + http ownership instructions when pending. GET /api/v1/products/:slug |
list_categories | No | Categories and subcategories. |
list_wishes | No | Demand signal. mine needs a key. Filing wishes is website-only. GET /api/v1/wishes |
list_my_coupons | Yes | Imported coupons for one owned product. GET /api/v1/products/:slug/coupons |
submit_product | No | Create listing. Copy, logo, video, and screenshots autofill from the page. Optional free_for_now. Ownership verify (DNS or well-known file) is optional. POST /api/v1/products |
update_product | No | Patch listing, screenshots, video, hidden, free_for_now, ownership verify (DNS or well-known file), badge (badge_page_url, verify_badge). PATCH /api/v1/products/:slug |
connect_coupon_provider | With list_my_coupons | Connect/replace billing key + import, or omit token to sync. |
publish_coupon | No | Publish/unpublish (published) and optional claim_limit. |
connect_proof_point | No | Connect proof provider + first read. |
update_proof_config | No | sync, disconnect, cadence, mode, or order. |
create_review | No | Review or reply (review_id). POST /api/v1/reviews |
submit_feedback | No | feature / issue / friction. POST /api/v1/feedback |
Public offer JSON uses provider_max_redemptions, provider_expires, and provider_times_redeemed for billing-provider limits, plus verification_status. Public proof points include the value only for exact; bands include label and color (when applicable), not the number; hidden points are omitted. When free_for_now is set and MRR is 0, the public label is Free for now instead of $0 / 0-1k.
Intentional agent limits
- Banded proof points: non-owner agents do not receive the exact reading.
- Hidden proof points: seekers and agents do not receive the point at all; the owner's agent can still change
display_modewithupdate_proof_config. - Filing wishes: website only (
list_wishesremains for demand). - API key create/revoke and OAuth agent revoke: Settings in the browser.
- Sign-in / session cookies: host OAuth or bearer key.
See Agent parity gaps for any remaining UI-only work.