Skip to main content

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.

ToolCode?What it does
search_offersNoSearch by q / category, or pass id for one offer. Public proof points may be included.
reveal_offerYesOne claim per user per coupon. POST /api/v1/offers/:id/reveal
get_productNoListing 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_categoriesNoCategories and subcategories.
list_wishesNoDemand signal. mine needs a key. Filing wishes is website-only. GET /api/v1/wishes
list_my_couponsYesImported coupons for one owned product. GET /api/v1/products/:slug/coupons
submit_productNoCreate 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_productNoPatch 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_providerWith list_my_couponsConnect/replace billing key + import, or omit token to sync.
publish_couponNoPublish/unpublish (published) and optional claim_limit.
connect_proof_pointNoConnect proof provider + first read.
update_proof_configNosync, disconnect, cadence, mode, or order.
create_reviewNoReview or reply (review_id). POST /api/v1/reviews
submit_feedbackNofeature / 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_mode with update_proof_config.
  • Filing wishes: website only (list_wishes remains 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.