Perkadoo
Manage Perkadoo giveaways, streak programs and perks, plus verifiable draws and streak badges.
| Endpoint | https://mcp.perkadoo.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.4.0 |
| Now | 22 tools · grade C (73) · pin ts_4404914695f33b9efe3ed17ac8d92c1d · protocol 2025-06-18 |
| First / last listed | 2026-10-28 01:14 UTC / 2026-10-28 01:14 UTC |
| Grade over time | 2026-10-28: C (73), 22 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: list_projects get_streak_performance get_proof_report list_programs list_perks create_perk create_giveaway update_giveaway get_giveaway list_giveaways list_giveaway_entries get_goal set_goal make_winners_card get_draw create_share_card draw_winners read_post_comments create_streak_badge check_in_streak_badge get_streak_badge build_prebuild_from_site
list_projects | List the Perkadoo projects available to the authenticated MCP credential. params: none |
get_streak_performance | Read the streak distribution, best streaks and progress for a program. Excludes synthetic test activity. params: campaignId* |
get_proof_report | Read the latest holdout experiment, its sample sizes and measured return rate. Returns null when no experiment exists; never invents uplift. params: campaignId* |
list_programs | List a brand's streak programs with their event key, cadence, target and status. params: brandId* |
list_perks | List a brand's perks with how many have been granted, revealed to members and redeemed, and for coupons with a code pool, how many codes are left and how many grants are waiting for one. params: brandId* |
create_perk | Create a reward a brand can give members: a coupon code, a link or a message. Milestone rewards set in the dashboard are perks too. params: brandId*, name*, kind*, value*, expiresAt, valueCents, validDays, uniqueCodes |
create_giveaway | Draft a hosted giveaway: prize, dates, draw, entry page, bonus entries and official rules. It starts as a draft with a preview link. A signed-in person approves it at dashboardUrl before it goes live; send them that link. params: brandId*, name*, opensAt*, closesAt*, timezone, language, drawMethod, winnerCount, prizes, rules, entryPage |
update_giveaway | Change a giveaway before it's drawn. Changing its dates, draw, prizes, rules or bonus entries clears its approval and returns it to draft; pause a live giveaway first. Headline, description, image and colour can change any time. params: giveawayId*, name, opensAt, closesAt, timezone, language, drawMethod, winnerCount, prizes, rules, entryPage |
get_giveaway | Read a giveaway with its phase, approval, links, winners and numbers: entrants, entries, sources, entries by day, top referrers and flagged entries. dashboardUrl is where a signed-in person approves it or, once approved, draws it. params: giveawayId* |
list_giveaways | List a brand's giveaways, newest first, with their phase and entry counts. params: brandId* |
list_giveaway_entries | List a giveaway's entries, newest first, with email, entries, source, referrer, status and risk signals. Filter by status to review flagged entries. params: giveawayId*, status, limit, offset |
get_goal | See how many new faces or returning members a brand has toward its goal, the target, the deadline and whether it's on pace. Returns null when no goal is set. params: brandId* |
set_goal | Aim a brand at more new faces or more returning members: a number to reach by a deadline. Doo plans around it and Home tracks it. Replaces the current goal, which is kept as history. params: brandId*, metric*, target*, deadline* |
make_winners_card | Make a square card announcing a drawn giveaway's winners, with emails masked: a public page link and a PNG to post. It publishes nothing itself. params: giveawayId* |
get_draw | Read and verify a Winner Picker result from its public slug. If randomness is now available, completes the previously committed draw. Returns the original winners and share image; never picks a replacement winner. params: slug* |
create_share_card | Make a card for a win, streak, perk, giveaway entry or winner announcement. Returns a public page and PNG image in square, story or link size. Uses supplied text; it does not verify a winner, grant a perk or publish a social post. Never put private tokens or coupon codes in a card. params: template*, size, theme, fields*, site |
draw_winners | Pick random winners from a list of names with Perkadoo's Winner Picker. The draw uses public drand randomness that didn't exist when the names were locked in, so anyone can check it. Returns the winners and a public results link to share. params: entrants*, winnerCount, method, prizes, title |
read_post_comments | Read every top-level comment on a public post from its link, with no account: YouTube videos. Returns the post (title, the account that posted it) and each comment's handle, text and time, ready for draw_winners or a comment picker. An Instagram post needs its owner: the answer is a link for them to pick a verifiable winner from that post. params: link* |
create_streak_badge | Start a personal streak for any habit with Perkadoo's Streak Badge, no account needed. Returns a public streak page, a live SVG badge for a README or website, and a private check-in link. The check-in link is the only way to check in, so tell the person to save it. params: title*, ownerName, timeZone, theme |
check_in_streak_badge | Check in today on a Perkadoo Streak Badge with its private token. One check-in per day in the streak's time zone; checking in again the same day changes nothing. Missing a day starts the streak over. params: slug*, token* |
get_streak_badge | Read a Perkadoo Streak Badge: the live streak, best streak, total days and the last seven days. params: slug* |
build_prebuild_from_site | Give Doo your site's address. Doo reads it and builds your giveaway, daily streak and perks in your brand colors, then returns a private preview link. Nothing goes live until you make it yours from that page. params: url* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.