Content Studio tools
Create briefs, finalize outlines, and generate articles from an LLM agent
The 9 Content Studio tools run the dashboard's brief → article flow: discover briefs, kick off research, lock the outline, generate the article, read the result.
create_brief (consumes credits) and trigger_content_generation (consumes credits) both deduct from your balance. Confirm both with the user before the agent calls them.
Served by the single GetMint MCP server at https://mcp.getmint.ai/mcp. New here? See Connect your client and Authentication. For the full tool matrix, see Capabilities.
The state machine
Content flows through a fixed sequence. Two steps run on workers — poll at ≥5s intervals. You must finalize_document before generation starts.
Briefs
list_briefs read-only — Paginated briefs for a domain; start here to discover briefIds. Returns { briefs, total, page, pageSize, hasMore }.
Inputs: domainId (required); page, pageSize (optional); status (optional — queued, running, completed, failed, or cancelled).
get_brief read-only — One brief's full details, including pipeline outputs (research, strategy, title suggestions).
Inputs: domainId, briefId (required).
create_brief consumes credits — Create a brief and start the research + strategy pipeline (SERP analysis, persona synthesis, outline, title suggestions). Deducts BRIEF_GENERATION. Returns a briefId to poll.
Inputs: domainId, keyword (required); market, language, targetArticleTitle, autopilotMode (optional).
autopilotMode: true auto-selects the first title, initializes the document, and triggers generation on completion — spending generation credits on top of the brief. Leave it off (default) for human review.
get_brief_progress read-only — Poll pipeline progress. Returns { briefId, status, currentStep, totalSteps, currentStepName?, progress, errorMessage? }.
Inputs: domainId, briefId (required).
Document
get_document read-only — The structured outline: metadata, keywords, strategy, and sections with topics/instructions.
Inputs: domainId, briefId (required).
finalize_document write — Mark the outline ready. Required before generation — trigger_content_generation rejects an unfinalized brief.
Inputs: domainId, briefId (required).
Generation & article
trigger_content_generation consumes credits — Enqueue generation for a finalized brief. Deducts CONTENT_GENERATION, scaled by word count. Returns 202 202 + poll — poll with get_generation_status. If metadata.brandKitId is set, generation applies the kit's tone, pronoun, style flags, author persona, and blocklist (blocked words and competitor names rewritten out during polish).
Inputs: domainId, briefId (required); wordCountOverride (optional — credit cost scales with it).
get_generation_status read-only — Poll generation progress: current phase, progress %, errors.
Inputs: domainId, briefId (required).
get_article read-only — Fetch the generated article: markdown, per-section breakdown, metadata, review notes. Internal authoring markers are stripped.
Inputs: domainId, briefId (required).
get_article returns needs_review when the article fails a compliance check; still readable, but a human should resolve the flagged gaps before publishing.
Example Agent Session
User: Create a content brief for "sustainable packaging for e-commerce" in domain
69b0495c672f51c1d55da2d1, then generate the article once it's ready.
Agent:
create_brief→ gotbriefId.get_brief_progress→ step 4/14 → completed.get_document→ outline looks good.finalize_document, thentrigger_content_generation.get_generation_status→ done. Article fromget_article: …