# Perkadoo

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

- name: com.perkadoo/perkadoo
- version: 0.4.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 88/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.perkadoo%2Fperkadoo
- tools: https://api.protogrid.dev/v1/servers/com.perkadoo%2Fperkadoo/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

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


## Trust

- hygiene: 80
- liveness: 98
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-96% +updated-24d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 88/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 25 of 25 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 5,538 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: 83 (weight 15)

- warn `stability.changes`: 23 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name
- pass `stability.new_links`: no tool change named a new site

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 25, about 5,538 tokens to load them all
- tool set hash: bdb758c8351a012b040f1d3caed6c2fd
- tools last changed: 2026-11-04T23:03:58.667Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.perkadoo/perkadoo.svg)](https://protogrid.dev/servers/com.perkadoo/perkadoo)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-04 `draw_from_post` added
  - Pick random winners from the people who commented on a public post, from its link, with no account: YouTube videos, Bluesky posts and Reddit threads. Each commenter gets one entry. Reads the comments and draws in one step, with public drand randomness anyone can check. Returns the winners and a public results link to share. An Instagram post needs its owner: the answer is a link for them.
- 2026-11-04 `spin_wheel` added
  - Spin a wheel of choices with Perkadoo's Spin the Wheel and land on one, like a prize, a name or where to eat. A choice listed twice has two slices. Uses public drand randomness, so anyone can check it. Returns where it landed and a public results link to share.
- 2026-11-04 `pick_random_numbers` added
  - Pick one or more random whole numbers in a range with Perkadoo's Random Number Generator, like 1 to 100. Several numbers never repeat. Uses public drand randomness, so anyone can check it. Returns the numbers and a public results link to share.
- 2026-11-04 `draw_winners` changed (outputSchema)
- 2026-11-01 `read_post_comments` changed (description, inputSchema)
  - before: 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.
  - after: Read every top-level comment on a public post from its link, with no account: YouTube videos, Bluesky posts and Reddit threads (where this server has a Reddit app). 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.
- 2026-10-28 `update_giveaway` changed (description, inputSchema)
  - before: 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.
  - after: 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 color can change any time.
- 2026-10-28 `create_giveaway` changed (inputSchema)
- 2026-10-26 `get_streak_badge` changed (annotations)
- 2026-10-26 `read_post_comments` changed (annotations)
- 2026-10-26 `create_share_card` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/com.perkadoo%2Fperkadoo/changes

## Remotes

- https://mcp.perkadoo.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.95604396)

## Packages

_none_

## Tools (25)

- `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.
- `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.
- `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.
- `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.
- `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.
- `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.
- `draw_from_post`: Pick random winners from the people who commented on a public post, from its link, with no account: YouTube videos, Bluesky posts and Reddit threads. Each commenter gets one entry. Reads the comments and draws in one step, with public drand randomness anyone can check. Returns the winners and a public results link to share. An Instagram post needs its owner: the answer is a link for them.
- `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.
- `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.
- `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.
- `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.
- `get_proof_report`: Read the latest holdout experiment, its sample sizes and measured return rate. Returns null when no experiment exists; never invents uplift.
- `get_streak_badge`: Read a Perkadoo Streak Badge: the live streak, best streak, total days and the last seven days.
- `get_streak_performance`: Read the streak distribution, best streaks and progress for a program. Excludes synthetic test activity.
- `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.
- `list_giveaways`: List a brand's giveaways, newest first, with their phase and entry counts.
- `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.
- `list_programs`: List a brand's streak programs with their event key, cadence, target and status.
- `list_projects`: List the Perkadoo projects available to the authenticated MCP credential.
- `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.
- `pick_random_numbers`: Pick one or more random whole numbers in a range with Perkadoo's Random Number Generator, like 1 to 100. Several numbers never repeat. Uses public drand randomness, so anyone can check it. Returns the numbers and a public results link to share.
- `read_post_comments`: Read every top-level comment on a public post from its link, with no account: YouTube videos, Bluesky posts and Reddit threads (where this server has a Reddit app). 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.
- `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.
- `spin_wheel`: Spin a wheel of choices with Perkadoo's Spin the Wheel and land on one, like a prize, a name or where to eat. A choice listed twice has two slices. Uses public drand randomness, so anyone can check it. Returns where it landed and a public results link to share.
- `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 color can change any time.