estimate_cost

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

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

InputTypeRequiredNotes
formatIdstringnoA saved format from list_formats. Default: your active brand with the settings below. up to 200 characters
brandIdstringnoOnly without formatId: the brand to write for. Default: your active brand. up to 200 characters
groupIdstringnoOnly without formatId: an account group (list_accounts) whose notes shape the script. up to 200 characters
slideCountintegernoOnly without formatId: how many slides. Default 6. 3 to 10
structure"hook-proof-cta" | "listicle" | "before-after" | "educational" | "story" | "quote" | "ranking"noThe 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"noSlide 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"noText 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).
hookstringnoThe cover's hook line, or the idea for it, in the brand's voice. up to 160 characters
ctaCardIdstringnoA CTA card from get_brand to close with. up to 200 characters
photosOnlybooleannotrue: no AI image, so only the script costs; a slide no photo fits stays empty.
copyPostobjectnoPrice 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.

Returns

FieldTypeNotes
creditsnumberThe most it can cost; pass at least this as maxCredits.
scriptCreditsnumberCredits for the words; for copy_post, the words and photos together.
photoSourcingCreditsnumberCredits for finding photos.
imageCreditsnumberThe most AI images can cost; slides that get a photo cost nothing.
slidesobject[]Per slide; empty for copy_post.
balancenumberCredits the user has now.
tokenobjectThe calling key's spend limit; a call above what is left is refused.
notestringThe 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 shows how to make one.

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

Something wrong or missing? Write to support@wavegrain.com.