# Piku

> Find creators and read their Rate Cards. Creators draft quotes and invoices on their Piku account.

- name: com.usepiku/piku
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 95/100
- quality: 80/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.usepiku%2Fpiku
- tools: https://api.protogrid.dev/v1/servers/com.usepiku%2Fpiku/tools

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

## Connection (mcpServers)

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


## Trust

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

## Quality 80/100 (good)

### protocol: 75 (weight 25)

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

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

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

### tool hygiene: 100 (weight 30)

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

### stability: 50 (weight 15)

- warn `stability.changes`: 23 tool changes in 30 days
- fail `stability.rug_pull`: 2 tools kept their name but changed most of their description in 30 days; review before trusting them
- pass `stability.new_links`: no tool change named a new site

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

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

- tools: 18, about 6,839 tokens to load them all
- tool set hash: 1c6fae774eeaf756e6e2c2d17a6c40bd
- tools last changed: 2026-11-12T08:57:05.557Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.usepiku/piku.svg)](https://protogrid.dev/servers/com.usepiku/piku)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-12 `search_creators` changed (description)
  - before: Deprecated: use search. This name works until 2027-02-09. Find creators and businesses on Piku: photographers, guides, designers, studios, boutique hotels and more. Match by words (what they do, their niche, their Rates), a place (a city, a country name or code), a category, a language, or a point and a radius. kind picks creators, business or any (claimed pages first). Results show where each one is, whether the page is claimed, and when it last changed; unclaimed business pages have no prices and take no requests. Prices are starting prices in the page's currency; max_from_price is compared after converting currencies. Results are paged: pass next_cursor back as cursor.
  - after: Deprecated: use search. This name works until 2027-02-09. Find creators and businesses on Piku: photographers, studios, hotels and more. Match by words (what they do, niche, Rates; related work counts), a place (city, region or country), a category, a language, or a point and radius. kind: creator, business or any (claimed pages first). Results show where each is, whether it is claimed and when it changed; unclaimed business pages have no prices and take no requests. max_from_price is compared across currencies. Pass next_cursor back as cursor. If nothing matches as asked, the search widens step by step and widened says what changed: tell the user. If still nothing, note gives a next step.
- 2026-11-12 `search` changed (description)
  - before: Find creators and businesses on Piku: photographers, guides, designers, studios, boutique hotels and more. Match by words (what they do, their niche, their Rates), a place (a city, a country name or code), a category, a language, or a point and a radius. kind picks creators, business or any (claimed pages first). Results show where each one is, whether the page is claimed, and when it last changed; unclaimed business pages have no prices and take no requests. Prices are starting prices in the page's currency; max_from_price is compared after converting currencies. Results are paged: pass next_cursor back as cursor.
  - after: Find creators and businesses on Piku: photographers, studios, hotels and more. Match by words (what they do, niche, Rates; related work counts), a place (city, region or country), a category, a language, or a point and radius. kind: creator, business or any (claimed pages first). Results show where each is, whether it is claimed and when it changed; unclaimed business pages have no prices and take no requests. max_from_price is compared across currencies. Pass next_cursor back as cursor. If nothing matches as asked, the search widens step by step and widened says what changed: tell the user. If still nothing, note gives a next step.
- 2026-11-11 `search_creators` changed (inputSchema)
- 2026-11-11 `search` changed (inputSchema)
- 2026-11-11 `get_rate_card` changed (title, description, inputSchema, annotations) **meaning changed**
  - before: 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, the questions the creator asks on a request (answer them in submit_request), and the self-reported audience.
  - after: Deprecated: use get_page_info. This name works until 2027-02-09. Everything a page shares, in one shape. A claimed page (creator or business): its Rates with their stable ids, price as the page shows it (visibility full, from_price or request_only), how each is charged (once, hour, day, night, person, project), guests it fits, whether it takes requests now (open, paused, fully_booked), what it includes, the questions asked on a request (answer them in submit_request), and when it last changed. An unclaimed business page: public facts with their sources, its location, phone and own channels, marked unclaimed, with no prices and no requests: send the person to its own channels.
- 2026-11-11 `search_creators` changed (title, description, inputSchema, annotations) **meaning changed**
  - before: 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.
  - after: Deprecated: use search. This name works until 2027-02-09. Find creators and businesses on Piku: photographers, guides, designers, studios, boutique hotels and more. Match by words (what they do, their niche, their Rates), a place (a city, a country name or code), a category, a language, or a point and a radius. kind picks creators, business or any (claimed pages first). Results show where each one is, whether the page is claimed, and when it last changed; unclaimed business pages have no prices and take no requests. Prices are starting prices in the page's currency; max_from_price is compared after converting currencies. Results are paged: pass next_cursor back as cursor.
- 2026-11-11 `submit_request` changed (description, inputSchema)
  - before: 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. When the Rate has questions (get_rate_card), pass answers by question id: every required one, and a choice exactly as one of its options. Returns a request_id.
  - after: 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. When the Rate has questions (get_page_info), pass answers by question id: every required one, and a choice exactly as one of its options. Returns a request_id.
- 2026-11-11 `get_page_info` added
  - Everything a page shares, in one shape. A claimed page (creator or business): its Rates with their stable ids, price as the page shows it (visibility full, from_price or request_only), how each is charged (once, hour, day, night, person, project), guests it fits, whether it takes requests now (open, paused, fully_booked), what it includes, the questions asked on a request (answer them in submit_request), and when it last changed. An unclaimed business page: public facts with their sources, its location, phone and own channels, marked unclaimed, with no prices and no requests: send the person to its own channels.
- 2026-11-11 `search` added
  - Find creators and businesses on Piku: photographers, guides, designers, studios, boutique hotels and more. Match by words (what they do, their niche, their Rates), a place (a city, a country name or code), a category, a language, or a point and a radius. kind picks creators, business or any (claimed pages first). Results show where each one is, whether the page is claimed, and when it last changed; unclaimed business pages have no prices and take no requests. Prices are starting prices in the page's currency; max_from_price is compared after converting currencies. Results are paged: pass next_cursor back as cursor.
- 2026-11-07 `get_insights` added
  - Creators only, on their own Piku account (asks them to connect). Page insights for the connected creator's public page over the last 30 days: visits, taps, tap rate (visits with a tap) and Rate requests, each with the change against the 30 days before; each link and widget in page order with the share of visits that saw it and its tap rate; sources; countries; the busiest two hours for taps in the creator's time zone; the Rate path; and the one open suggestion. Counts only, never who. Read only. When Page insights is not open on the account, says so.

Full history: https://api.protogrid.dev/v1/servers/com.usepiku%2Fpiku/changes

## Remotes

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

## Packages

_none_

## Tools (18)

- `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. Piku's fee is 1% of each paid invoice, never more than $10, paid by the client by default; the creator can choose to cover it in Settings.
- `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 first and later invoice totals and a link to see it in Piku.
- `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 look (theme and buttons), bio, link titles, the order of links, widgets, sections and Rates, new links or widgets the creator gave you, groups (a list or a sideways row), up to 2 Rate buttons under the bio, and the Portfolio's numbers and productions. Every field is optional; give only what changes. A style and palette set the look. 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 and a preview_url.
- `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.
- `get_events`: Creators only, on their own Piku account (asks them to connect). The connected creator's ticketed events, newest first: title, dates, status (draft, on_sale, ended, cancelled), the public link, tickets sold, ticket sales, and how many were checked in at the door. Counts only, never who bought or came. When Events are not open on the account, says so.
- `get_insights`: Creators only, on their own Piku account (asks them to connect). Page insights for the connected creator's public page over the last 30 days: visits, taps, tap rate (visits with a tap) and Rate requests, each with the change against the 30 days before; each link and widget in page order with the share of visits that saw it and its tap rate; sources; countries; the busiest two hours for taps in the creator's time zone; the Rate path; and the one open suggestion. Counts only, never who. Read only. When Page insights is not open on the account, says so.
- `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.
- `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 (social profiles with how they show), Rates in order (with any button words), groups (name, layout list or row, item ids), the Portfolio's numbers strip and productions, the choices the page builder offers, the Page styles (who each suits, palettes, what to arrange), and any open Page draft.
- `get_page_info`: Everything a page shares, in one shape. A claimed page (creator or business): its Rates with their stable ids, price as the page shows it (visibility full, from_price or request_only), how each is charged (once, hour, day, night, person, project), guests it fits, whether it takes requests now (open, paused, fully_booked), what it includes, the questions asked on a request (answer them in submit_request), and when it last changed. An unclaimed business page: public facts with their sources, its location, phone and own channels, marked unclaimed, with no prices and no requests: send the person to its own channels.
- `get_rate_card`: Deprecated: use get_page_info. This name works until 2027-02-09. Everything a page shares, in one shape. A claimed page (creator or business): its Rates with their stable ids, price as the page shows it (visibility full, from_price or request_only), how each is charged (once, hour, day, night, person, project), guests it fits, whether it takes requests now (open, paused, fully_booked), what it includes, the questions asked on a request (answer them in submit_request), and when it last changed. An unclaimed business page: public facts with their sources, its location, phone and own channels, marked unclaimed, with no prices and no requests: send the person to its own channels.
- `get_wallet`: Creators only, on their own Piku account (asks them to connect). The connected creator's Piku Wallet: the balance by currency (available, and pending for withdrawals not landed yet), the total withdrawn, the latest withdrawals with their status (Asked, Approved, On hold, Sent, Received, Paid or Failed) and the minimum one withdrawal can be. Read only: it cannot withdraw or move money. When the wallet is not open on the account, says so.
- `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.
- `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.
- `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.
- `search`: Find creators and businesses on Piku: photographers, studios, hotels and more. Match by words (what they do, niche, Rates; related work counts), a place (city, region or country), a category, a language, or a point and radius. kind: creator, business or any (claimed pages first). Results show where each is, whether it is claimed and when it changed; unclaimed business pages have no prices and take no requests. max_from_price is compared across currencies. Pass next_cursor back as cursor. If nothing matches as asked, the search widens step by step and widened says what changed: tell the user. If still nothing, note gives a next step.
- `search_creators`: Deprecated: use search. This name works until 2027-02-09. Find creators and businesses on Piku: photographers, studios, hotels and more. Match by words (what they do, niche, Rates; related work counts), a place (city, region or country), a category, a language, or a point and radius. kind: creator, business or any (claimed pages first). Results show where each is, whether it is claimed and when it changed; unclaimed business pages have no prices and take no requests. max_from_price is compared across currencies. Pass next_cursor back as cursor. If nothing matches as asked, the search widens step by step and widened says what changed: tell the user. If still nothing, note gives a next step.
- `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.
- `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. When the Rate has questions (get_page_info), pass answers by question id: every required one, and a choice exactly as one of its options. Returns a request_id.
