MCP tool catalogue

All 39 wire tool names, arguments, scopes, and REST equivalents.

Arguments are validated strictly (unknown arguments are rejected). limit and cursor follow the REST rules for the equivalent endpoint.

Discovery and reads

Tool	Scope	Arguments	REST equivalent
`rankad_list_brands`	`brands:read`	`limit?`, `cursor?`	`GET /brands`
`rankad_get_brand`	`brands:read`	`brand_id`	`GET /brands/{id}`
`rankad_get_brand_capabilities`	`brands:read` (or any read scope)	`brand_id`	`GET /brands/{id}/capabilities`
`rankad_list_integrations`	`integrations:read`	`brand_id`, `limit?`, `cursor?`	`GET …/integrations`
`rankad_list_prompt_library`	`prompts:read`	`brand_id`, `category_id?`, `intent?`, `min_opportunity_score?`, `status?`, `sort?`, `limit?`, `cursor?`	`GET …/prompt-library`
`rankad_get_prompt`	`prompts:read`	`brand_id`, `prompt_id`	`GET …/prompt-library/{id}`
`rankad_list_scan_runs`	`visibility:read`	`brand_id`, `status?`, `from?`, `to?`, `limit?`, `cursor?`	`GET …/scan-runs`
`rankad_get_scan_run`	`visibility:read`	`brand_id`, `scan_run_id`	`GET …/scan-runs/{id}`
`rankad_get_visibility`	`visibility:read`	`brand_id`, `period?`, `model?`, `limit?`, `cursor?`	`GET …/visibility`
`rankad_list_recommendations`	`recommendations:read`	`brand_id`, `type?`, `status?`, `priority?`, `limit?`, `cursor?`	`GET …/recommendations`
`rankad_get_recommendation`	`recommendations:read`	`brand_id`, `recommendation_id`	`GET …/recommendations/{id}`
`rankad_list_content`	`content:read`	`brand_id`, `status?`, `content_type?`, `source_recommendation_id?`, `limit?`, `cursor?`	`GET …/content`
`rankad_get_content`	`content:read`	`brand_id`, `content_id`, `include_body?` (boolean)	`GET …/content/{id}?include=body`
`rankad_get_job`	`jobs:read`	`job_id`	`GET /jobs/{id}`
`rankad_get_usage`	`usage:read` (or `keys:manage`)	—	`GET /usage`

Generation and publishing (create API jobs)

Tool	Scope	Arguments	Notes
`rankad_generate_content`	`content:generate`	`brand_id`, `idempotency_key`, `content_type`, `source {recommendation_id? \| prompt_id?}`, `instructions?`, `options?`	Creates work; credits per content type
`rankad_preview_publication`	`publishing:preview`	`brand_id`, `content_id`, `integration_id`, `options?`, `idempotency_key?`	Never publishes; 1 credit
`rankad_publish_content`	`publishing:write`	`brand_id`, `idempotency_key`, `content_id`, `integration_id`, `preview_id`, `destination_status`, `confirm: true`, `tracking?`	External side effect; 3 credits
`rankad_cancel_job`	`jobs:read`	`job_id`	Best effort; queued only

There is no MCP tool for GET …/publishing/operations/{id}. Poll rankad_get_job (its result.operation_id links to the operation), or use REST.

Current product — reads

Read tools take brand_id, any path ID, and the query fields as top-level arguments.

Tool	Scope	Arguments
`rankad_get_calendar`	`calendar:read`	`brand_id`, `from`, `to`, `limit?`, `cursor?`
`rankad_get_results`	`results:read`	`brand_id`, `period_days?`, `limit?`, `cursor?`
`rankad_get_website`	`website:read`	`brand_id`, `since?`
`rankad_list_website_resources`	`website:read`	`brand_id`, `kinds?`, `status?`, `search?`, `page_type?`, `locale?`, `source?`, `limit?`, `cursor?`
`rankad_list_website_changes`	`website:read`	`brand_id`, `limit?`, `cursor?`
`rankad_get_website_change`	`website:read`	`brand_id`, `change_set_id`, `limit?`, `cursor?`
`rankad_list_website_activity`	`website:read`	`brand_id`, `limit?`, `cursor?`
`rankad_get_local`	`local:read`	`brand_id`, `run_id?`, `limit?`, `cursor?`
`rankad_get_image_bank`	`images:read`	`brand_id`, `content_id?`, `limit?`, `cursor?`

Current product — writes

Write tools take brand_id, any path ID, and the REST body nested under request:

{ "brand_id": "<uuid>", "topic_id": "<uuid>",
  "request": { "title": "Updated topic", "planned_date": "2026-10-28", "expected_title": "Previous title" } }

{ "brand_id": "<uuid>", "topic_id": "<uuid>",
  "request": { "title": "Updated topic", "planned_date": "2026-10-28", "expected_title": "Previous title" } }

{ "brand_id": "<uuid>", "topic_id": "<uuid>",
  "request": { "title": "Updated topic", "planned_date": "2026-10-28", "expected_title": "Previous title" } }

{ "brand_id": "<uuid>", "topic_id": "<uuid>",
  "request": { "title": "Updated topic", "planned_date": "2026-10-28", "expected_title": "Previous title" } }

Tool	Scope	Path args	`request`	Kind
`rankad_update_calendar_topic`	`calendar:write`	`topic_id`	topic patch	write
`rankad_reschedule_publication`	`calendar:write` + `publishing:write`	`publication_id`	`{scheduled_at, user_timezone, confirm:true}`	external, 1 credit
`rankad_cancel_publication`	`calendar:write`	`publication_id`	`{confirm:true}`	write
`rankad_update_content_draft`	`content:write`	`content_id`	draft patch	write
`rankad_select_content_cover`	`content:write`	`content_id`	`{asset_id, expected_updated_at}`	write
`rankad_refresh_results`	`results:refresh`	—	`{confirm:true}`	external, 1 credit
`rankad_website_action`	`website:write`	—	website action union	external, variable credits
`rankad_run_local`	`local:write`	—	`{confirm:true}`	external, 5 credits
`rankad_set_local_recommendation_status`	`local:write`	`recommendation_id`	`{status}`	write
`rankad_create_local_location`	`local:write`	—	location body	write
`rankad_update_local_location`	`local:write`	`location_id`	location body	write

Call tools/list on your assigned MCP endpoint to retrieve the exact input schemas for tools available to your key.

API & MCP overview

Get help