Tools Reference
The Pitaia MCP server exposes 16 tools. Tools are filtered by the token's scopes; every call is limited to the token's store and recorded in the audit log. All money values are integers in cents.
Read tools
analytics_overview
Store performance summary: revenue, visits, leads, orders with trends.
| Parameter | Type | Description |
|---|---|---|
period | "7d" | "14d" | "30d" (default "30d") | Time window |
analytics_revenue_series
Daily revenue time series for a period.
| Parameter | Type | Description |
|---|---|---|
period | "7d" | "14d" | "30d" (default "30d") | Time window |
analytics_product_performance
Per-product performance for a period.
| Parameter | Type | Description |
|---|---|---|
period | "7d" | "14d" | "30d" (default "30d") | Time window |
product_list
List all products in the store. No parameters.
product_get
Get a single product by id.
| Parameter | Type | Description |
|---|---|---|
productId | string | Product id |
memory_search
Semantic search over the creator's saved memories.
| Parameter | Type | Description |
|---|---|---|
query | string | Search query |
matchCount | number (optional, 1–20) | Max results (default 5) |
get_store_goal
Get the store's current active goal. No parameters.
Write tools
product_create
Create a new product as a draft.
| Parameter | Type | Description |
|---|---|---|
name | string | Product name |
description | string (optional) | Product description |
type | "digital_download" | "url_media" | "course" | Product type |
priceInCents | number | Price in cents |
product_update
Update fields of an existing product.
| Parameter | Type | Description |
|---|---|---|
id | string | Product id |
name | string (optional) | New name |
description | string (optional) | New description |
priceInCents | number (optional) | New price in cents |
set_store_goal
Set or update the store's goal.
| Parameter | Type | Description |
|---|---|---|
goalType | "sell_infoproducts" | "sell_consultations" | "grow_audience" | "reactivate_customers" | Canonical goal category |
detail | string (optional) | The creator's own phrasing of the goal |
memory_save
Save a new creator memory.
| Parameter | Type | Description |
|---|---|---|
category | "preference" | "business" | "interaction" | "decision" | Memory category |
content | string | Memory content (max 2000 chars) |
memory_update
Update an existing memory's content.
| Parameter | Type | Description |
|---|---|---|
memoryId | string | Memory id |
content | string | New content |
theme_generate
Generate a store theme proposal from a natural-language description. Returns a proposal; does not apply it.
| Parameter | Type | Description |
|---|---|---|
prompt | string | Description of the desired theme |
theme_extract
Extract a theme proposal from a website URL. Returns a proposal; does not apply it.
| Parameter | Type | Description |
|---|---|---|
url | string (URL) | Website URL |
generate_charge (human-gated)
Draft a checkout charge for a catalog product. The price always comes from
the catalog — the agent cannot set it. Creates a pending_approval draft;
the payment link is only sent after the creator approves it in the dashboard.
| Parameter | Type | Description |
|---|---|---|
product | string | Product name, exactly as in the catalog |
quantity | number (optional) | How many units (default 1) |
compose_report
Compose and post a visual report card to the store activity feed. Omit all fields for a default weekly performance report.
| Parameter | Type | Description |
|---|---|---|
title | string (optional) | Short report title in the seller's language |
narration | string (optional) | One or two sentence summary |
Deliberately excluded
Destructive operations (product_delete, memory_delete, calendar event
deletion) are excluded from the MCP surface by design.