Content Tools — Rankahead MCP Reference

The content tools give AI agents full control over Rankahead’s content generation pipeline. You can generate blog posts from answer gap suggestions, GSC keyword data, or competitor URLs — then edit, publish, and track their search performance. Additional tools let you manage CMS connections, configure tone and style settings, and define the audience persona that shapes generated content.

list_blog_posts

Lists all blog posts in your account. You can filter by the prompt they were generated from or by their current status.

string

Optional prompt ID to return only posts generated from a specific prompt.

string

Optional status filter. Accepted values: GENERATING, DRAFT, PUBLISHED, FAILED.

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

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_blog_posts",
    "arguments": {
      "status": "PUBLISHED"
    }
  },
  "id": 2
}

get_blog_post

Returns full content and metadata for a single blog post, including the generated body, title, and associated prompt information.

string

required

The ID of the blog post to retrieve.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_blog_post",
    "arguments": {
      "blogPostId": "blg_04ncp5t3p9fa"
    }
  },
  "id": 3
}

string

Unique identifier for the blog post.

string

The post title.

string

The full post body in TipTap JSON format.

string

Current status: GENERATING, DRAFT, PUBLISHED, or FAILED.

get_blog_publish_status

Returns the CMS publish records for a blog post, showing the publish status per connected CMS integration.

string

required

The ID of the blog post to check publish status for.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_blog_publish_status",
    "arguments": {
      "blogPostId": "blg_04ncp5t3p9fa"
    }
  },
  "id": 4
}

object[]

Array of publish records, one per CMS connection, each showing the connection name, status, and published URL if available.

generate_blog_post

Triggers asynchronous generation of a new blog post. You must choose a generation mode, and some modes require additional parameters.

string

required

The domain to generate the post for.

string

required

Generation mode. Accepted values:

FROM_SUGGESTIONS — generates from an answer gap suggestion identified by a prompt run
FROM_GSC_KEYWORD — generates targeting a keyword from your Google Search Console data
FROM_COMPETITOR — generates from a competitor URL for gap or comparison content

string

Required when mode is FROM_SUGGESTIONS. The ID of the prompt whose suggestions to use.

string

Optional specific run ID to pull suggestions from when using FROM_SUGGESTIONS mode.

string

Required when mode is FROM_GSC_KEYWORD. The GSC keyword to target.

string

Required when mode is FROM_COMPETITOR. The competitor page URL to generate content from.

string

Optional custom title. If omitted, a title is generated automatically.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "generate_blog_post",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x",
      "mode": "FROM_SUGGESTIONS",
      "promptId": "prm_02kxw9a1m7d3y"
    }
  },
  "id": 5
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "generate_blog_post",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x",
      "mode": "FROM_GSC_KEYWORD",
      "keyword": "best crm for startups",
      "title": "The Best CRM Software for Startups in 2025"
    }
  },
  "id": 6
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "generate_blog_post",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x",
      "mode": "FROM_COMPETITOR",
      "competitorUrl": "https://rivalcrm.com/blog/crm-for-startups"
    }
  },
  "id": 7
}

string

The ID of the newly created blog post. Poll get_blog_post until status changes from GENERATING to DRAFT or FAILED.

get_blog_gsc_metrics

Returns Google Search Console performance metrics for a published blog post, including clicks, impressions, CTR, and average position.

string

required

The ID of the blog post to retrieve GSC metrics for.

number

default:"28"

Lookback window in days. Defaults to 28.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_blog_gsc_metrics",
    "arguments": {
      "blogPostId": "blg_04ncp5t3p9fa",
      "days": 28
    }
  },
  "id": 8
}

number

Total organic clicks over the selected period.

number

Total search impressions over the selected period.

number

Average click-through rate as a decimal (e.g. 0.042 for 4.2%).

number

Average search ranking position over the selected period.

update_blog_post

Updates the title and/or content of a blog post. Only posts in DRAFT status can be edited.

string

required

The ID of the blog post to update.

string

Updated post title.

string

Updated post body as a JSON string in TipTap format.

Only DRAFT posts can be edited. Attempting to update a PUBLISHED post will return an error.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_blog_post",
    "arguments": {
      "blogPostId": "blg_04ncp5t3p9fa",
      "title": "The Best CRM Software for Early-Stage Startups"
    }
  },
  "id": 9
}

delete_blog_post

Permanently deletes a blog post and all associated CMS publish records. This action cannot be undone.

string

required

The ID of the blog post to delete.

Deletion is permanent and removes all publish records for this post across connected CMS integrations.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "delete_blog_post",
    "arguments": {
      "blogPostId": "blg_04ncp5t3p9fa"
    }
  },
  "id": 10
}

publish_blog_post

Publishes a blog post to a connected CMS. You must supply both the post ID and the CMS connection ID. Use list_cms_connections to retrieve available connection IDs.

string

required

The ID of the blog post to publish.

string

required

The ID of the CMS connection to publish to.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "publish_blog_post",
    "arguments": {
      "blogPostId": "blg_04ncp5t3p9fa",
      "cmsConnectionId": "cms_09qdr6u4q2gw"
    }
  },
  "id": 11
}

list_cms_connections

Lists all connected CMS integrations for your account. Use the returned connection IDs with publish_blog_post. This tool takes no input parameters.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_cms_connections",
    "arguments": {}
  },
  "id": 12
}

object[]

Array of CMS connections, each with an ID, name, and connection type (e.g. WordPress, Webflow).

get_content_settings

Returns the content generation settings for a domain, including tone of voice, target audience, value proposition, blocked words, and internal link configuration.

string

Optional domain ID. Defaults to the first domain in your organisation if omitted.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_content_settings",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x"
    }
  },
  "id": 13
}

update_content_settings

Updates content generation settings for a domain. Only the fields you provide are changed — all fields are optional except domainId.

string

Optional domain ID. Defaults to the first domain in your organisation if omitted.

string

Value proposition describing what makes the brand unique.

string

Description of the target audience for generated content.

string

Writing tone. Accepted values: PROFESSIONAL, CASUAL, AUTHORITATIVE, FRIENDLY, EDUCATIONAL.

string

Language code for content generation (e.g. en, fr, de).

string

JSON array string of words to exclude from generated content (e.g. '["spam","cheap"]').

string

JSON array string of internal URLs to include in generated content (e.g. '["https://example.com/pricing"]').

string

JSON array string of competitor domain URLs to use for content differentiation (e.g. '["competitor.com"]').

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_content_settings",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x",
      "toneOfVoice": "PROFESSIONAL",
      "targetAudience": "Marketing managers at B2B SaaS companies responsible for pipeline generation"
    }
  },
  "id": 14
}

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "update_content_settings",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x",
      "blockedWords": "[\"cheap\",\"free trial\"]",
      "internalLinks": "[\"https://acmecrm.com/pricing\",\"https://acmecrm.com/features\"]"
    }
  },
  "id": 15
}

get_persona

Returns the audience persona configured for a domain. The persona shapes the reading level, terminology, and examples used in generated content.

string

Optional domain ID. Defaults to the first domain in your organisation if omitted.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_persona",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x"
    }
  },
  "id": 15
}

string

The persona’s name (e.g. “Growth-Stage Founder”).

string

A description of the target audience.

number

Minimum age in the target range.

number

Maximum age in the target range.

string

Highest education level: HIGH_SCHOOL, BACHELORS, MASTERS, PHD, or SELF_TAUGHT.

upsert_persona

Creates or updates the audience persona for a domain. If a persona already exists for the domain, it is overwritten.

string

required

The persona’s name (e.g. “Growth-Stage Founder”).

string

required

A description of the target reader, their goals, and their pain points.

string

Optional domain ID. Defaults to the first domain in your organisation if omitted.

number

Minimum age in the target demographic.

number

Maximum age in the target demographic.

string

Highest education level of the target reader. Accepted values: HIGH_SCHOOL, BACHELORS, MASTERS, PHD, SELF_TAUGHT.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "upsert_persona",
    "arguments": {
      "domainId": "dom_01j9z3k8p4c2x",
      "name": "Growth-Stage Founder",
      "description": "Founders at Series A/B companies evaluating tools to scale their go-to-market motion. Technical enough to evaluate integrations but focused on business outcomes.",
      "ageRangeMin": 28,
      "ageRangeMax": 45,
      "educationLevel": "BACHELORS"
    }
  },
  "id": 16
}

​list_blog_posts

​get_blog_post

​get_blog_publish_status

​generate_blog_post

​get_blog_gsc_metrics

​update_blog_post

​delete_blog_post

​publish_blog_post

​list_cms_connections

​get_content_settings

​update_content_settings

​get_persona

​upsert_persona

list_blog_posts

get_blog_post

get_blog_publish_status

generate_blog_post

get_blog_gsc_metrics

update_blog_post

delete_blog_post

publish_blog_post

list_cms_connections

get_content_settings

update_content_settings

get_persona

upsert_persona