create_invoice

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.

destructive

Argument	Type	Description
brief	string	Notes for the creator's own record
lines*	array	The priced parts. The total is always their sum.
split	string	How a one-off invoice is paid. Default in_full. For a deposit of your own, use deposit instead.
title*	string
client*	object	Who the quote or invoice is for
deposit	object	A custom deposit then the rest: a whole percent 1 to 99, or an amount
send_by	string	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.
currency*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "client",
    "title",
    "currency",
    "lines"
  ],
  "properties": {
    "brief": {
      "type": "string",
      "maxLength": 1200,
      "description": "Notes for the creator's own record"
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description",
          "unit_price"
        ],
        "properties": {
          "from": {
            "type": "boolean",
            "description": "A base price that may rise; changes no maths"
          },
          "note": {
            "type": "string",
            "maxLength": 160,
            "description": "A short line under it"
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 9999,
            "minimum": 1
          },
          "unit_price": {
            "type": "string",
            "pattern": "^[0-9]+(\\.[0-9]+)?$",
            "description": "In major units, as a string, like \"241.62\""
          },
          "description": {
            "type": "string",
            "maxLength": 120
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "The priced parts. The total is always their sum."
    },
    "split": {
      "enum": [
        "in_full",
        "50_50",
        "30_70"
      ],
      "type": "string",
      "description": "How a one-off invoice is paid. Default in_full. For a deposit of your own, use deposit instead."
    },
    "title": {
      "type": "string",
      "maxLength": 120
    },
    "client": {
      "type": "object",
      "required": [
        "name"
      ],
      "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"
        }
      },
      "description": "Who the quote or invoice is for",
      "additionalProperties": false
    },
    "deposit": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "string",
          "pattern": "^[0-9]+(\\.[0-9]+)?$",
          "description": "In major units, as a string, like \"241.62\""
        },
        "percent": {
          "type": "integer",
          "maximum": 99,
          "minimum": 1
        }
      },
      "description": "A custom deposit then the rest: a whole percent 1 to 99, or an amount",
      "additionalProperties": false
    },
    "send_by": {
      "enum": [
        "email",
        "sms",
        "both",
        "self"
      ],
      "type": "string",
      "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."
    },
    "currency": {
      "enum": [
        "USD",
        "EUR",
        "GBP",
        "CAD",
        "AUD",
        "GHS",
        "NGN",
        "KES",
        "ZAR",
        "XOF",
        "INR",
        "BRL"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

create_quote

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.

destructive

Argument	Type	Description
lines*	array	The priced parts. The total is always their sum.
split	string	How a one-off invoice is paid. Default in_full. For a deposit of your own, use deposit instead.
title*	string	What the quote is for
client*	object	Who the quote or invoice is for
deposit	object	A custom deposit then the rest: a whole percent 1 to 99, or an amount
options	array	Default one_off
send_by	string

design_page

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.

destructive

Argument	Type	Description
add	array	New links or widgets, only from addresses the creator gave you. Links must be https.
bio	string	Plain text
look	object	The page's buttons. Fonts and backgrounds are not available.
titles	array	New titles for links or widgets, by id from get_page
sections	array	The tabs shown, in order. The first opens first.
links_order	array	Link and widget ids in the new order; new:0 is the first item of add. Ones left out follow in their order.
rates_order	array	Rate ids in the new order. Ones left out follow.

get_deal

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.

read-only

Argument	Type	Description
deal_id*	string	The request_id from submit_request

Input schema (JSON)

{
  "type": "object",
  "required": [
    "deal_id"
  ],
  "properties": {
    "deal_id": {
      "type": "string",
      "description": "The request_id from submit_request"
    }
  },
  "additionalProperties": false
}

get_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.

read-only

Argument	Type	Description
invoice*	string	The number, like INV-0042

Input schema (JSON)

{
  "type": "object",
  "required": [
    "invoice"
  ],
  "properties": {
    "invoice": {
      "type": "string",
      "description": "The number, like INV-0042"
    }
  },
  "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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_rate_card

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.

read-only

Argument	Type	Description
handle*	string	The creator's Piku handle, like nia

Input schema (JSON)

{
  "type": "object",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "description": "The creator's Piku handle, like nia"
    }
  },
  "additionalProperties": false
}

list_deals

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.

read-only

Argument	Type	Description
limit	integer
stage	string
client	string	Part of the client's name

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "stage": {
      "enum": [
        "requested",
        "quoted",
        "accepted",
        "invoiced",
        "paid",
        "declined",
        "cancelled",
        "draft"
      ],
      "type": "string"
    },
    "client": {
      "type": "string",
      "maxLength": 80,
      "description": "Part of the client's name"
    }
  },
  "additionalProperties": false
}

list_invoices

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.

read-only

Argument	Type	Description
limit	integer
client	string
status	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1
    },
    "client": {
      "type": "string",
      "maxLength": 80
    },
    "status": {
      "enum": [
        "due",
        "overdue",
        "paid",
        "void"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_page_drafts

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.

read-only

Argument	Type	Description
limit	integer

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

search_creators

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.

read-only

Argument	Type	Description
niche	string	Words like skincare, travel, code reviews
cursor	string
location	string	A city, a country name or code, or both, like Accra, Ghana
platform	string	Platform of the Rate
max_from_price	object

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "niche": {
      "type": "string",
      "maxLength": 60,
      "description": "Words like skincare, travel, code reviews"
    },
    "cursor": {
      "type": "string"
    },
    "location": {
      "type": "string",
      "maxLength": 60,
      "description": "A city, a country name or code, or both, like Accra, Ghana"
    },
    "platform": {
      "enum": [
        "instagram",
        "youtube",
        "tiktok",
        "other"
      ],
      "type": "string",
      "description": "Platform of the Rate"
    },
    "max_from_price": {
      "type": "object",
      "required": [
        "amount",
        "currency"
      ],
      "properties": {
        "amount": {
          "type": "number",
          "exclusiveMinimum": 0
        },
        "currency": {
          "type": "string",
          "pattern": "^[A-Za-z]{3}$"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

send_draft

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.

destructive

Argument	Type	Description
draft_id*	string	The draft_id create_quote or create_invoice returned

Input schema (JSON)

{
  "type": "object",
  "required": [
    "draft_id"
  ],
  "properties": {
    "draft_id": {
      "type": "string",
      "description": "The draft_id create_quote or create_invoice returned"
    }
  },
  "additionalProperties": false
}

submit_request

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.

destructive

Argument	Type	Description
brand*	object
brief*	string	What the brand needs, in a few lines
handle*	string
rate_id*	string	The Rate's id from get_rate_card, like ig-reel

Input schema (JSON)

{
  "type": "object",
  "required": [
    "handle",
    "rate_id",
    "brand",
    "brief"
  ],
  "properties": {
    "brand": {
      "type": "object",
      "required": [
        "name",
        "email"
      ],
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 80
        },
        "email": {
          "type": "string",
          "format": "email",
          "maxLength": 160
        }
      },
      "additionalProperties": false
    },
    "brief": {
      "type": "string",
      "maxLength": 1200,
      "minLength": 10,
      "description": "What the brand needs, in a few lines"
    },
    "handle": {
      "type": "string"
    },
    "rate_id": {
      "type": "string",
      "description": "The Rate's id from get_rate_card, like ig-reel"
    }
  },
  "additionalProperties": false
}

Piku

Try it

create_invoice Destructive

Piku

Try it

create_invoice Destructive

Install

Tools (13)

Security checkA100/100