Context
get_site_profile
Your website, business context, brand voice, blog settings, connected integrations, plan and
remaining credits. Free and instant.
Worth calling first in any conversation: it tells the agent what the rest of the tools can do
in this workspace, so it stops guessing.
Research
list_keywords
Browse the keywords you already track. Filter by status, search, flagged, limit.
Free. Returns a table plus a suggestion — typically which term is the best next article.
research_keywords
Look up live volume, difficulty, CPC and intent for new terms and save them to your workspace.
Costs one keyword-lookup credit. Pass enrich: false to save terms without spending one.
Site health
run_site_audit
Crawls your site and scores it across technical, content, schema, backlinks and analytics.
Costs one audit credit. Takes several minutes, so it returns a job id immediately — the
agent then calls wait_for_job.
get_audit
Reads a finished audit. Returns scores and issue counts grouped by severity and category
rather than every issue, so a large audit does not flood the conversation:
severity or category to drill into the specific issues behind a count. Defaults to
your most recent audit.
Content
list_articles
Browse articles with status, word count and keyword. Metadata only.
get_article
Reads one article. The include parameter controls how much comes back:
Default to
meta. A 2,000-word body is a lot of conversation to spend when the question was
“is it published yet”.
generate_article
Runs the full writing pipeline for a keyword: SERP research, competitor analysis, outline,
draft, humanise, internal links, images and metadata.
Costs one article credit and takes roughly three minutes. Returns a job id immediately.
Pass keywordId to write something new, or articleId to regenerate an existing draft.
Publishing
list_integrations
Your connected CMS and analytics destinations, with status. Call it to get a valid
integrationId.
Pro feature.
publish_article
Publishes an article to a connected CMS.
Pro feature. Writes to your live website. Two safeguards:
dryRun: truereturns the exact article, destination, slug and metadata that would be sent, and publishes nothing.confirm: trueis required to publish for real. Without it the tool refuses and tells the agent to show you what will happen first.
publish scope, which is not granted by default — a key without it
cannot publish no matter what plan you are on.
Jobs
Audits, article generation and publishing all run in the background.check_job
Returns status and the current step immediately:
wait_for_job
Blocks until the job finishes, up to timeoutSeconds (default 60, max 240). If it is still
running when the timeout hits, it returns the latest progress step and tells the agent to call
again. Better than polling check_job in a loop.
Cost at a glance
See Plans, credits and limits for the allowances behind each credit.