coldcaked
Registry code: b8ee2cf29ea87e0c
Cold Caked sends custom cakes: an edible photo/design print on top, baked by a vetted local bakery and hand-delivered to the recipient's door. People use it for congratulations, birthdays, launches, and unforgettable business outreach ("coldcaking").
The full gifting loop:
- endpoint
- https://coldcaked.com/mcp
- protocol
- streamable-http ·2025-06-18
- authentication
- none observed
- public key
- none — nobody has proven they own this listing · is it yours? claim it
- karma
- 0 · newcomer
- Is coldcaked live?
- Yes — it answered the hub's last check (checked 4h ago). It answered 100% of checks over the last 30 days.
- Is coldcaked free to use?
- Not measured yet.
- What tools does coldcaked have?
- 37 tools: check_delivery_coverage, quote_cookie_box, start_gift, update_recipient, remove_recipient, set_gift_cookie_box, find_recipient_address, set_gift_design, ….
- Is coldcaked safe to connect?
- The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
90 days 100%· all time 100%
last good check
of 37 tools
- unknown → live
Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.
through this hub
successful
what callers paid
Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.
check_delivery_coverage unknown never probed
Check whether Cold Caked can hand-deliver a cake to a street address, and get per-size prices for that location. No gift or auth needed: use this first, before starting a gift. If the result carries access_warning, bakeries have been turned away at that building before: tell the sender, and ask for a direct phone number or someone who can meet the courier. It does not block an order. Every order has volume pricing: 5% off every cake from 10 cakes, 8% from 25, 10% from 50, 15% from 100 and 25% from 500, and some bakeries take more off on top (the response's volume_pricing lists the thresholds with the real per-size prices at each, worth relaying when someone orders just below one).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "address" ], "properties": { "zip": { "type": "string", "maxLength": 40 }, "city": { "type": "string", "maxLength": 120 }, "state": { "type": "string", "maxLength": 120 }, "address": { "type": "string", "maxLength": 300, "minLength": 2, "description": "Street address" }, "country": { "type": "string", "maxLength": 120 }, "quantity": { "type": "integer", "maximum": 500, "minimum": 1, "description": "How many cakes the order would send to this address/area at once (default 1). The per-cake price falls with quantity — pass the real number to quote it." }, "delivery_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "Requested delivery date (YYYY-MM-DD). Omit for ASAP — the bakery schedules the soonest slot." } }, "additionalProperties": false }arguments 43 linesquote_cookie_box unknown never probed
Price a shipped cookie box (4 or 6 sugar cookies with edible prints) to a US ZIP. Available only when cookie boxes are enabled on this server; otherwise the tool refuses. Use check_delivery_coverage first for cake hand-delivery; this is the shipped alternative where no bakery reaches, or beside a cake.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "zip" ], "properties": { "zip": { "type": "string", "maxLength": 20, "minLength": 5, "description": "US ZIP code the box ships to" }, "boxes": { "type": "integer", "maximum": 500, "minimum": 1, "description": "How many boxes in the order (volume discount). Default 1." }, "state": { "type": "string", "maxLength": 120 }, "cookies": { "enum": [ 4, 6 ], "type": "number", "description": "Cookies per box: 4, 6. Default 4." }, "country": { "type": "string", "maxLength": 120 } }, "additionalProperties": false }arguments 38 linesstart_gift unknown never probed
Create a new cake gift. Unless a Cold Caked account is linked through account_token or the connection, ask the sender for their email and pass sender_email before starting. Never guess an email or use the recipient's. Returns gift_id and a secret gift_token: keep both for every later call. The gift stays a free draft until create_checkout is paid, so it's safe to start one while exploring. Pass account_token if the sender has a Cold Caked account and wants this gift to show up in it.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "gift_name": { "type": "string", "maxLength": 200, "description": "A label for this gift, e.g. \"Sara's promotion cake\"" }, "sender_name": { "type": "string", "maxLength": 200, "description": "Who the gift is from (shown to Cold Caked's team, not printed). Ignored when account_token is given: the account already says who you are." }, "sender_email": { "type": "string", "format": "email", "maxLength": 200, "description": "Sender's email for gift contact and receipts. Required unless a Cold Caked account is linked through account_token or the connection. Ask the sender if you do not already have their email; never guess or use the recipient's email. Ignored for linked accounts, which already have an email." }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's own Cold Caked account token, from the Connect AI page at coldcaked.com/customer. Opens the gift ON that account, so it appears in their campaign list alongside the ones they made on the website, bills to their account, and can be tracked there after delivery. Without it the gift is a standalone order that only its own tracking link can see. Never guess this. If the sender hasn't given you one, leave it out." } }, "additionalProperties": false }arguments 28 linesupdate_recipient unknown never probed
Fix a recipient on an unpaid gift — a typo'd address, a missing suite number, a phone number the sender found later. Send only the fields that change; the rest stay as they are. Changing the address re-routes to whichever bakery covers the new one, so the answer tells you whether it's still deliverable. The recipient_id doesn't change. Can't be used once the gift is paid.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id", "recipient_id" ], "properties": { "zip": { "anyOf": [ { "type": "string", "maxLength": 40 }, { "type": "null" } ] }, "city": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "notes": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ] }, "phone": { "anyOf": [ { "type": "string", "maxLength": 40 }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "address": { "type": "string", "maxLength": 300, "minLength": 2 }, "company": { "type": "string", "maxLength": 200, "minLength": 1 }, "cookies": { "enum": [ 4, 6 ], "type": "number", "description": "Cookies per box for the whole gift: 4, 6." }, "country": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ] }, "gift_id": { "type": "string", "format": "uuid" }, "product": { "enum": [ "cake", "cookie_box" ], "type": "string", "description": "Switch this person between a hand-delivered cake and a cookie box shipped by USPS." }, "address2": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ], "description": "Suite/apt/floor. Pass null to clear it." }, "gift_token": { "type": "string", "minLength": 10 }, "inscription": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "description": "The words on this person's cake. Pass null to fall back to whatever the gift as a whole says." }, "contact_name": { "type": "string", "maxLength": 200, "minLength": 1 }, "recipient_id": { "type": "string", "minLength": 10, "description": "From add_recipient, or get_gift_status." }, "delivery_note": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] } }, "additionalProperties": false }arguments 156 linesremove_recipient unknown never probed
Take a recipient off an unpaid gift — one cake fewer. Use this rather than leaving an undeliverable row on the gift. Can't be used once the gift is paid; contact [email protected] if a delivery has to be stopped.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id", "recipient_id" ], "properties": { "gift_id": { "type": "string", "format": "uuid" }, "gift_token": { "type": "string", "minLength": 10 }, "recipient_id": { "type": "string", "minLength": 10 } }, "additionalProperties": false }arguments 23 linesset_gift_cookie_box unknown never probed
Switch one recipient on an unpaid gift from a hand-delivered cake to a shipped cookie box (4 or 6 cookies). Only available when cookie boxes are enabled on this server; otherwise the tool refuses. Quote first with quote_cookie_box. Gift links and emailed gifts cannot ship boxes yet; this is for agent/direct drafts that check out like a cake gift.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id", "recipient_id" ], "properties": { "cookies": { "enum": [ 4, 6 ], "type": "number", "description": "Cookies per box for the whole gift: 4, 6. Default keeps the gift's current size (or 4)." }, "gift_id": { "type": "string", "format": "uuid" }, "gift_token": { "type": "string", "minLength": 10 }, "recipient_id": { "type": "string", "minLength": 10 } }, "additionalProperties": false }arguments 31 linesfind_recipient_address unknown never probed
Only know the recipient's company website? This finds and verifies the company's mailing address (HQ-first, USPS-verified where possible), plus the switchboard and general inbox they publish — the building's details, never the person's own. Requires a gift_token from start_gift. Feed the best candidate into add_recipient.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "website_url" ], "properties": { "city_hint": { "type": "string", "maxLength": 120, "description": "City you expect them in, to disambiguate multi-office companies" }, "gift_token": { "type": "string", "minLength": 10 }, "website_url": { "type": "string", "format": "uri", "maxLength": 500, "description": "The company's website, e.g. https://acme.com" } }, "additionalProperties": false }arguments 25 linesset_gift_design unknown never probed
Set what goes on the cake. Either an INSCRIPTION — pass inscription on its own and the bakery writes those words on the cake in icing, by hand, with no print at all (this is what an ordinary birthday cake is, and it needs no artwork) — or a PRINT, providing exactly one of: image_svg (design the art yourself in SVG — we rasterize it print-ready; the most creative option), image_prompt (describe the art and we generate it with an image model), image_url (public https image), image_base64 (PNG/JPEG/WebP bytes), or message_text (a short message we typeset for you). Pass an inscription alongside artwork to get both (logo on top, name in icing). Design for a square ~1600×1600px canvas; round cakes (the default) are cropped to the inscribed circle, so keep key content away from the corners. A print returns fit warnings you can act on. Call again to replace the design. A design — of either kind — is required before checkout. ONE RECIPIENT'S OWN DESIGN: pass recipient_id and this sets that one cake's print (and/or inscription) instead of the gift's — the way to send a list where every company gets its own cake, e.g. one image_url per row of the sender's spreadsheet. A recipient's own design wins over the gift's; once every deliverable recipient has one, the gift needs no design of its own.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id" ], "properties": { "texts": { "type": "object", "description": "Template path only: role→copy map, e.g. { \"headline\": \"SHIP IT\", \"subline\": \"Acme\" }. Unknown roles are rejected.", "additionalProperties": { "type": "string", "maxLength": 80 } }, "gift_id": { "type": "string", "format": "uuid" }, "palette": { "type": "object", "properties": { "bg": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "ink": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "accent": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "subtle": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" } }, "description": "Template path only: brand colours by role. Locked roles (usually ink) are rejected.", "additionalProperties": false }, "cake_size": { "enum": [ "6in", "8in", "10in", "12in", "half_sheet", "sheet" ], "type": "string" }, "image_svg": { "type": "string", "maxLength": 200000, "description": "Self-contained SVG markup you author (design the cake art yourself!). Use viewBox=\"0 0 1600 1600\". Available font-family values: \"Inter\", \"Caveat\", \"Fraunces\", \"Bricolage Grotesque\", \"JetBrains Mono\". No scripts, external URLs, or emoji; embed raster images only as data:image URIs. Rendered on white — use a full-bleed background rect." }, "image_url": { "type": "string", "format": "uri", "maxLength": 2000, "description": "Public https URL of a PNG/JPEG/WebP image (max 10MB)" }, "cake_shape": { "enum": [ "round", "square" ], "type": "string" }, "gift_token": { "type": "string", "minLength": 10 }, "image_mime": { "enum": [ "image/png", "image/jpeg", "image/webp" ], "type": "string", "description": "MIME of image_base64 (sniffed from the bytes if omitted)" }, "art_subject": { "type": "string", "maxLength": 120, "minLength": 1, "description": "Template path only: a noun phrase for the art region, e.g. \"a stylised shipping container\". Never a full free-form prompt — the template owns the style scaffold." }, "inscription": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "description": "Words for the bakery to WRITE on the cake in icing, e.g. \"Happy Birthday Sarah\" (max 60 characters). Sent on its own, the cake carries no print at all — the right choice for a birthday, and for anything recurring where commissioning artwork every time makes no sense. Sent with artwork, the bakery writes it alongside the print. Pass null to remove one." }, "image_base64": { "type": "string", "maxLength": 14000000, "description": "Base64-encoded PNG/JPEG/WebP bytes (max 10MB decoded)" }, "image_prompt": { "type": "string", "maxLength": 600, "minLength": 1, "description": "Describe the art to generate, e.g. \"a bold flat illustration of a rocket launching over a city skyline\". We pick the image model from what you ask for: prompts wanting legible words route to gpt-image-2, prompts depicting a real identifiable person route to Google nano-banana-2, everything else to nano-banana. Takes up to ~2 minutes. Prefer image_svg when you can draw it yourself — it's instant, free and exact." }, "message_font": { "enum": [ "inter", "caveat", "fraunces", "bricolage", "mono" ], "type": "string", "description": "Typeface for message_text. inter = clean modern sans (regular + bold); caveat = warm handwritten script; fraunces = elegant display serif; bricolage = playful chunky display; mono = technical monospace. Default: caveat." }, "message_text": { "type": "string", "maxLength": 80, "minLength": 1, "description": "Short message to typeset, e.g. \"CONGRATS SARA!\" (no emoji). Style it with the message_* options." }, "recipient_id": { "type": "string", "minLength": 10, "description": "Set THIS recipient's own cake design instead of the gift's (from add_recipient or get_gift_status). Size and shape stay gift-wide — omit cake_size/cake_shape with it." }, "template_key": { "type": "string", "maxLength": 40, "description": "Template path: pass with texts / palette / art_subject (and without image_* / message_text) to compile a curated template, optionally generate art into its picture area, and render the print server-side. Also optional with image_prompt alone: confine generated art to the template's picture area. Art-led templates: \"name-wreath\", \"milestone-numeral\", \"launch-band\"." }, "message_text_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$", "description": "Text color as #rrggbb (default warm chocolate #7c3f2a)" }, "message_background_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$", "description": "Background color as #rrggbb (default cream #fff8ee)" } }, "additionalProperties": false }arguments 153 linesget_cake_catalog unknown never probed
What a Cold Caked cake is, available sizes/shapes, and from-prices. Exact prices depend on the delivery address: use check_delivery_coverage for a real quote.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": {} }arguments 5 linesadd_recipient unknown never probed
Add the person receiving the cake AND the business they're at — the bakery needs both to hand it over. Geocodes the address and routes it to a local bakery; tells you if the address is deliverable. A gift usually has one recipient but can have up to 50 (each gets a cake). Sending to a LIST — several companies, a different design or card for each? Keep them on ONE gift: add every recipient here, then give each their own art with set_gift_design / set_gift_card and recipient_id. Don't open a gift per person. If the result carries access_warning, bakeries have been turned away at that office before: tell the sender and ask for a direct phone number or someone who can meet the courier. It never blocks the order.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id", "company", "contact_name", "address" ], "properties": { "zip": { "type": "string", "maxLength": 40 }, "city": { "type": "string", "maxLength": 120 }, "email": { "type": "string", "format": "email", "maxLength": 200, "description": "An email that reaches the recipient — their own, or the company inbox find_recipient_address found. We send it a day-before delivery heads-up so the front desk expects the box." }, "notes": { "type": "string", "maxLength": 2000, "description": "A private jot on this recipient for the SENDER's own reference. Nobody at the bakery sees it — put door codes and hand-off instructions in delivery_note instead." }, "phone": { "type": "string", "maxLength": 40, "description": "Recipient's phone number. Optional, but ASK the sender for it — the bakery calls it when nobody answers the door, which is the difference between a delivered cake and a returned one." }, "state": { "type": "string", "maxLength": 120 }, "address": { "type": "string", "maxLength": 300, "minLength": 2 }, "company": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Company or household name on the delivery" }, "cookies": { "enum": [ 4, 6 ], "type": "number", "description": "Cookies per box for the whole gift: 4, 6. Default 4." }, "country": { "type": "string", "maxLength": 120 }, "gift_id": { "type": "string", "format": "uuid" }, "product": { "enum": [ "cake", "cookie_box", "cake_or_cookie_box" ], "type": "string", "description": "What this person is sent: cake (default, hand-delivered), cookie_box (shipped by USPS, covered or not), or cake_or_cookie_box (a cake where a bakery reaches, a box where none does). A box's cookies wear the gift's PRINT, never icing, so give it a printed design." }, "address2": { "type": "string", "maxLength": 120, "description": "Suite/apt/floor. REQUIRED for New York addresses unless you pass a phone — a courier can't get past a NYC lobby with a street address alone." }, "gift_token": { "type": "string", "minLength": 10 }, "inscription": { "type": "string", "maxLength": 200, "description": "Words the bakery writes on THIS person's cake in icing, e.g. \"Happy Birthday Sarah\" (max 60 characters). Overrides whatever set_gift_design set for the gift as a whole — that is how one gift going to several people carries a different name on each cake." }, "contact_name": { "type": "string", "maxLength": 200, "minLength": 1, "description": "Who the driver asks for at the door. Required, and NOT the same thing as company — the bakery gets both, and a delivery addressed only to 'Water District' reaches a reception desk with nobody to hand it to. If the sender has no specific person, ask for the receiving department ('Facilities', 'Front desk') and pass that." }, "email_source": { "enum": [ "manual", "csv", "website_contact", "website_legal", "google_places", "web_search", "hunter" ], "type": "string", "description": "Same as phone_source, for the email." }, "phone_source": { "enum": [ "manual", "csv", "website_contact", "website_legal", "google_places", "web_search", "hunter" ], "type": "string", "description": "Where the phone came from: the `source` of the find_recipient_address candidate you copied it from, verbatim. OMIT for a number the sender gave you — this is how the sender's review page knows to label a switchboard as a switchboard." }, "delivery_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "Delivery date (YYYY-MM-DD) for the whole gift. Omit for ASAP." }, "delivery_note": { "type": "string", "maxLength": 200, "description": "One line for whoever carries the box: who to hand it to and what the door needs (\"Hand to the ops team — ask for Dana or Priya\", \"Buzzer 4B, back entrance on Minna\"). This is the line the bakery and the driver actually read, printed on the delivery ticket. Use it for anything that decides whether the cake reaches the right hands." } }, "additionalProperties": false }arguments 133 linesfind_recipient_logo unknown never probed
Pull the logo a company already publishes on their own website, plus their brand colors, so the cake can look like it was made for them. Returns an image URL we host (pass to set_gift_design as image_url), the brand colors (use them when you author image_svg), and, when the mark is small enough to embed, a data URI you CAN reference inside image_svg. We never generate a logo, only find a published one. If it is too low-resolution to print we say so instead of upscaling it into mush.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "website_url" ], "properties": { "gift_token": { "type": "string", "minLength": 10 }, "website_url": { "type": "string", "format": "uri", "maxLength": 500, "description": "The recipient company's website, e.g. https://acme.com" } }, "additionalProperties": false }arguments 20 lineslist_automations unknown never probed
All automations owned by this automation_token, or by the account the connection is linked to.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "automation_token": { "type": "string", "minLength": 10, "description": "The owner credential. Omit on a connection linked to a Cold Caked account: that account is the owner." } }, "additionalProperties": false }arguments 12 lineswatch_people unknown never probed
Put people on a watch list: we then read what they publish (LinkedIn, X, GitHub, their site, Devpost, their company's news, a weekly LinkedIn headline check) and suggest a gift when something is worth one (while gift ideas are paused the suggestion comes without one, gifts_paused). Pass an existing watchlist_id, or a name to make a new list (with a focus in the sender's words and a cadence of 6, 12, 24 or 48 hours). Their stored research is read too, and the web is searched for them every two weeks, so a person with no feeds on file is still watched. People are prospect_ids from the account's People roster, or new people by name and LinkedIn URL; a new person is added to a campaign named after the list and starts with LinkedIn and their company site only, until they are researched. Each check that reads their feeds costs check_credits research credits (see list_watchlists), so a list of five checked daily spends 25 a day; quote that before adding. A list with paid_feeds false (a campaign or People List watch) reads only their research and the web, and costs nothing. A gift is priced when it goes, and nothing is bought until the sender says so.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "name": { "type": "string", "maxLength": 80, "minLength": 1, "description": "Name for a new list, e.g. Investors" }, "focus": { "type": "string", "maxLength": 600, "description": "What counts as worth a gift, in the sender's words" }, "budget": { "type": "string", "maxLength": 12, "description": "Gift price range, \"50-100\" style" }, "people": { "type": "array", "items": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "maxLength": 120, "minLength": 2 }, "email": { "type": "string", "format": "email", "maxLength": 200 }, "title": { "type": "string", "maxLength": 160 }, "company": { "type": "string", "maxLength": 160 }, "linkedin_url": { "type": "string", "format": "uri", "maxLength": 300 }, "company_website": { "type": "string", "maxLength": 300 } }, "additionalProperties": false }, "maxItems": 25, "description": "New people, by name; a LinkedIn URL is what makes them watchable" }, "prospect_ids": { "type": "array", "items": { "type": "string", "maxLength": 80, "minLength": 1 }, "maxItems": 25, "description": "People already in the account's People roster" }, "watchlist_id": { "type": "string", "maxLength": 80, "description": "An existing list. Omit to create one." }, "account_token": { "type": "string", "maxLength": 200, "minLength": 8 }, "check_every_hours": { "enum": [ 6, 12, 24, 48 ], "type": "number", "description": "6, 12, 24 or 48; default 24. Anything else is refused rather than rounded, since the cadence sets the bill." } }, "additionalProperties": false }arguments 94 linesset_gift_card unknown never probed
Set the 4×6 portrait card the bakery prints and puts in the box with the cake. Optional, included in the price, and most senders want one — ASK what it should say rather than skipping it. Provide EXACTLY ONE of: message_text (a note we typeset for you — the usual choice), image_svg (design the card yourself), image_url, or image_base64. Card art is printed cover-fit at 1200×1800px (4×6in at 300dpi); the back of the card is Daymaker's. Call again to replace it. Pass recipient_id to set that one recipient's own card instead of the gift's — e.g. a card image per row of the sender's list; it wins over the gift's card for that box.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id" ], "properties": { "gift_id": { "type": "string", "format": "uuid" }, "image_svg": { "type": "string", "maxLength": 200000, "description": "Self-contained SVG you author for the card front. Use viewBox=\"0 0 1200 1800\" (portrait). Same rules as the cake print: available font-family values \"Inter\", \"Caveat\", \"Fraunces\", \"Bricolage Grotesque\", \"JetBrains Mono\"; no scripts, external URLs, or emoji; raster images only as data:image URIs. Keep text ~10% clear of every edge — the card is trimmed." }, "image_url": { "type": "string", "format": "uri", "maxLength": 2000, "description": "Public https URL of a PNG/JPEG/WebP card front (max 10MB)" }, "gift_token": { "type": "string", "minLength": 10 }, "image_mime": { "enum": [ "image/png", "image/jpeg", "image/webp" ], "type": "string", "description": "MIME of image_base64 (sniffed from the bytes if omitted)" }, "image_base64": { "type": "string", "maxLength": 14000000, "description": "Base64-encoded PNG/JPEG/WebP bytes (max 10MB decoded)" }, "message_font": { "enum": [ "inter", "caveat", "fraunces", "bricolage", "mono" ], "type": "string", "description": "Typeface for message_text. inter = clean modern sans (regular + bold); caveat = warm handwritten script; fraunces = elegant display serif; bricolage = playful chunky display; mono = technical monospace. Default: caveat." }, "message_text": { "type": "string", "maxLength": 400, "minLength": 1, "description": "The note to typeset on the card, e.g. \"Congrats on the raise, Sara. Enjoy every bite.\" (no emoji). Longer than a cake message can be — this is a real card." }, "recipient_id": { "type": "string", "minLength": 10, "description": "Set THIS recipient's own card instead of the gift's (from add_recipient or get_gift_status)." }, "message_signature": { "type": "string", "maxLength": 80, "description": "Optional sign-off set smaller under message_text, e.g. \"— the Acme team\". Ask the sender how they want to sign it." }, "message_text_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$", "description": "Text color as #rrggbb (default warm chocolate #7c3f2a)" }, "message_background_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$", "description": "Background color as #rrggbb (default cream #fff8ee)" } }, "additionalProperties": false }arguments 80 linescreate_checkout unknown never probed
Lock the price and get a Stripe Checkout URL — or settle from the account's prepaid cake balance when the connection allows it. Send any checkout_url to the human; they pay in a browser (agents never touch card details). The order goes to the bakery automatically once paid. Pass pay_from_balance=true to settle a gift the prepaid balance covers without a human (get_billing says whether that will work). A dm_live_ key pinned on the connection with auto-settle does the same unattended. Requires a design on every cake (set_gift_design — for the whole gift, or per recipient with recipient_id) and at least one deliverable recipient. Before calling this, make sure you asked the sender about the box card (set_gift_card) — after payment it can't be changed.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id" ], "properties": { "gift_id": { "type": "string", "format": "uuid" }, "cake_size": { "enum": [ "6in", "8in", "10in", "12in", "half_sheet", "sheet" ], "type": "string", "description": "Cake size to charge for. Defaults to the size set via set_gift_design; if none was set, pass one here (see get_cake_catalog)." }, "gift_token": { "type": "string", "minLength": 10 }, "pay_from_balance": { "type": "boolean", "description": "Settle from the account's prepaid cake balance when it covers the total, without handing back a Stripe link. Only for a gift on a linked Cold Caked account the caller can spend on. get_billing says what is left. Default false. Without it (and without a dm_live_ key with auto-settle) a balance-covered gift is refused so an agent cannot spend credit silently." } }, "additionalProperties": false }arguments 34 linesget_gift_status unknown never probed
Payment, production, and delivery status for a gift — including delivery photos once the cake lands. Also returns the cake design and box card as images (see design_previews for which is which), so you can show the sender exactly what goes out.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id" ], "properties": { "gift_id": { "type": "string", "format": "uuid" }, "gift_token": { "type": "string", "minLength": 10 } }, "additionalProperties": false }arguments 18 lineslist_design_changes unknown never probed
For a PAID gift: which cakes can still have their artwork changed, what each one currently wears, and where every design change asked for so far stands. Call this before request_design_change — it returns the recipient_ids that tool needs, and tells you whether a request is already waiting (only one can be open per bakery at a time).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id" ], "properties": { "gift_id": { "type": "string", "format": "uuid" }, "gift_token": { "type": "string", "minLength": 10 } }, "additionalProperties": false }arguments 18 linesrequest_design_change unknown never probed
Ask the bakery to print different artwork on a gift that is already PAID. This is a request, not an edit: the cake may already be printed or baked, so the bakery accepts or declines and we email the sender the answer — until then the original design is what ships. Change the whole order (pass cake/card at the top level) or name specific cakes (pass items — up to 200 in ONE call, each with its own artwork, which is how you correct forty cakes without forty round trips). A cake carrying artwork of its own is never touched by a whole-order file: name it in items instead. Get recipient_ids from list_design_changes. Only one request can be open per bakery at a time — withdraw_design_change clears it.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id" ], "properties": { "cake": { "type": "object", "properties": { "image_svg": { "type": "string", "maxLength": 200000, "description": "Self-contained SVG you author, viewBox=\"0 0 1600 1600\". Same rules as set_gift_design: no scripts, external URLs, or emoji." }, "image_url": { "type": "string", "format": "uri", "maxLength": 2000, "description": "Public https URL of a PNG/JPEG/WebP image (max 10MB)" }, "image_mime": { "enum": [ "image/png", "image/jpeg", "image/webp" ], "type": "string" }, "image_base64": { "type": "string", "maxLength": 14000000 }, "image_prompt": { "type": "string", "maxLength": 600, "minLength": 1, "description": "Describe replacement art to generate. Slow (~2 min) and billed per image, so only a few cakes in one call may use it — for a large batch, author image_svg or pass image_url instead." }, "message_font": { "enum": [ "inter", "caveat", "fraunces", "bricolage", "mono" ], "type": "string" }, "message_text": { "type": "string", "maxLength": 80, "minLength": 1, "description": "Short message we typeset for you (no emoji)." }, "message_signature": { "type": "string", "maxLength": 80 }, "message_text_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "message_background_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" } }, "description": "New print for EVERY cake still riding the order's shared design. Ignored when items is given.", "additionalProperties": false }, "card": { "type": "object", "properties": { "image_svg": { "type": "string", "maxLength": 200000, "description": "Self-contained SVG you author, viewBox=\"0 0 1200 1800\". Same rules as set_gift_design: no scripts, external URLs, or emoji." }, "image_url": { "type": "string", "format": "uri", "maxLength": 2000, "description": "Public https URL of a PNG/JPEG/WebP image (max 10MB)" }, "image_mime": { "enum": [ "image/png", "image/jpeg", "image/webp" ], "type": "string" }, "image_base64": { "type": "string", "maxLength": 14000000 }, "message_font": { "enum": [ "inter", "caveat", "fraunces", "bricolage", "mono" ], "type": "string" }, "message_text": { "type": "string", "maxLength": 400, "minLength": 1, "description": "Short message we typeset for you (no emoji)." }, "message_signature": { "type": "string", "maxLength": 80 }, "message_text_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "message_background_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" } }, "description": "New 4x6 box card for every cake still riding the shared card. Ignored when items is given.", "additionalProperties": false }, "note": { "type": "string", "maxLength": 2000, "description": "A line for the bakery, e.g. \"these are the corrected QR codes\". Worth sending — it is what a baker reads before deciding." }, "items": { "type": "array", "items": { "type": "object", "required": [ "recipient_id" ], "properties": { "cake": { "type": "object", "properties": { "image_svg": { "type": "string", "maxLength": 200000, "description": "Self-contained SVG you author, viewBox=\"0 0 1600 1600\". Same rules as set_gift_design: no scripts, external URLs, or emoji." }, "image_url": { "type": "string", "format": "uri", "maxLength": 2000, "description": "Public https URL of a PNG/JPEG/WebP image (max 10MB)" }, "image_mime": { "enum": [ "image/png", "image/jpeg", "image/webp" ], "type": "string" }, "image_base64": { "type": "string", "maxLength": 14000000 }, "image_prompt": { "type": "string", "maxLength": 600, "minLength": 1, "description": "Describe replacement art to generate. Slow (~2 min) and billed per image, so only a few cakes in one call may use it — for a large batch, author image_svg or pass image_url instead." }, "message_font": { "enum": [ "inter", "caveat", "fraunces", "bricolage", "mono" ], "type": "string" }, "message_text": { "type": "string", "maxLength": 80, "minLength": 1, "description": "Short message we typeset for you (no emoji)." }, "message_signature": { "type": "string", "maxLength": 80 }, "message_text_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "message_background_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" } }, "additionalProperties": false }, "card": { "type": "object", "properties": { "image_svg": { "type": "string", "maxLength": 200000, "description": "Self-contained SVG you author, viewBox=\"0 0 1200 1800\". Same rules as set_gift_design: no scripts, external URLs, or emoji." }, "image_url": { "type": "string", "format": "uri", "maxLength": 2000, "description": "Public https URL of a PNG/JPEG/WebP image (max 10MB)" }, "image_mime": { "enum": [ "image/png", "image/jpeg", "image/webp" ], "type": "string" }, "image_base64": { "type": "string", "maxLength": 14000000 }, "message_font": { "enum": [ "inter", "caveat", "fraunces", "bricolage", "mono" ], "type": "string" }, "message_text": { "type": "string", "maxLength": 400, "minLength": 1, "description": "Short message we typeset for you (no emoji)." }, "message_signature": { "type": "string", "maxLength": 80 }, "message_text_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "message_background_color": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" } }, "additionalProperties": false }, "recipient_id": { "type": "string", "minLength": 10, "description": "From list_design_changes." } }, "additionalProperties": false }, "maxItems": 200, "minItems": 1, "description": "Named cakes only, each with its own new print and/or card. Every item needs at least one of the two." }, "gift_id": { "type": "string", "format": "uuid" }, "gift_token": { "type": "string", "minLength": 10 } }, "additionalProperties": false }arguments 285 lineswithdraw_design_change unknown never probed
Take back a design change the bakery hasn't answered yet — the original artwork stands, and the slot is free for a different proposal. Use this when you sent the wrong file, or when a second batch of cakes needs changing and the first request is still open. An answered request can't be withdrawn.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "gift_id", "design_change_id" ], "properties": { "gift_id": { "type": "string", "format": "uuid" }, "gift_token": { "type": "string", "minLength": 10 }, "design_change_id": { "type": "string", "format": "uuid", "description": "The id of a pending request, from list_design_changes." } }, "additionalProperties": false }arguments 24 lineslist_gifts unknown never probed
The gifts on the account this token belongs to, newest first — id, order number, what state each is in. Use it to turn "the cakes I ordered last week" into the gift_id every other tool needs. An anonymous gift_token sees only its own gift; an account token (or a connection pinned to an account) sees everything that account has ordered, on the website as well as through an agent.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "limit": { "type": "integer", "maximum": 50, "minimum": 1 }, "paid_only": { "type": "boolean", "description": "Only gifts that have been paid for — the ones with a bakery working on them. Design changes apply to these." }, "gift_token": { "type": "string", "minLength": 10 } }, "additionalProperties": false }arguments 20 linescreate_automation unknown never probed
Set up a standing rule: when an event happens (customer churns, hits a tenure milestone, new employee starts), Cold Caked automatically designs, routes, and sends a cake. Returns automation_id + a SECRET automation_token (the durable owner credential: keep it) + a webhook ingress URL for the customer's systems. Automations are created PAUSED with payment mode 'approve' (a human gets a pay link per cake) unless configured otherwise; activate via update_automation. Pass automation_token to add this automation to an owner you already manage.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "name", "trigger_kind", "notify_email" ], "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1, "description": "e.g. \"Churn-save cakes\"" }, "months": { "type": "integer", "maximum": 120, "minimum": 1, "description": "For trigger_kind=schedule: fire when a customer reaches this tenure" }, "cake_size": { "enum": [ "6in", "8in", "10in", "12in", "half_sheet", "sheet" ], "type": "string" }, "event_name": { "type": "string", "maxLength": 120, "description": "For trigger_kind=event: e.g. \"customer.churned\"" }, "notify_email": { "type": "string", "format": "email", "maxLength": 200, "description": "Where approve links + notices go. REQUIRED — a fresh MCP owner has no other reachable email." }, "payment_mode": { "enum": [ "approve", "auto_charge", "budget" ], "type": "string", "description": "approve (default, safest): owner gets a pay link per cake. auto_charge/budget need a saved card / prepaid credits set up on the dashboard AND a spend cap." }, "trigger_kind": { "enum": [ "event", "schedule" ], "type": "string", "description": "event = fired by pushed events (webhook/fire_automation); schedule = evaluated hourly against PostHog (tenure/cohort)" }, "spend_cap_usd": { "type": "number", "maximum": 100000, "minimum": 1 }, "address_strategy": { "enum": [ "lookup", "ask_recipient", "lookup_then_ask" ], "type": "string", "description": "When an event has no street address: lookup = AI finder from their domain (default); ask_recipient = email them a confirm link (address + delivery date) before baking; lookup_then_ask = finder first, ask on failure. ask paths need recipient email on events." }, "automation_token": { "type": "string", "minLength": 10, "description": "Attach to an existing owner instead of minting a new one. Possession of the token IS the authorization. Omit on a connection linked to a Cold Caked account: that account is the owner." }, "message_template": { "type": "string", "maxLength": 80, "description": "Cake message; {name}, {first_name}, {company} fill from the event. Default \"CONGRATS {first_name}!\"" }, "max_fires_per_day": { "type": "integer", "maximum": 50, "minimum": 1 }, "posthog_cohort_id": { "type": "integer", "description": "For trigger_kind=schedule: fire on PostHog cohort membership", "exclusiveMinimum": 0 } }, "additionalProperties": false }arguments 97 linesupdate_automation unknown never probed
Change status (activate/pause/archive), caps, design, or trigger config. Activating enforces the safety rules (auto_charge/budget need a spend cap).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "automation_id" ], "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1 }, "months": { "type": "integer", "maximum": 120, "minimum": 1 }, "status": { "enum": [ "active", "paused", "archived" ], "type": "string" }, "cake_size": { "enum": [ "6in", "8in", "10in", "12in", "half_sheet", "sheet" ], "type": "string" }, "event_name": { "type": "string", "maxLength": 120 }, "notify_email": { "type": "string", "format": "email", "maxLength": 200 }, "payment_mode": { "enum": [ "approve", "auto_charge", "budget" ], "type": "string" }, "automation_id": { "type": "string", "format": "uuid" }, "spend_cap_usd": { "type": "number", "maximum": 100000, "minimum": 1 }, "address_strategy": { "enum": [ "lookup", "ask_recipient", "lookup_then_ask" ], "type": "string" }, "automation_token": { "type": "string", "minLength": 10, "description": "The owner credential. Omit on a connection linked to a Cold Caked account: that account is the owner." }, "message_template": { "type": "string", "maxLength": 80 }, "max_fires_per_day": { "type": "integer", "maximum": 50, "minimum": 1 }, "posthog_cohort_id": { "type": "integer", "exclusiveMinimum": 0 } }, "additionalProperties": false }arguments 91 linesfire_automation unknown never probed
Trigger an automation for one recipient right now — the MCP equivalent of the webhook ingress. Same fire-once guarantee: the same (event, recipient) pair never produces two cakes, so retries are safe. Pass idempotency_key to control the dedupe identity yourself. The automation must be ACTIVE.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "automation_id" ], "properties": { "event_name": { "type": "string", "maxLength": 120, "description": "Defaults to the automation's configured eventName" }, "automation_id": { "type": "string", "format": "uuid" }, "recipient_zip": { "type": "string", "maxLength": 20 }, "recipient_city": { "type": "string", "maxLength": 120 }, "recipient_name": { "type": "string", "maxLength": 200 }, "idempotency_key": { "type": "string", "maxLength": 300, "description": "Your delivery id for replay-dedup (like a webhook event id). Optional; recipient identity dedup applies regardless." }, "recipient_email": { "type": "string", "format": "email", "maxLength": 200 }, "recipient_state": { "type": "string", "maxLength": 80 }, "automation_token": { "type": "string", "minLength": 10, "description": "The owner credential. Omit on a connection linked to a Cold Caked account: that account is the owner." }, "recipient_address": { "type": "string", "maxLength": 400 }, "recipient_company": { "type": "string", "maxLength": 200 }, "recipient_country": { "type": "string", "maxLength": 80 }, "recipient_website": { "type": "string", "maxLength": 500 } }, "additionalProperties": false }arguments 66 linesget_automation_runs unknown never probed
Every fire of an automation: status (claimed/awaiting_payment/paid/undeliverable/skipped/failed), recipient, amount, and the created gift's campaign id.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "automation_id" ], "properties": { "automation_id": { "type": "string", "format": "uuid" }, "automation_token": { "type": "string", "minLength": 10, "description": "The owner credential. Omit on a connection linked to a Cold Caked account: that account is the owner." } }, "additionalProperties": false }arguments 19 linesresearch_prospect unknown never probed
Look a person up and pick a gift they would actually love. Research reads what they publish (talks, posts, side projects, the teams and causes they follow) and the gift engine shops the dossier: one buyable gift per interest, most personal first, each with a real product link and a live price check. This is a JOB, not an answer: it returns a prospect_id at once, research takes 2 to 5 minutes and the gift pick 1 to 3 more, so poll get_gift_recommendation until status is "gifted" or "failed" and tell the sender it is running. Needs a Cold Caked account (pinned on the connection, or account_token): every start is metered to that account's research allowance, and a refusal says what is left. depth: high = Investigation (45 Daymaker credits). Pass external_id so a repeat call resumes the same job instead of paying twice. For someone the sender already knows, use suggest_gift instead, which spends less and runs faster. dry_run finishes instantly with placeholder research and spends nothing; a placeholder cannot be bought.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "name": { "type": "string", "maxLength": 200, "description": "Full name. Required unless linkedin_url is set." }, "depth": { "type": "string", "maxLength": 20, "description": "Research depth. high = Investigation (45 Daymaker credits). Choose explicitly for a new run. Legacy values are accepted to resume an existing job; new Scout and omitted/unknown-depth requests are refused before spending." }, "email": { "type": "string", "maxLength": 200, "description": "Their email, if the sender has it. Used later to ask where to send the gift; never for research." }, "fresh": { "type": "boolean", "description": "Research again even if this external_id has a job still running or holding a gift, or this person already has a gift or an order in that campaign. Without it that record comes back as it stands, so a gift the sender already has is never wiped." }, "notes": { "type": "string", "maxLength": 2000, "description": "Anything the sender already knows, verbatim: \"met at ETHDenver\", \"loves sailing\"." }, "title": { "type": "string", "maxLength": 200 }, "budget": { "type": "string", "maxLength": 40, "description": "Gift price range in USD, e.g. \"50-100\" (presets: 0-50, 50-100, 100-150, 150-200; any \"min-max\" works). Default 50-100." }, "company": { "type": "string", "maxLength": 200 }, "dry_run": { "type": "boolean", "description": "Placeholder research and gift, no spend. For wiring an integration." }, "location": { "type": "string", "maxLength": 200, "description": "City or region, as the sender knows it." }, "occasion": { "type": "string", "maxLength": 80, "description": "Why now, if there is a reason: \"congratulations\", \"thank you\", \"series A\", \"birthday\"." }, "send_mode": { "enum": [ "offer", "cold" ], "type": "string", "description": "How the gift reaches them. \"offer\" (default): the recipient is told the NAME of the gift and asked where to send it, so the engine hunts for the most personal object it can buy. \"cold\": the parcel just arrives at an address the sender already holds, so the engine picks a modest, shareable consumable (up to $75) that creates no obligation. Default to offer unless the sender said otherwise." }, "campaign_id": { "type": "string", "maxLength": 80, "description": "File the person under one of the account's research campaigns. Omit for the account's Unfiled inbox." }, "external_id": { "type": "string", "maxLength": 200, "description": "Your own id for this person (a CRM contact id, a row id). Calling again with the same external_id returns the same job instead of paying for a second one; pass fresh to research again." }, "linkedin_url": { "type": "string", "maxLength": 500 }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." }, "sender_context": { "type": "string", "maxLength": 400, "description": "The sender's company in one line (what they do, who for). Sets the tone of the gift note. Never the reason for the object." } }, "additionalProperties": false }arguments 90 linessuggest_gift unknown never probed
Pick a gift for someone the sender already knows, from what they tell you: "Dana: vintage cameras, trail running", a pasted list, notes from a call. Nobody is looked up and no research runs; the interests are the brief and the gift engine shops them, one buyable gift per interest with a real product link and a live price check. Use it whenever the sender gives names WITH interests or notes; use research_prospect when they only have a name. Also a JOB: returns a prospect_id at once and the pick takes 1 to 3 minutes, so poll get_gift_recommendation until status is "gifted" or "failed". Needs a Cold Caked account; one metered unit per person, less than research. Pass external_id to resume instead of paying twice. dry_run returns a placeholder and spends nothing.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "name" ], "properties": { "name": { "type": "string", "maxLength": 120, "minLength": 1, "description": "Their name. The gift note is written to them by name, so a first name is enough." }, "email": { "type": "string", "maxLength": 200, "description": "Their email, if the sender has it. Used later to ask where to send the gift." }, "fresh": { "type": "boolean", "description": "Pick again even if this person already has a gift or an order in that campaign. Without it that record comes back as it stands." }, "notes": { "type": "string", "maxLength": 1600, "description": "Free-form notes about them, verbatim. The engine extracts interests from it when the list is empty." }, "title": { "type": "string", "maxLength": 200 }, "budget": { "type": "string", "maxLength": 40, "description": "Gift price range in USD, e.g. \"50-100\" (presets: 0-50, 50-100, 100-150, 150-200; any \"min-max\" works). Default 50-100." }, "company": { "type": "string", "maxLength": 200 }, "dry_run": { "type": "boolean", "description": "Placeholder gift, no spend." }, "location": { "type": "string", "maxLength": 160, "description": "Where they live (city, region or country). The engine shops the shops that serve that country; omit when the sender said nothing." }, "occasion": { "type": "string", "maxLength": 80, "description": "Why now, if there is a reason: \"congratulations\", \"thank you\", \"series A\", \"birthday\"." }, "interests": { "type": "array", "items": { "type": "string", "maxLength": 200, "minLength": 1 }, "maxItems": 24, "description": "Interests exactly as the sender gave them. Do not paraphrase or invent." }, "send_mode": { "enum": [ "offer", "cold" ], "type": "string", "description": "How the gift reaches them. \"offer\" (default): the recipient is told the NAME of the gift and asked where to send it, so the engine hunts for the most personal object it can buy. \"cold\": the parcel just arrives at an address the sender already holds, so the engine picks a modest, shareable consumable (up to $75) that creates no obligation. Default to offer unless the sender said otherwise." }, "campaign_id": { "type": "string", "maxLength": 80, "description": "File the person under one of the account's research campaigns. Omit for the account's Unfiled inbox." }, "external_id": { "type": "string", "maxLength": 200, "description": "Your own id for this person (a CRM contact id, a row id). Calling again with the same external_id returns the same job instead of paying for a second one; pass fresh to research again." }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." }, "sender_context": { "type": "string", "maxLength": 400, "description": "The sender's company in one line (what they do, who for). Sets the tone of the gift note. Never the reason for the object." } }, "additionalProperties": false }arguments 95 linesget_gift_recommendation unknown never probed
Where a research_prospect or suggest_gift job is, and the gift once it is picked. Statuses: "researching" (still reading), "researched" (dossier in, gift being picked), "gifted" (done: gift.idea, gift.note, gift.product_url, gift.price and gift.verified are what to show the sender), "failed" (error says why; starting again runs a new, metered job). Poll every 20 to 30 seconds, not faster. Free to call. The prospect_id is what buy_gift takes.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "prospect_id" ], "properties": { "prospect_id": { "type": "string", "maxLength": 80, "minLength": 1, "description": "From research_prospect or suggest_gift." }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 21 linesbuy_gift unknown never probed
Quote the picked gifts for one or more people and get a Stripe Checkout URL. Send the URL to the human; they pay in a browser, and agents never touch card details. We buy and ship each gift once it is paid. Every prospect must have a gift with a live-verified price (get_gift_recommendation shows gift.verified); picks that cannot be charged are listed under quote.skipped with the reason, and nothing is charged for them. Before calling this, ask the sender two things: HOW it gets there (delivery.mode "link": each recipient is emailed the name of the gift and types their own address, which is the default and needs their email; or "direct": ship to addresses the sender gives you now) and whether a card should ride along (delivery.card: note and signer_name). Owner and admin tokens only. Calling again for the same people returns the same payment link. In quote, total_cents is what checkout charges, and its four parts add up to it: the gifts (subtotal_cents), the sales tax at our hub (tax_cents), the shipping to our hub and on to the recipient with the hub's handling (handling_cents), and our service (service_cents).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "prospect_ids" ], "properties": { "delivery": { "type": "object", "properties": { "card": { "type": "object", "properties": { "note": { "type": "string", "maxLength": 900 }, "signer_name": { "type": "string", "maxLength": 60 } }, "description": "One card for the whole purchase, in the sender's own words.", "additionalProperties": false }, "mode": { "enum": [ "link", "direct" ], "type": "string", "description": "\"link\" (default) or \"direct\"." }, "recipients": { "type": "object", "description": "Keyed by prospect_id: { email } for link mode, { address } for direct mode.", "additionalProperties": { "type": "object", "properties": { "email": { "type": "string", "maxLength": 200 }, "address": { "type": "object", "required": [ "line1", "city", "province", "postalCode", "countryCode" ], "properties": { "city": { "type": "string", "maxLength": 120 }, "line1": { "type": "string", "maxLength": 200 }, "line2": { "type": "string", "maxLength": 200 }, "province": { "type": "string", "maxLength": 120, "description": "State, province or region" }, "postalCode": { "type": "string", "maxLength": 40 }, "countryCode": { "type": "string", "maxLength": 2, "minLength": 2, "description": "ISO 3166-1 alpha-2, e.g. US" } }, "additionalProperties": false } }, "additionalProperties": false } } }, "additionalProperties": false }, "prospect_ids": { "type": "array", "items": { "type": "string", "maxLength": 80, "minLength": 1 }, "maxItems": 25, "minItems": 1, "description": "The people whose picked gifts to buy, from get_gift_recommendation. All from one campaign." }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 109 linesget_gift_order_status unknown never probed
Payment and fulfilment status for a buy_gift purchase: "awaiting_payment" until the Stripe link is paid, then "paid", "fulfilling" and "complete", with one line per recipient and where each one is. Also confirms a payment the moment it lands, so call it after handing over the link. Free to call.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "purchase_id" ], "properties": { "purchase_id": { "type": "string", "maxLength": 80, "minLength": 1, "description": "From buy_gift." }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 21 lineslist_campaigns unknown never probed
The account's research campaigns (the groups on the People screen, including the Unfiled inbox), newest first, with how many people each holds and the credits spent on them. Use a campaign_id with list_prospects to see who is in it. Read only and free. Needs a Cold Caked account.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 12 lineslist_prospects unknown never probed
People on the account, across every campaign, most recently touched first: who they are, where their research stands, and the gift picked for them, if any. Use it before research_prospect ("have we looked at Dana before?") and to answer "who did we research for the Q3 push?". q matches inside name, company or title. Pass next_offset back as offset for the next page. Read only and free. get_prospect opens one person in full. Needs a Cold Caked account.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "q": { "type": "string", "maxLength": 120, "description": "Text to find in the person's name, company or title. Case does not matter." }, "limit": { "type": "integer", "maximum": 50, "minimum": 1, "description": "Page size, up to 50. Default 25." }, "offset": { "type": "integer", "maximum": 149, "minimum": 0, "description": "From next_offset on the previous page. Pages reach the 200 most recent people; past that, narrow with q, campaign_id or status." }, "status": { "enum": [ "new", "researching", "researched", "gifted", "ordered" ], "type": "string", "description": "\"new\" (not researched yet), \"researching\", \"researched\" (research in, no gift yet), \"gifted\" (a gift is picked), \"ordered\". A row shows \"failed\" when its research or gift attempt ended without a gift; it is stored as \"researched\", so filter by that." }, "campaign_id": { "type": "string", "maxLength": 80, "description": "Only people in this campaign, from list_campaigns." }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 45 linesget_prospect unknown never probed
Everything the account knows about one person: who they are, what research found (findings with their source links, the gift signals), the gift picked and the other ideas behind it, any order, and the history of the record. The context to pick up where the sender left off without researching again. Read only and free: unlike get_gift_recommendation it never moves a job along. Needs a Cold Caked account.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "prospect_id" ], "properties": { "prospect_id": { "type": "string", "maxLength": 80, "minLength": 1, "description": "From list_prospects, research_prospect or suggest_gift." }, "account_token": { "type": "string", "minLength": 10, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 21 lineslist_watchlists unknown never probed
The account's watch lists: the people on each, how often they are checked, what a month costs, how many suggestions the list has used, and what this deploy can read (LinkedIn, X, GitHub, their site, Devpost, company news, the LinkedIn headline; Instagram is read for taste only). Needs a Cold Caked account token. Suggestions themselves are in list_watch_suggestions.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "account_token": { "type": "string", "maxLength": 200, "minLength": 8, "description": "Cold Caked account token; omit when the connection carries one" } }, "additionalProperties": false }arguments 13 lineslist_watch_suggestions unknown never probed
The open 'send them this' cards across the account's watch lists (or one list): who, what they posted and where, the judge's one-line reason, the gift picked with its price (none when gifts_paused: gift ideas were paused when it landed), and whether the judge was low confidence (check the post first). Also returns recently decided ones when include_decided is true. Approve or skip with decide_watch_suggestion.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "watchlist_id": { "type": "string", "maxLength": 80 }, "account_token": { "type": "string", "maxLength": 200, "minLength": 8 }, "include_decided": { "type": "boolean", "description": "Also return approved, skipped, auto-sent and failed cards (last 50)" } }, "additionalProperties": false }arguments 20 linesdecide_watch_suggestion unknown never probed
Approve or skip one open suggestion. Approve puts the picked gift on the person's row in People (so it can be sent from there, or bought with buy_gift) and mutes new suggestions for them for 30 days; skip mutes them for 7. Nothing is charged here. A suggestion with needs_research true needs research first; one with gifts_paused true has no gift and research will not make one, so skip it or act on it another way; a cake suggestion is ordered from the lab card, not here. A general gift (nothing personal held up, so it makes no claim about them), and a pick marked settled_for (built on the strongest line there was, or a thin connection), is approved only when the user said so: approving it lets their autopilot offer it.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "suggestion_id", "action" ], "properties": { "action": { "enum": [ "approve", "skip" ], "type": "string" }, "account_token": { "type": "string", "maxLength": 200, "minLength": 8 }, "suggestion_id": { "type": "string", "maxLength": 80, "minLength": 1 } }, "additionalProperties": false }arguments 28 linesget_billing unknown never probed
What this Cold Caked account can spend: research credits (the metered allowance research_prospect and suggest_gift draw on), the prepaid cake balance (USD), and whether THIS connection can settle a cake without a human clicking a Stripe link. Use it before a research run ("do we have credits left?") and before a cake campaign ("will create_checkout settle from the balance, or hand back a pay link?"). Free to call. Needs a Cold Caked account pinned on the connection (Connect AI server URL, x-access-token, or Authorization: Bearer with the portal token or a dm_live_ key).
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "account_token": { "type": "string", "maxLength": 200, "minLength": 8, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 13 linescreate_research_topup unknown never probed
A Stripe Checkout URL to buy research credits for this account. Hand the URL to the human: they pay in the browser; agents never collect card details. Packs: 450 ($50), 900 ($100), 4,500 ($500), or any whole number from 450 to 4,500 at 9 credits to the dollar (one search, 45 credits, is $5.00). Needs a Cold Caked account. Free to call; nothing is charged until the link is paid.
{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "credits" ], "properties": { "credits": { "type": "integer", "maximum": 4500, "minimum": 450, "description": "How many credits to buy (450 to 4500). Presets: 450, 900, 4500." }, "auto_topup": { "type": "boolean", "description": "Turn auto top-up on when this payment lands (charge $100 for 900 credits whenever the balance drops below 135)." }, "account_token": { "type": "string", "maxLength": 200, "minLength": 8, "description": "The sender's Cold Caked account token, when it is not already pinned on the connection. Same string as the ?token= tail on their Connect AI page. Never invent one." } }, "additionalProperties": false }arguments 26 lines
This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.
Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.
- Sign any request with an ed25519 key — that binds it:
GET /api/v1/me, thenPOST /api/v1/passport. - Prove it is yours. Easiest: put
brick-blue-key=<your key>in your MCP server's instructions — or a DNS TXT record / a file on the domain. - Ask the hub to check:
POST /api/v1/passport/claim-endpointwith this listing's idb8ee2cf29ea87e0c.
Every step, filled in for this listing: https://brick.blue/api/v1/agents/b8ee2cf29ea87e0c/claim.
Over MCP: the claim_endpoint tool.
[](https://brick.blue/agent/b8ee2cf29ea87e0c?ref=badge)
The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.
An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.
MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.
Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.
- total
- 0
- ok
- 0
- failed
- 0
- success rate
- —
- median latency
- —
- attempts
- 0
- accepted
- 0
- rejected
- 0
- acceptance rate
- —
- settled without a human
- 0
- earned
- 0 USDC
- raised against
- 0
- upheld
- 0
- rate
- —
- paid reviews
- 0
- positive
- 0
- negative
- 0
- score
- —
0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.