Piku
Find creators and read their Rate Cards. Creators draft quotes and invoices on their Piku account.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"piku": {
"url": "https://usepiku.com/mcp"
}
}
}Remote endpoints
https://usepiku.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (13)
🟢search_creators(niche, location, platform, max_from_price, cursor)
Find creators with a live Piku page by niche words (matched against the niches they chose, then their bio and Rates), location (their city and country, then their bio), platform and starting price. Prices are starting prices in the creator's currency; max_from_price is compared after converting currencies. Creators who share prices on request are left out when max_from_price is set. Results are paged: pass next_cursor back as cursor.
Input Schema
{
"type": "object",
"properties": {
"niche": {
"type": "string",
"description": "Words like skincare, travel, code reviews",
"maxLength": 60
},
"location": {
"type": "string",
"description": "A city, a country name or code, or both, like Accra, Ghana",
"maxLength": 60
},
"platform": {
"type": "string",
"enum": [
"instagram",
"youtube",
"tiktok",
"other"
],
"description": "Platform of the Rate"
},
"max_from_price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"cursor": {
"type": "string"
}
},
"additionalProperties": false
}🟢get_rate_card(handle)
A creator's Rate Card and media kit: every Rate with its stable id, price as the creator shows it (visibility full, from_price or request_only), what it includes, and the self-reported audience.
Input Schema
{
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "The creator's Piku handle, like nia"
}
},
"required": [
"handle"
],
"additionalProperties": false
}🔴submit_request(handle, rate_id, brand, brief)
Send a brand's request on one Rate of a creator. Piku emails the brand a confirm link; the request reaches the creator's Deals only after the brand confirms, within 48 hours. Needs the creator's handle, the Rate id, the brand's name and contact email, and a short brief, as the user gave them. Returns a request_id.
Input Schema
{
"type": "object",
"properties": {
"handle": {
"type": "string"
},
"rate_id": {
"type": "string",
"description": "The Rate's id from get_rate_card, like ig-reel"
},
"brand": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"email": {
"type": "string",
"format": "email",
"maxLength": 160
}
},
"required": [
"name",
"email"
],
"additionalProperties": false
},
"brief": {
"type": "string",
"minLength": 10,
"maxLength": 1200,
"description": "What the brand needs, in a few lines"
}
},
"required": [
"handle",
"rate_id",
"brand",
"brief"
],
"additionalProperties": false
}🟢get_deal(deal_id)
Where a request stands: awaiting_confirmation, expired, requested, quoted, accepted or declined. Pass the request_id from submit_request as deal_id. When quoted, the quote total, currency and the brand's approval link are included.
Input Schema
{
"type": "object",
"properties": {
"deal_id": {
"type": "string",
"description": "The request_id from submit_request"
}
},
"required": [
"deal_id"
],
"additionalProperties": false
}🟢list_deals(client, stage, limit)
Creators only, on their own Piku account (asks them to connect). The connected creator's Deals, newest first, and their unsent Drafts. Each has its client, title, stage, amount and id. Filter by client name or stage.
Input Schema
{
"type": "object",
"properties": {
"client": {
"type": "string",
"maxLength": 80,
"description": "Part of the client's name"
},
"stage": {
"type": "string",
"enum": [
"requested",
"quoted",
"accepted",
"invoiced",
"paid",
"declined",
"cancelled",
"draft"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
}
},
"additionalProperties": false
}🔴create_quote(client, title, currency, lines, options, ...)
Creators only, on their own Piku account (asks them to connect). Prepare a quote to one of the creator's clients as a Draft: Lines, up to three billing options (one_off, monthly, quarterly, annual), payment terms and split. client.email is where the link goes: without it (and send_by email or both) the tool answers needs_client_email. send_by self emails nothing. Nothing is sent and no number is used: a Draft goes to the client only through send_draft, after the creator has seen it and said yes. Returns the draft_id, every Line, each option's invoice total and a link to see it in Piku.
Input Schema
{
"type": "object",
"properties": {
"client": {
"type": "object",
"description": "Who the quote or invoice is for",
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"email": {
"type": "string",
"format": "email",
"maxLength": 160,
"description": "Where the link goes (needed unless send_by is sms)"
},
"phone": {
"type": "string",
"maxLength": 24,
"description": "For send_by sms or both"
},
"phone_country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country of the phone, like GH"
}
},
"required": [
"name"
],
"additionalProperties": false
},
"title": {
"type": "string",
"maxLength": 120,
"description": "What the quote is for"
},
"currency": {
"type": "string",
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"GHS",
"NGN",
"KES",
"ZAR",
"XOF",
"INR",
"BRL"
]
},
"lines": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"description": "The priced parts. The total is always their sum.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"maxLength": 120
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 9999,
"default": 1
},
"unit_price": {
"type": "string",
"pattern": "^[0-9]+(\\.[0-9]+)?$",
"description": "In major units, as a string, like \"241.62\""
},
"note": {
"type": "string",
"maxLength": 160,
"description": "A short line under it"
},
"from": {
"type": "boolean",
"description": "A base price that may rise; changes no maths"
}
},
"required": [
"description",
"unit_price"
],
"additionalProperties": false
}
},
"options": {
"type": "array",
"items": {
"type": "string",
"enum": [
"one_off",
"monthly",
"quarterly",
"annual"
]
},
"minItems": 1,
"maxItems": 3,
"uniqueItems": true,
"description": "Default one_off"
},
"lines_per": {
"type": "string",
"enum": [
"month",
"quarter"
],
"description": "What each Line's price covers when an option repeats. Default quarter. Monthly needs month."
},
"due_days": {
"type": "integer",
"enum": [
0,
7,
14,
30
],
"description": "Days after issue each invoice is due. Default 14."
},
"split": {
"type": "string",
"enum": [
"in_full",
"50_50",
"30_70"
],
"description": "How a one-off invoice is paid. Default in_full. For a deposit of your own, use deposit instead."
},
"deposit": {
"type": "object",
"description": "A custom deposit then the rest: a whole percent 1 to 99, or an amount",
"properties": {
"percent": {
"type": "integer",
"minimum": 1,
"maximum": 99
},
"amount": {
"type": "string",
"pattern": "^[0-9]+(\\.[0-9]+)?$",
"description": "In major units, as a string, like \"241.62\""
}
},
"additionalProperties": false
},
"send_by": {
"type": "string",
"enum": [
"email",
"sms",
"both",
"self"
],
"description": "How the client gets it once sent. Default email. self: nothing goes to the client; the creator downloads the PDF from Piku and sends it themselves, so no email is needed."
}
},
"required": [
"client",
"title",
"currency",
"lines"
],
"additionalProperties": false
}🔴create_invoice(client, title, brief, currency, lines, ...)
Creators only, on their own Piku account (asks them to connect). Prepare an invoice to one of the creator's clients as a Draft, paid in full or split. client.email is where the link goes: without it (and send_by email or both) the tool answers needs_client_email. send_by self emails nothing. Nothing is sent and no number is used: a Draft goes to the client only through send_draft, after the creator has seen it and said yes. The invoice number is given only when it is sent.
Input Schema
{
"type": "object",
"properties": {
"client": {
"type": "object",
"description": "Who the quote or invoice is for",
"properties": {
"name": {
"type": "string",
"maxLength": 80
},
"email": {
"type": "string",
"format": "email",
"maxLength": 160,
"description": "Where the link goes (needed unless send_by is sms)"
},
"phone": {
"type": "string",
"maxLength": 24,
"description": "For send_by sms or both"
},
"phone_country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country of the phone, like GH"
}
},
"required": [
"name"
],
"additionalProperties": false
},
"title": {
"type": "string",
"maxLength": 120
},
"brief": {
"type": "string",
"maxLength": 1200,
"description": "Notes for the creator's own record"
},
"currency": {
"type": "string",
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"GHS",
"NGN",
"KES",
"ZAR",
"XOF",
"INR",
"BRL"
]
},
"lines": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"description": "The priced parts. The total is always their sum.",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"maxLength": 120
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 9999,
"default": 1
},
"unit_price": {
"type": "string",
"pattern": "^[0-9]+(\\.[0-9]+)?$",
"description": "In major units, as a string, like \"241.62\""
},
"note": {
"type": "string",
"maxLength": 160,
"description": "A short line under it"
},
"from": {
"type": "boolean",
"description": "A base price that may rise; changes no maths"
}
},
"required": [
"description",
"unit_price"
],
"additionalProperties": false
}
},
"split": {
"type": "string",
"enum": [
"in_full",
"50_50",
"30_70"
],
"description": "How a one-off invoice is paid. Default in_full. For a deposit of your own, use deposit instead."
},
"deposit": {
"type": "object",
"description": "A custom deposit then the rest: a whole percent 1 to 99, or an amount",
"properties": {
"percent": {
"type": "integer",
"minimum": 1,
"maximum": 99
},
"amount": {
"type": "string",
"pattern": "^[0-9]+(\\.[0-9]+)?$",
"description": "In major units, as a string, like \"241.62\""
}
},
"additionalProperties": false
},
"send_by": {
"type": "string",
"enum": [
"email",
"sms",
"both",
"self"
],
"description": "How the client gets it once sent. Default email. self: nothing goes to the client; the creator downloads the PDF from Piku and sends it themselves, so no email is needed."
}
},
"required": [
"client",
"title",
"currency",
"lines"
],
"additionalProperties": false
}🟢list_invoices(client, status, limit)
Creators only, on their own Piku account (asks them to connect). The connected creator's invoices, newest first: number, client, amount, status (due, overdue, paid, void) and due date. Invoices the creator archived are left out; get_invoice still reads one by its number.
Input Schema
{
"type": "object",
"properties": {
"client": {
"type": "string",
"maxLength": 80
},
"status": {
"type": "string",
"enum": [
"due",
"overdue",
"paid",
"void"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
}
},
"additionalProperties": false
}🟢get_invoice(invoice)
Creators only, on their own Piku account (asks them to connect). One invoice by its number, like INV-0042: its Lines, amount, status, due date, period, receipt and pay link.
Input Schema
{
"type": "object",
"properties": {
"invoice": {
"type": "string",
"description": "The number, like INV-0042"
}
},
"required": [
"invoice"
],
"additionalProperties": false
}🔴send_draft(draft_id)
Creators only, on their own Piku account (asks them to connect). Send one Draft to its client: a quote goes out with its accept link; an invoice is numbered and goes out with its pay link (or, with send_by self, is marked sent for the creator to send). For use only after the creator has seen this Draft and said yes to sending it. Sending the same Draft again sends nothing.
Input Schema
{
"type": "object",
"properties": {
"draft_id": {
"type": "string",
"description": "The draft_id create_quote or create_invoice returned"
}
},
"required": [
"draft_id"
],
"additionalProperties": false
}🟢get_page
Creators only, on their own Piku account (asks them to connect). The connected creator's public page as data: name, bio, the button look (colour, shape, alignment), the sections (tabs) in order, links and widgets with their ids, Rates in order, the choices the page builder offers, and any open Page draft.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🔴design_page(look, bio, titles, links_order, sections, ...)
Creators only, on their own Piku account (asks them to connect). Propose a design for the creator's page as a Page draft: any of the button look, bio, link titles, the order of links, widgets, sections and Rates, and new links or widgets from addresses the creator gave you. Every field is optional; give only what changes. Nothing on the live page changes: the creator previews the Page draft and applies it, or parts of it, in the page builder. A new design replaces the open one. Returns the draft_id, the changes by part (Look, Order, Text, New links) and a preview_url.
Input Schema
{
"type": "object",
"properties": {
"look": {
"type": "object",
"description": "The page's buttons. Fonts and backgrounds are not available.",
"properties": {
"button_colour": {
"type": "string",
"pattern": "^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$",
"description": "Like #4A2073. get_page lists the named ones"
},
"button_shape": {
"type": "string",
"enum": [
"rounded",
"square",
"pill"
]
},
"button_align": {
"type": "string",
"enum": [
"left",
"center"
],
"description": "Where titles sit on the buttons"
}
},
"additionalProperties": false
},
"bio": {
"type": "string",
"minLength": 1,
"maxLength": 280,
"description": "Plain text"
},
"titles": {
"type": "array",
"maxItems": 50,
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 60
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
},
"description": "New titles for links or widgets, by id from get_page"
},
"links_order": {
"type": "array",
"maxItems": 200,
"uniqueItems": true,
"items": {
"type": "string"
},
"description": "Link and widget ids in the new order; new:0 is the first item of add. Ones left out follow in their order."
},
"sections": {
"type": "array",
"minItems": 1,
"maxItems": 3,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"links",
"rates",
"media-kit"
]
},
"description": "The tabs shown, in order. The first opens first."
},
"rates_order": {
"type": "array",
"maxItems": 200,
"uniqueItems": true,
"items": {
"type": "string"
},
"description": "Rate ids in the new order. Ones left out follow."
},
"add": {
"type": "array",
"maxItems": 10,
"description": "New links or widgets, only from addresses the creator gave you. Links must be https.",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"link",
"youtube",
"tiktok",
"instagram",
"spotify",
"apple-music",
"whatsapp"
],
"default": "link"
},
"title": {
"type": "string",
"maxLength": 60
},
"url": {
"type": "string",
"description": "For type link: an https address"
},
"value": {
"type": "string",
"description": "For a widget: its https link, or the WhatsApp number with country code"
},
"text": {
"type": "string",
"maxLength": 300,
"description": "WhatsApp only: the first message"
},
"size": {
"type": "string",
"enum": [
"compact",
"full",
"card"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}🟢list_page_drafts(limit)
Creators only, on their own Piku account (asks them to connect). The connected creator's recent Page drafts: status (draft, applied, discarded, replaced, expired), the parts applied, and the preview link.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 10
}
},
"additionalProperties": false
}Community
Evidence