# estimate_cost

> Estimate credits with Wavegrain's MCP server: the estimate_cost tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**Estimate credits.** Permission: `read`. Read-only: changes nothing.

The most credits one slideshow (or one copy_post, with copyPost) can cost, split by script, photos and images per slide, with your balance and this key's daily limit. Free.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `formatId` | string | no | A saved format from list_formats. Default: your active brand with the settings below. up to 200 characters |
| `brandId` | string | no | Only without formatId: the brand to write for. Default: your active brand. up to 200 characters |
| `groupId` | string | no | Only without formatId: an account group (list_accounts) whose notes shape the script. up to 200 characters |
| `slideCount` | integer | no | Only without formatId: how many slides. Default 6. 3 to 10 |
| `structure` | "hook-proof-cta" \| "listicle" \| "before-after" \| "educational" \| "story" \| "quote" \| "ranking" | no | The kind of post: hook-proof-cta (Hook, proof, then a clear call to action); listicle (A numbered list); before-after (A transformation or comparison); educational (Teaches one idea step by step); story (A first-person narrative arc); quote (Quote or affirmation cards); ranking (Tier list or best-to-worst ranking); get_playbook gives each one's slides. Default: picked from the topic. |
| `outputProfile` | "clean-square" \| "clean-portrait" \| "instagram-feed" \| "instagram-feed-3-4" \| "clean-vertical" \| "tiktok" \| "instagram-reels" | no | Slide size, width:height: clean-square 1:1, clean-portrait 4:5, instagram-feed 4:5 (default), instagram-feed-3-4 3:4, clean-vertical 9:16, tiktok 9:16, instagram-reels 9:16. |
| `styleId` | "clean-ugc" \| "clean-social" \| "quiet-editorial" \| "bold-statement" \| "mens-looksmaxxing" \| "comparison-grid" \| "study-notes" \| "aesthetic-soft" \| "accent-pop" | no | Text look: clean-ugc (Effortless lowercase native look); clean-social (Bold sans in normal case with a strong shadow); quiet-editorial (Serif); bold-statement (Big all-caps hook over a dramatic scene); mens-looksmaxxing (Dark portrait); comparison-grid (Before-after or best-worst decks); study-notes (Small clean caption low on a desk/flatlay); aesthetic-soft (Airy scene); accent-pop (Clean sans with a warm accent color). |
| `hook` | string | no | The cover's hook line, or the idea for it, in the brand's voice. up to 160 characters |
| `ctaCardId` | string | no | A CTA card from get_brand to close with. up to 200 characters |
| `photosOnly` | boolean | no | true: no AI image, so only the script costs; a slide no photo fits stays empty. |
| `copyPost` | object | no | Price one copy_post call instead, with the AI images it may make. |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `credits` | number | The most it can cost; pass at least this as maxCredits. |
| `scriptCredits` | number | Credits for the words; for copy_post, the words and photos together. |
| `photoSourcingCredits` | number | Credits for finding photos. |
| `imageCredits` | number | The most AI images can cost; slides that get a photo cost nothing. |
| `slides` | object[] | Per slide; empty for copy_post. |
| `balance` | number | Credits the user has now. |
| `token` | object | The calling key's spend limit; a call above what is left is refused. |
| `note` | string | The cost in words, with any warning to tell the user. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "estimate_cost",
    "arguments": {}
  }
}
```

## Related tools

- [`get_post_events`](/developers/mcp-tools/get_post_events): Get a post's history
- [`search_inspiration`](/developers/mcp-tools/search_inspiration): Search the Inspiration library
- [`get_playbook`](/developers/mcp-tools/get_playbook): Get the slideshow playbook
- [`get_generation_status`](/developers/mcp-tools/get_generation_status): Get a slideshow's progress
- [`get_checkout_link`](/developers/mcp-tools/get_checkout_link): Get a link to buy credits
- [`list_review_links`](/developers/mcp-tools/list_review_links): List client review links
- [All 79 tools](/developers/mcp-tools)
