Manage Perkadoo giveaways, streak programs and perks, plus verifiable draws and streak badges.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
Your site's address, like yoursite.com.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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.
| Argument | Type | Description |
|---|---|---|
| url* | string | Your site's address, like yoursite.com. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Your site's address, like yoursite.com."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The streak's public slug, from its link /s/<slug>. |
| token* | string | The secret token from the private check-in link. |
{
"type": "object",
"required": [
"slug",
"token"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 40,
"description": "The streak's public slug, from its link /s/<slug>."
},
"token": {
"type": "string",
"maxLength": 200,
"description": "The secret token from the private check-in link."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | The giveaway's name, shown as its title. |
| rules | object | The official rules. sponsorCountry and countries default to the brand's own country. A person approves them before the giveaway goes live. |
| prizes | array | One prize per place for placed draws; otherwise the first prize goes to every winner. |
| brandId* | string | Brand ID, the project that runs the giveaway. |
| opensAt* | string | When entries open, as an ISO 8601 time. |
| closesAt* | string | When entries close, as an ISO 8601 time. Must be after opensAt. |
| language | string | The language entrants see: en or es. Left out, the language of the brand's country, else en. |
| timezone | string | The time zone the official rules and dashboard use, e.g. Europe/London. Left out, the brand's own: from its site's country domain, then its saved zone. |
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.
| Argument | Type | Description |
|---|---|---|
| kind* | string | coupon (a code), url (a link) or message (text). |
| name* | string | What the brand calls this perk. |
| value* | string | The coupon code, link or message. |
| brandId* | string | Brand ID, the project that offers the perk. |
| expiresAt | any | When the perk stops being shown, as an ISO 8601 time. |
| validDays | any | How many days a member has to use it after it's given, like 30. Null keeps it until the perk's own expiry. |
| valueCents | any | What the perk is worth to a member, in cents. |
| uniqueCodes | boolean | Coupons only. true when each member needs their own code, like a gift card: members wait for one until codes are added, and never get the value. |
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.
| Argument | Type | Description |
|---|---|---|
| site | string | Optional website backlink. Query strings and fragments are removed. |
| size | string | |
| theme | string | |
| fields* | object | Template text: winner uses name, prize, from; streak uses days, habit, optional name; perk uses milestone, perk, from; entered uses giveaway, prize, from; announce uses title, winners (one per line), from. |
| template* | string |
{
"type": "object",
"required": [
"template",
"fields"
],
"properties": {
"site": {
"type": "string",
"format": "uri",
"maxLength": 300,
"description": "Optional website backlink. Query strings and fragments are removed."
},
"size": {
"enum": [
"square",
"story",
"link"
],
"type": "string",
"default": "square"
},
"theme": {
"enum": [
"ink",
"light",
"sun",
"cobalt"
],
"type": "string",
"default": "ink"
},
"fields": {
"type": "object",
"description": "Template text: winner uses name, prize, from; streak uses days, habit, optional name; perk uses milestone, perk, from; entered uses giveaway, prize, from; announce uses title, winners (one per line), from.",
"propertyNames": {
"type": "string",
"maxLength": 30
},
"additionalProperties": {
"type": "string",
"maxLength": 500
}
},
"template": {
"enum": [
"winner",
"streak",
"perk",
"entered",
"announce"
],
"type": "string"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| theme | string | Badge colours. Default light. |
| title* | string | The habit, e.g. 'Read 20 pages' or 'Ship a commit'. |
| timeZone | string | IANA time zone that decides when a day starts, e.g. Europe/London. Default UTC. |
| ownerName | string | Whose streak it is, shown on the public page. |
{
"type": "object",
"required": [
"title"
],
"properties": {
"theme": {
"enum": [
"light",
"dark"
],
"type": "string",
"description": "Badge colours. Default light."
},
"title": {
"type": "string",
"maxLength": 160,
"description": "The habit, e.g. 'Read 20 pages' or 'Ship a commit'."
},
"timeZone": {
"type": "string",
"maxLength": 64,
"description": "IANA time zone that decides when a day starts, e.g. Europe/London. Default UTC."
},
"ownerName": {
"type": "string",
"maxLength": 80,
"description": "Whose streak it is, shown on the public page."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| title | string | A name for the giveaway, shown on the results page. |
| method | string | single: one winner. multiple: several equal winners. placed: 1st, 2nd, 3rd… with a prize per place. |
| prizes | array | Prize labels. For placed draws, one per place in order; otherwise one prize for every winner. |
| entrants* | any | The entrants: an array of names, or text with one name per line. A name listed twice gets two entries. |
| winnerCount | integer | How many winners to pick. |
{
"type": "object",
"required": [
"entrants"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120,
"description": "A name for the giveaway, shown on the results page."
},
"method": {
"enum": [
"single",
"multiple",
"placed"
],
"type": "string",
"default": "single",
"description": "single: one winner. multiple: several equal winners. placed: 1st, 2nd, 3rd… with a prize per place."
},
"prizes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 100,
"description": "Prize labels. For placed draws, one per place in order; otherwise one prize for every winner."
},
"entrants": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 400
},
"maxItems": 10000
},
{
"type": "string",
"maxLength": 2000000
}
],
"description": "The entrants: an array of names, or text with one name per line. A name listed twice gets two entries."
},
"winnerCount": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1,
"description": "How many winners to pick."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| slug* | string |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[2-9a-z]{10}$"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| giveawayId* | string | Giveaway ID. It is also the giveaway's campaign ID for approval and status. |
{
"type": "object",
"required": [
"giveawayId"
],
"properties": {
"giveawayId": {
"type": "string",
"format": "uuid",
"description": "Giveaway ID. It is also the giveaway's campaign ID for approval and status."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | Brand ID, the project Doo runs. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"format": "uuid",
"description": "Brand ID, the project Doo runs."
}
}
}Read the latest holdout experiment, its sample sizes and measured return rate. Returns null when no experiment exists; never invents uplift.
| Argument | Type | Description |
|---|---|---|
| campaignId* | string | Streak program ID from list_programs. |
{
"type": "object",
"required": [
"campaignId"
],
"properties": {
"campaignId": {
"type": "string",
"format": "uuid",
"description": "Streak program ID from list_programs."
}
}
}Read a Perkadoo Streak Badge: the live streak, best streak, total days and the last seven days.
| Argument | Type | Description |
|---|---|---|
| slug* | string | The streak's public slug, from its link /s/<slug>. |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"maxLength": 40,
"description": "The streak's public slug, from its link /s/<slug>."
}
}
}Read the streak distribution, best streaks and progress for a program. Excludes synthetic test activity.
| Argument | Type | Description |
|---|---|---|
| campaignId* | string | Streak program ID from list_programs. |
{
"type": "object",
"required": [
"campaignId"
],
"properties": {
"campaignId": {
"type": "string",
"format": "uuid",
"description": "Streak program ID from list_programs."
}
}
}List a giveaway's entries, newest first, with email, entries, source, referrer, status and risk signals. Filter by status to review flagged entries.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| status | string | |
| giveawayId* | string | Giveaway ID. It is also the giveaway's campaign ID for approval and status. |
{
"type": "object",
"required": [
"giveawayId"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"valid",
"flagged",
"disqualified"
],
"type": "string"
},
"giveawayId": {
"type": "string",
"format": "uuid",
"description": "Giveaway ID. It is also the giveaway's campaign ID for approval and status."
}
}
}List a brand's giveaways, newest first, with their phase and entry counts.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | Brand ID, the project that runs the giveaway. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"format": "uuid",
"description": "Brand ID, the project that runs the giveaway."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | Brand ID, the project that offers the perk. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"format": "uuid",
"description": "Brand ID, the project that offers the perk."
}
}
}List a brand's streak programs with their event key, cadence, target and status.
| Argument | Type | Description |
|---|---|---|
| brandId* | string | Brand ID, the project that runs the streak. |
{
"type": "object",
"required": [
"brandId"
],
"properties": {
"brandId": {
"type": "string",
"format": "uuid",
"description": "Brand ID, the project that runs the streak."
}
}
}List the Perkadoo projects available to the authenticated MCP credential.
No arguments.
{
"type": "object",
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| giveawayId* | string | A drawn giveaway. |
{
"type": "object",
"required": [
"giveawayId"
],
"properties": {
"giveawayId": {
"type": "string",
"format": "uuid",
"description": "A drawn giveaway."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| link* | string | The post's link, as copied from its share button: a YouTube video. |
{
"type": "object",
"required": [
"link"
],
"properties": {
"link": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "The post's link, as copied from its share button: a YouTube video."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| metric* | string | new_faces counts first-time members who left an email. returning counts members active in two or more weeks. |
| target* | integer | The number to reach. |
| brandId* | string | Brand ID, the project Doo runs. |
| deadline* | string | When to reach it, within the next 366 days. ISO 8601 with an offset. |
{
"type": "object",
"required": [
"brandId",
"metric",
"target",
"deadline"
],
"properties": {
"metric": {
"enum": [
"new_faces",
"returning"
],
"type": "string",
"description": "new_faces counts first-time members who left an email. returning counts members active in two or more weeks."
},
"target": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "The number to reach."
},
"brandId": {
"type": "string",
"format": "uuid",
"description": "Brand ID, the project Doo runs."
},
"deadline": {
"type": "string",
"format": "date-time",
"description": "When to reach it, within the next 366 days. ISO 8601 with an offset."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name | string | The giveaway's name, shown as its title. |
| rules | object | The official rules. A person approves them before the giveaway goes live. |
| prizes | array | One prize per place for placed draws; otherwise the first prize goes to every winner. |
| opensAt | string | When entries open, as an ISO 8601 time. |
| closesAt | string | When entries close, as an ISO 8601 time. Must be after opensAt. |
| language | string | The language the entry page, results page and site banner speak to entrants: en or es. |
| timezone | string | The time zone the official rules and dashboard use, e.g. America/New_York. |
| entryPage | object | The hosted entry page's headline, description, image, brand colour and bonuses. |
| entryPage | object | The hosted entry page's headline, description, image, brand colour and bonuses. |
| drawMethod | string | single: one winner. multiple: equal winners. placed: 1st, 2nd, 3rd… |
| winnerCount | integer | How many winners to draw. |
{
"type": "object",
"required": [
"brandId",
"name",
"opensAt",
"closesAt"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The giveaway's name, shown as its title."
},
"rules": {
"type": "object",
"default": {
"fields": {},
"document": null
},
"properties": {
"fields": {
"type": "object",
"default": {},
"description": "The official rules generator's operator fields: sponsor, eligibility and so on.",
"propertyNames": {
"type": "string",
"maxLength": 64
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 60
}
]
}
}
},
"description": "The official rules. sponsorCountry and countries default to the brand's own country. A person approves them before the giveaway goes live."
},
"prizes": {
"type": "array",
"items": {
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"perkId": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"default": null,
"description": "A perk from this brand to give the winner of this place."
}
}
},
"default": [],
"maxItems": 100,
"description": "One prize per place for placed draws; otherwise the first prize goes to every winner."
},
"brandId": {
"type": "string",
"format": "uuid",
"description": "Brand ID, the project that runs the giveaway."
},
"opensAt": {
"type": "string",
"format": "date-time",
"description": "When entries open, as an ISO 8601 time."
},
"closesAt": {
"type": "string",
"format": "date-time",
"description": "When entries close, as an ISO 8601 time. Must be after opensAt."
},
"language": {
"enum": [
"en",
"es"
],
"type": "string",
"description": "The language entrants see: en or es. Left out, the language of the brand's country, else en."
},
"timezone": {
"type": "string",
"maxLength": 64,
"description": "The time zone the official rules and dashboard use, e.g. Europe/London. Left out, the brand's own: from its site's country domain, then its saved zone."
},
"entryPage": {
"type": "object",
"default": {},
"properties": {
"headline": {
"type": "string",
"maxLength": 120
},
"imageUrl": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 1000
},
{
"type": "null"
}
]
},
"brandColor": {
"anyOf": [
{
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
{
"type": "null"
}
]
},
"description": {
"type": "string",
"maxLength": 2000
},
"bonusActions": {
"type": "object",
"description": "Bonus entries on offer: referral, share, follow and visit. Pro and up.",
"propertyNames": {
"enum": [
"referral",
"share",
"follow",
"visit"
],
"type": "string"
},
"additionalProperties": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 1000
},
{
"type": "null"
}
],
"description": "Where the follow or visit action sends people."
},
"enabled": {
"type": "boolean"
},
"entries": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Entries this action is worth."
}
}
}
}
},
"description": "The hosted entry page's headline, description, image, brand colour and bonuses."
},
"drawMethod": {
"enum": [
"single",
"multiple",
"placed"
],
"type": "string",
"default": "single",
"description": "single: one winner. multiple: equal winners. placed: 1st, 2nd, 3rd…"
},
"winnerCount": {
"type": "integer",
"default": 1,
"maximum": 100,
"minimum": 1,
"description": "How many winners to draw."
}
}
}{
"type": "object",
"required": [
"brandId",
"name",
"kind",
"value"
],
"properties": {
"kind": {
"enum": [
"coupon",
"url",
"message"
],
"type": "string",
"description": "coupon (a code), url (a link) or message (text)."
},
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "What the brand calls this perk."
},
"value": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The coupon code, link or message."
},
"brandId": {
"type": "string",
"format": "uuid",
"description": "Brand ID, the project that offers the perk."
},
"expiresAt": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"description": "When the perk stops being shown, as an ISO 8601 time."
},
"validDays": {
"anyOf": [
{
"type": "integer",
"maximum": 3650,
"minimum": 1
},
{
"type": "null"
}
],
"description": "How many days a member has to use it after it's given, like 30. Null keeps it until the perk's own expiry."
},
"valueCents": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
],
"description": "What the perk is worth to a member, in cents."
},
"uniqueCodes": {
"type": "boolean",
"description": "Coupons only. true when each member needs their own code, like a gift card: members wait for one until codes are added, and never get the value."
}
}
}| drawMethod | string | single: one winner. multiple: equal winners. placed: 1st, 2nd, 3rd… |
| giveawayId* | string | Giveaway ID. It is also the giveaway's campaign ID for approval and status. |
| winnerCount | integer | How many winners to draw. |
{
"type": "object",
"required": [
"giveawayId"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The giveaway's name, shown as its title."
},
"rules": {
"type": "object",
"properties": {
"fields": {
"type": "object",
"default": {},
"description": "The official rules generator's operator fields: sponsor, eligibility and so on.",
"propertyNames": {
"type": "string",
"maxLength": 64
},
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 60
}
]
}
}
},
"description": "The official rules. A person approves them before the giveaway goes live."
},
"prizes": {
"type": "array",
"items": {
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"perkId": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"default": null,
"description": "A perk from this brand to give the winner of this place."
}
}
},
"maxItems": 100,
"description": "One prize per place for placed draws; otherwise the first prize goes to every winner."
},
"opensAt": {
"type": "string",
"format": "date-time",
"description": "When entries open, as an ISO 8601 time."
},
"closesAt": {
"type": "string",
"format": "date-time",
"description": "When entries close, as an ISO 8601 time. Must be after opensAt."
},
"language": {
"enum": [
"en",
"es"
],
"type": "string",
"description": "The language the entry page, results page and site banner speak to entrants: en or es."
},
"timezone": {
"type": "string",
"maxLength": 64,
"description": "The time zone the official rules and dashboard use, e.g. America/New_York."
},
"entryPage": {
"type": "object",
"properties": {
"headline": {
"type": "string",
"maxLength": 120
},
"imageUrl": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 1000
},
{
"type": "null"
}
]
},
"brandColor": {
"anyOf": [
{
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
{
"type": "null"
}
]
},
"description": {
"type": "string",
"maxLength": 2000
},
"bonusActions": {
"type": "object",
"description": "Bonus entries on offer: referral, share, follow and visit. Pro and up.",
"propertyNames": {
"enum": [
"referral",
"share",
"follow",
"visit"
],
"type": "string"
},
"additionalProperties": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 1000
},
{
"type": "null"
}
],
"description": "Where the follow or visit action sends people."
},
"enabled": {
"type": "boolean"
},
"entries": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Entries this action is worth."
}
}
}
}
},
"description": "The hosted entry page's headline, description, image, brand colour and bonuses."
},
"drawMethod": {
"enum": [
"single",
"multiple",
"placed"
],
"type": "string",
"description": "single: one winner. multiple: equal winners. placed: 1st, 2nd, 3rd…"
},
"giveawayId": {
"type": "string",
"format": "uuid",
"description": "Giveaway ID. It is also the giveaway's campaign ID for approval and status."
},
"winnerCount": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "How many winners to draw."
}
}
}