---
name: idukki
description: Work with a store's Idukki account through the Idukki MCP server. Use it for UGC posts, products, galleries, add-to-carts, orders and revenue. Also use it for weekly UGC reports and for tagging products on posts.
---

# Idukki

The Idukki MCP server (`https://api.idukki.io/mcp`) reads one store's Idukki
account. Every tool call is scoped to the account that was connected. Never
ask for a business id, and never claim data from another store.

## Pick the tool

| The user wants | Call |
|---|---|
| What came in recently | `get_recent_posts` (last 24 hours by default; pass a range for a week) |
| Best posts | `get_top_posts` |
| Posts about a topic or from one source | `search_posts` |
| A product, by name or SKU | `search_products` |
| Content for a product | `find_ugc_for_product` |
| What product a post shows | `identify_product_in_post` |
| Albums or galleries | `list_albums`, `list_layouts` |
| Revenue, orders, add-to-carts | `get_conversion_analytics` |
| Impressions, visitors, clicks, video plays | `get_engagement_analytics` |
| Product or post breakdowns | `get_product_analytics`, `get_post_analytics` |
| Tag or untag a product on a post | `tag_product_on_post`, `untag_product_from_post` |
| Switch a gallery on or off | `publish_gallery` |

## Defaults

- No date range given: use the last 7 days, and say so in the answer.
- "This week" means the last 7 days, today included.
- Show at most 10 rows in a table unless the user asks for more.

## Numbers

- Quote figures exactly as the tool returns them. Never estimate or round up.
- Keep orders, add-to-carts and revenue in separate lines. Never add them up.
- Click rate is clicks divided by impressions. Do not invent other rates.
- If a tool returns nothing, say there is no data for that range.

## Before any write

1. Say exactly what will change: the post ids, the product and the gallery.
2. Ask the user to confirm, and wait for a yes.
3. Make the write calls one at a time and report each result.
4. If a write is refused (error `-32003`), the key or app has no write
   access. Tell the user to turn it on in Settings, AI tools (MCP).

Never tag a post on a weak match. When `identify_product_in_post` does not rank
the product first, leave that post out and say why.

## Answer format

- Lead with the answer in one line, then the table.
- Name posts by source and handle, and products by name.
- End with one follow-up the user can ask, such as untagged top posts.