Perkadoo

com.perkadooPublished by perkadoo.comOfficial publisherv0.4.0Updated Oct 24, 2026

Manage Perkadoo giveaways, streak programs and perks, plus verifiable draws and streak badges.

VerifiedStreamable HTTPWeb executable

Overview

Perkadoo's hosted MCP server (mcp.perkadoo.com), published by perkadoo.com; no sign-in required; Streamable HTTP; 22 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
perkadoo.com
Endpoint
mcp.perkadoo.com
Last checked

Installation

In SourceWeft

  1. Open Perkadoo in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.perkadoo%2Fperkadoo/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "perkadoo": {
      "type": "http",
      "url": "https://mcp.perkadoo.com/mcp"
    }
  }
}

Tools

22

list_projects

List projects

List the Perkadoo projects available to the authenticated MCP credential.

Takes no parameters.

get_streak_performance

Read streak performance

Read the streak distribution, best streaks and progress for a program. Excludes synthetic test activity.

ParameterscampaignIdrequired

get_proof_report

Read Proof results

Read the latest holdout experiment, its sample sizes and measured return rate. Returns null when no experiment exists; never invents uplift.

ParameterscampaignIdrequired

list_programs

List streak programs

List a brand's streak programs with their event key, cadence, target and status.

ParametersbrandIdrequired

list_perks

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.

ParametersbrandIdrequired

create_perk

Create a 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.

ParameterskindrequirednamerequiredvaluerequiredbrandIdrequiredexpiresAtvalidDaysvalueCentsuniqueCodes

create_giveaway

Create a 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.

ParametersnamerequiredrulesprizesbrandIdrequiredopensAtrequiredclosesAtrequiredlanguagetimezoneentryPagedrawMethodwinnerCount

update_giveaway

Update a 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.

ParametersnamerulesprizesopensAtclosesAtlanguagetimezoneentryPagedrawMethodgiveawayIdrequiredwinnerCount

get_giveaway

Read a 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.

ParametersgiveawayIdrequired

list_giveaways

List giveaways

List a brand's giveaways, newest first, with their phase and entry counts.

ParametersbrandIdrequired

list_giveaway_entries

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.

ParameterslimitoffsetstatusgiveawayIdrequired

get_goal

Read the brand's 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.

ParametersbrandIdrequired

set_goal

Set the brand's 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.

ParametersmetricrequiredtargetrequiredbrandIdrequireddeadlinerequired

make_winners_card

Make a 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.

ParametersgiveawayIdrequired

get_draw

Read a draw result

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.

Parametersslugrequired

create_share_card

Make a 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.

Parameterssitesizethemefieldsrequiredtemplaterequired

draw_winners

Pick giveaway 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.

ParameterstitlemethodprizesentrantsrequiredwinnerCount

read_post_comments

Read a post's comments from its link

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. Instagram needs the brand's connected account instead.

Parameterslinkrequired

create_streak_badge

Start a 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.

ParametersthemetitlerequiredtimeZoneownerName

check_in_streak_badge

Check in to a 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.

Parametersslugrequiredtokenrequired

get_streak_badge

Read a streak badge

Read a Perkadoo Streak Badge: the live streak, best streak, total days and the last seven days.

Parametersslugrequired

build_prebuild_from_site

Build my giveaway and streak from my 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.

Parametersurlrequired

Version history

1
  1. v0.4.0LatestOct 21, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.