MCP tools reference - rocketblue

rocketblue MCP exposes 35 tools. Parameters use camelCase. Every tool has a title and a read-only or destructive annotation, so MCP clients such as Claude can ask before changing data. Any tool that reads a run accepts runId. You can also pass only brandId to use the brand’s latest run.

Context

Tool	What it does	Type
`get_organization_context`	Plan, remaining credits, and every brand with its ID. Call this first.	Read
`get_brand_context`	Targeting, prompt quota, schedule, and next data collection. Add sections with `include` (see below).	Read
`get_usage_guide`	Markdown guidance on prompt writing, quotas, credits, and outreach statuses.	Read

`get_brand_context` sections

Pass any of these in include to get them in the same call:

Section	Returns
`settings`	Name, display name, website, description, city, region, competitors, consolidation toggle
`contentSettings`	Brand information, tone of voice, competitor information, content creation settings
`topics`	Topics with nested prompts (text, journey stage, volume, tags)
`perceptionPrompts`	Perception prompts with property and scoring logic
`mentionedBrands`	Brand names found in answers and how each one is displayed
`trackedUrls`	Content tracker pages and domains
`hiddenOutreach`	Hidden outreach domains and URLs
`timeline`	Activity timeline events
`contentJobs`	Recent AI content jobs and their status

Results

Tool	What it does	Type
`list_runs`	A brand’s analysis runs, newest first.	Read
`get_run_results`	Per-prompt, per-model results. `includeAnswer` adds full answers.	Read
`get_run_stats`	Visibility metrics, per-topic breakdown, and top mentioned brands.	Read
`get_run_sources`	Cited domains and URLs. `type`: `analysis` (default) or `perception`.	Read
`get_web_search_queries`	Web searches the models ran per prompt. Filter by `promptId` and `llmNames`.	Read
`get_perception_results`	Perception prompts with each model’s response and score.	Read
`get_content_suggestions`	Saved content ideas for prompts where the brand was missing.	Read
`get_outreach_cited_urls`	The “Most cited websites” outreach list with status and notes.	Read
`get_outreach_contacts`	People to contact at a cited domain. Optional email lookup and domain rank.	Read
`get_created_content`	List drafts, or pass `contentId` for one full draft.	Read

Topics and prompts

Tool	What it does	Type
`create_topics_and_prompts`	Create topics and prompts in one call. Prompts can include `tags` and `volume`. New prompts are queued right away.	Write
`update_prompts`	Change text, journey stage, tags, or topic on many prompts at once.	Update
`rename_topics`	Rename one or more topics.	Update
`generate_prompts`	`ai`: free, saves about 8 prompts to a topic. `volume_research`: 50 credits, returns suggestions with search volume.	Write
`estimate_prompt_volumes`	Estimate and save search volume for up to 20 prompts. 10 credits per prompt.	Update

Perception

Tool	What it does	Type
`add_perception_prompts`	Add branded perception prompts with optional scoring logic.	Write
`update_perception_prompts`	Change property or scoring logic on existing perception prompts.	Update
`correct_results`	Fix the brand’s sentiment on a result, or override a perception score.	Update

Brand settings

Tool	What it does	Type
`update_brand_settings`	Profile, location, competitors, consolidation toggle, and content settings in one call.	Update
`update_mentioned_brands`	Merge brand-name variants under one display name, or reset all.	Update

Outreach

Tool	What it does	Type
`update_outreach`	Set URL status and notes, hide URLs or domains, mark brand mentions, mark “not an opportunity”, and classify domains.	Update

Content

Tool	What it does	Type
`generate_content_suggestions`	Create content ideas for a run. 10 credits.	Write
`create_content_draft`	Write a researched article from a prompt or a brief. 30 credits. Runs in the background.	Write
`revise_content_draft`	Rewrite a draft from feedback. 10 credits.	Update
`generate_content_assets`	Featured image (25 credits, first one per draft free), remove image, or excerpt and schema (free).	Update
`update_created_content`	Edit draft fields, including the live URL.	Update
`publish_content`	Send a draft to connected WordPress or Shopify as a draft or live post.	Write

Tracking, audits, and reports

Tool	What it does	Type
`add_tracked_urls`	Track pages or whole domains in the content tracker.	Write
`analyze_website`	`page`: AI-readiness grade for one page. `site_audit`: technical site audit. Free.	Write
`save_timeline_events`	Add or edit timeline events.	Update
`generate_visibility_report`	Shareable HTML visibility report. Agency plan only.	Write

Delete

Tool	What it does	Type
`delete_items`	Delete topics, prompts, perception prompts, drafts, tracked URLs, or timeline events in one call. Deleting a topic deletes its prompts.	Destructive

Credits

Credit tools check the balance first and stop with a clear message when credits run out. get_organization_context returns creditsRemaining.

Tool	Cost
`create_content_draft`	30
`revise_content_draft`	10
`generate_content_assets` (featured image)	25, first image per draft free
`generate_content_suggestions`	10
`generate_prompts` (`volume_research`)	50, only when results come back
`estimate_prompt_volumes`	10 per prompt estimated

Long-running tools

create_content_draft returns right away and finishes in 2 to 5 minutes.

With only promptId, it returns a jobId. Check get_brand_context with include: ["contentJobs"] until the job is completed.
With a brief, look for the new draft with get_created_content.

If revise_content_draft takes longer than about 2 minutes, it returns status: "processing" and keeps working.

Older tool names

Tool names from version 1 still work for existing scripts, but they no longer appear in tools/list. For example, list_brands, get_brand_last_results, delete_prompts, move_prompts_to_topic, and update_outreach_cited_urls map to the new tools above.

Discovering tools programmatically

MCP clients call tools/list to get the live catalog with JSON Schema inputs and annotations. A GET request to the MCP endpoint returns server metadata:

curl -s "https://app.rocketblue.ai/api/mcp"

{
  "name": "rocketblue",
  "protocol": "mcp",
  "transport": "streamable-http",
  "endpoint": "/functions/v1/org-api-mcp"
}

​Context

​get_brand_context sections

​Results

​Topics and prompts

​Perception

​Brand settings

​Outreach

​Content

​Tracking, audits, and reports

​Delete

​Credits

​Long-running tools

​Older tool names

​Discovering tools programmatically