RanklyBee

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

SEO research, AI visibility, content, leads, and backlink workflows. Sign in with RanklyBee OAuth.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "RanklyBee": {
      "url": "https://api.ranklybee.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (194)

• list_projects read-only

  List the signed-in user's Projects with their role and websites. Start here to get a projectId.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_backlink_submission_projects read-only

  List the signed-in user's Projects and their active Site details so the user can choose a target without knowing an internal Project ID.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_backlink_submission_profile read-only

  Read the current active Site's backlink submission profile and readiness state.

  Parameters:

  • projectId (required) — string
  • siteId — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_backlink_submission_sources read-only

  List visible, available backlink sources that have a supported submission destination.

  Parameters:

  • projectId (required) — string
  • page — integer
  • limit — integer
  • search — string
  • sourceType — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• preflight_backlink_submission

  Check paid access, profile confirmation, source policy, inventory, duplicate backlinks, and daily capacity before creating a submission job.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • sourceId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• create_backlink_submission

  After user review and approval, create one idempotent submission job in waiting_human state. This does not click the third-party site's final submit button.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • sourceId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• get_backlink_submission read-only

  Read the current state and recorded outcome of a backlink submission job.

  Parameters:

  • projectId (required) — string
  • jobId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• record_backlink_submission_outcome

  Record the result after a user-approved browser interaction. Use needs_verification for CAPTCHA, MFA, email verification, rate limits, or ambiguous results.

  Parameters:

  • projectId (required) — string
  • jobId (required) — string
  • status (required) — string
  • message
  • externalUrl
  • externalReference

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• list_leads read-only

  List scored leads for a Project, newest first. Filter by tier (hot, warm, explore), stage, platform, or text. Each lead has the evidence quote that shows the buying intent and a link to the original post.

  Parameters:

  • projectId (required) — string
  • page — integer
  • limit — integer
  • siteId — string
  • filters — object

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_lead read-only

  Read one lead with its score, evidence quote, reason, stage, and link.

  Parameters:

  • projectId (required) — string
  • leadId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_lead_keywords read-only

  List the monitoring keywords (search phrases and platforms) for a Project.

  Parameters:

  • projectId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• move_lead_stage

  Move a lead to to_qualify, to_contact, in_conversation, or closed. This fires any stage-changed automations the user configured.

  Parameters:

  • projectId (required) — string
  • leadId (required) — string
  • stage (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_sites read-only

  List the websites in a Project. Most tools need a siteId from this list.

  Parameters:

  • projectId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_site_profile read-only

  Read what Ranklybee knows about a website: positioning, audience, products, competitors, and the latest analysis job.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_site_profile

  Replace the editable site profile. Read it with get_site_profile first and send every field back, changing only what the user asked for.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • profile (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• analyze_site

  Crawl the website again and rebuild its profile. Runs in the background; poll get_site_profile for the result.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • idempotencyKey (required) — string
  • reviewFoundation — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• get_plan_usage read-only

  Read how much of each plan allowance the Project has used in the current period.

  Parameters:

  • projectId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_content_plan read-only

  Read the latest content plan for a website with its scheduled article briefs. Returns null when no plan exists.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• generate_content_plan

  Generate a new content plan from the site profile and keyword research. Uses the plan's content allowance.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• activate_content_plan

  Start a reviewed content plan so its briefs are written on their scheduled dates.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • planId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• decide_content_plan

  Approve or reject a whole content plan.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • planId (required) — string
  • decision (required) — string
  • reason — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• decide_content_brief

  Approve or reject one article brief in a content plan.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • planId (required) — string
  • briefId (required) — string
  • decision (required) — string
  • reason — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• reschedule_content_brief

  Move an article brief to another date (YYYY-MM-DD) on the content calendar.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • planId (required) — string
  • briefId (required) — string
  • scheduledDate (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_content_brief_instructions

  Set the notes the writer follows for one article brief. Send an empty string to clear them.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • planId (required) — string
  • briefId (required) — string
  • instructions (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_content_brief_keyword

  Change the target keyword of one article brief.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • planId (required) — string
  • briefId (required) — string
  • phrase (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• search_article_keywords

  Look up keyword ideas for a seed phrase with volume, difficulty, and whether each is already in the plan. The ideas are saved to the website's keyword list.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • query (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• list_article_keywords read-only

  List the keywords saved for a website's articles.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_article_keywords

  Add keywords to the content plan as article briefs, optionally on a given date. Returns the keywords that were skipped and why.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • phrases (required) — array
  • scheduledDate — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• import_article_keywords

  Save keywords to the website's keyword list without scheduling articles for them.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • phrases (required) — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• remove_article_keywords destructive

  Remove keywords from the website's saved keyword list.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • phrases (required) — array

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• list_articles read-only

  List a website's articles, newest first, with their state and publication. Each item is large, so pass a small limit such as 10 and page with offset.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • limit — integer
  • offset — integer
  • search — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_article read-only

  Read one article with its full content, quality checks, and publication state.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• generate_article

  Write the article for an approved brief. Uses the plan's article allowance and takes a few minutes; poll get_article.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • briefId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_article

  Replace an article's editable content. Read it with get_article first and send every content field back.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string
  • content (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• regenerate_article_fields

  Rewrite the chosen fields of an article with AI.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string
  • fields (required) — array
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• submit_article_for_review

  Send a draft article to the approval step.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• decide_article

  Approve or reject an article that is waiting for approval.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string
  • decision (required) — string
  • reason — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_cms_connections read-only

  List the CMS connections an article can be published to.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• publish_article

  Publish an approved article to a connected CMS. The article goes live on the user's website, so confirm with the user first.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string
  • connectionId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• verify_article_publication

  Record the live URL of an article the user published by hand, after checking the page.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string
  • url (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• delete_article destructive

  Delete an article from Ranklybee. This does not remove a page already published on the website.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • assetId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• get_article_improvements read-only

  Read the refresh opportunities found for published articles and the state of each improvement.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• detect_article_improvements

  Scan published articles against search data for new refresh opportunities.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• generate_article_improvement

  Write the improved version of an article for one opportunity.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • improvementId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_article_improvement

  Replace the drafted content of an improvement. Send every content field back.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • improvementId (required) — string
  • content (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• submit_article_improvement

  Send a drafted improvement to the approval step.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • improvementId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• decide_article_improvement

  Approve or reject an improvement that is waiting for approval.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • improvementId (required) — string
  • decision (required) — string
  • reason — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• apply_article_improvement

  Apply an approved improvement to its article. Confirm with the user first.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • improvementId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• compare_article_improvement

  Compare search performance before and after an applied improvement and record the result.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • improvementId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• dismiss_article_improvement

  Dismiss an improvement opportunity with a reason.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • improvementId (required) — string
  • reason (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_content_automation read-only

  Read the automatic writing and publishing schedule for a website.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_content_automation

  Replace the automatic writing and publishing schedule. Read it with get_content_automation first; auto_publish_approved publishes without a human review.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • enabled (required) — boolean
  • timezone (required) — string
  • generationLeadHours (required) — integer
  • publishingDays (required) — array
  • publishTime (required) — string
  • mode (required) — string
  • defaultCmsConnectionId (required)

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_article_settings read-only

  Read the writing preferences for a website: voice, structure, images, linking, and improvement rules.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_internal_link_targets read-only

  List the pages articles are allowed to link to.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_internal_link_target

  Add a page of the website that articles should link to.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • url (required) — string
  • title (required)

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• remove_internal_link_target

  Stop articles from linking to a page.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • url (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_products read-only

  List the products articles can feature.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • query — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_product

  Add a product to the catalog. Pass imageStorageKey as null.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • fields (required) — object
  • imageStorageKey (required)

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_product

  Replace a product's fields. Send every field back.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • productId (required) — string
  • fields (required) — object
  • imageStorageKey

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_product_status

  Set whether articles may feature a product.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • productId (required) — string
  • status (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_product destructive

  Delete a product from the catalog.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • productId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• get_backlinks_overview read-only

  Read totals for tracked backlinks, their health, and open replacement tasks.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_backlinks read-only

  List the backlinks Ranklybee tracks for a website, with status and latest check.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • page — integer
  • search — string
  • sortBy — string
  • perPage — integer
  • dofollow — string
  • statuses — array
  • sortOrder — string
  • categories — array
  • pricingModes — array
  • maximumTraffic — integer
  • minimumTraffic — integer
  • maximumDomainRating — integer
  • minimumDomainRating — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_backlink

  Start tracking a backlink: the page that links (sourceUrl) and the page it links to (targetUrl).

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • source (required) — string
  • sourceUrl (required) — string
  • targetUrl (required) — string
  • category — string
  • threadId — string
  • prospectId
  • expectedRel — array
  • pricingMode — string
  • priceCurrency — string
  • pricingSource — string
  • contentAssetId — string
  • expectedAnchor — string
  • priceAmountMinor — integer

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• check_backlink

  Fetch the linking page and record whether the backlink is still live.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • backlinkId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• check_site_backlinks

  Queue a live check for every tracked backlink of a website.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • idempotencyPrefix (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• update_backlink_task

  Change the status or notes of a task opened for a lost backlink.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • taskId (required) — string
  • status (required) — string
  • assigneeUserId — string
  • resolutionNotes — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• close_backlink

  Close a tracked backlink with a reason.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • backlinkId (required) — string
  • reason (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_backlink_inventory_status read-only

  Read whether the website's existing backlinks have been imported.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• start_backlink_inventory

  Import the website's existing backlinks so duplicates are detected.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_featured_backlinks read-only

  Search Ranklybee's library of directories and other backlink sources, with quality, pricing, and link type.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • page — integer
  • view — string
  • search — string
  • sortBy — string
  • perPage — integer
  • linkTypes — array
  • sortOrder — string
  • sourceType — string
  • pricingModels — array
  • accountRequirements — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_prospecting_summary read-only

  Read prospect counts by status for a website.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_prospects read-only

  List link prospects with scores, status, and contact. Filter by status, keyword, or Domain Rating.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • page — integer
  • search — string
  • sortBy — string
  • contact — string
  • keyword — string
  • perPage — integer
  • pageType — string
  • statuses — array
  • sortOrder — string
  • sourceMode — string
  • sourceJobId — string
  • maxDomainRating — integer
  • minDomainRating — integer
  • competitorDomain — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_prospect_discovery_settings read-only

  Read the Domain Rating range and page types used to find prospects.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_prospect_discovery_settings

  Replace the settings used to find prospects. Send every field.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • minDomainRating (required) — integer
  • maxDomainRating (required) — integer
  • pageTypes (required) — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_outreach_keywords read-only

  List the keywords used to search for link prospects.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_outreach_keywords

  Add keywords to search for link prospects.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • phrases (required) — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• remove_outreach_keyword

  Remove one prospecting keyword.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • keywordId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_linkable_assets read-only

  List the pages the user pitches in outreach.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• save_linkable_asset

  Add or update a page worth pitching, with what makes it link-worthy.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • url (required) — string
  • title (required) — string
  • type (required) — string
  • summary (required) — string
  • uniqueValue (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• add_prospect

  Add a page as a link prospect and score it.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • url (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• start_prospect_discovery

  Search the web for link prospects. Runs in the background; poll get_prospect_discovery with the returned job. Uses the plan's prospecting allowance.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • goal — string
  • refresh — boolean
  • selectedKeywords — array
  • confirmedKeywords — array

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• start_competitor_backlink_discovery

  Find prospects among the sites that link to the given competitor domains. Runs in the background.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • competitorDomains (required) — array
  • goal — string
  • refresh — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• get_prospect_discovery read-only

  Read the progress and result counts of a discovery job.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • jobId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• reject_prospect

  Reject one prospect, or block its whole domain from future discovery (a reason is required to block).

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • prospectId (required) — string
  • decision (required)

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• unblock_prospect_domain

  Allow a previously blocked domain to appear in discovery again.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • prospectId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_contacts read-only

  List the people found for outreach, with email verification status.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • page — integer
  • search — string
  • sortBy — string
  • perPage — integer
  • statuses — array
  • sortOrder — string
  • verificationStatuses — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_contact

  Add a contact by hand.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • prospectId (required) — string
  • email (required) — string
  • fullName (required) — string
  • role (required) — string
  • roleCategory (required) — string
  • source — string
  • company — string
  • sourceUrl — string
  • sourceProvider — string
  • sourceReference — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• verify_contact

  Check whether a contact's email address is deliverable.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • contactId (required) — string
  • status (required) — string
  • source (required) — string
  • provider (required) — string
  • costMicros (required) — integer
  • idempotencyKey (required) — string
  • notes — string
  • providerReference — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• find_prospect_contact

  Look up who to email at a prospect's site. Uses the plan's contact allowance.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • prospectId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• select_prospect_contact

  Set which email address outreach to a prospect goes to.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • prospectId (required) — string
  • email (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• suppress_contact

  Add a contact to the do-not-email list with a reason.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • contactId (required) — string
  • scope (required) — string
  • reason (required) — string
  • source — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_outreach_templates read-only

  List the email templates available for outreach.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_outreach_template

  Create an email template.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • name (required) — string
  • subjectTemplate (required) — string
  • bodyTemplate (required) — string
  • fallbackValues — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_outreach_template

  Replace an email template's content.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • templateId (required) — string
  • name (required) — string
  • subjectTemplate (required) — string
  • bodyTemplate (required) — string
  • fallbackValues — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_outreach_template destructive

  Delete an email template.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • templateId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• get_outreach_draft_options read-only

  List the sender identities and templates a new draft can use.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_outreach_threads read-only

  List outreach threads in one bucket (ready, queued, sent, or replied) with their draft and latest message.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • bucket — string
  • search — string
  • starredOnly — boolean

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_outreach_draft

  Write a first email to a prospect's contact from a template and sender. Nothing is sent.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • prospectId (required) — string
  • contactId (required) — string
  • senderIdentityId (required) — string
  • templateId (required) — string
  • generationMode — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• prepare_outreach_draft

  Write a first email to a prospect's contact, letting Ranklybee pick the sender and template. Nothing is sent.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • prospectId (required) — string
  • contactId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_outreach_draft

  Replace the subject and body of an unsent draft.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadId (required) — string
  • subject (required) — string
  • body (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• regenerate_outreach_draft

  Rewrite an unsent draft following an instruction.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadId (required) — string
  • instruction (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• mark_outreach_won

  Record that the outreach earned a link and start tracking that backlink.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadId (required) — string
  • sourceUrl (required) — string
  • targetUrl (required) — string
  • expectedAnchor — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• mark_outreach_lost

  Close an outreach thread that did not earn a link.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadId (required) — string
  • reason — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• reopen_outreach_thread

  Reopen a thread that was marked won or lost.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_outreach_sending_dashboard read-only

  Read scheduled and sent emails, sender limits, and replies waiting for review.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_outreach_send_policy

  Set the sending window, weekdays, and daily limit for one sender identity.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • senderIdentityId (required) — string
  • status (required) — string
  • windowStartMinute (required) — integer
  • windowEndMinute (required) — integer
  • allowedWeekdays (required) — array
  • dailyLimit (required) — integer

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• schedule_outreach

  Schedule a drafted thread with up to two follow-ups. mode=live emails a real person from the user's mailbox; show the user the exact email and get approval first. mode=simulation sends nothing.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadId (required) — string
  • mode (required) — string
  • idempotencyKey (required) — string
  • sendNow — boolean
  • followUps — array

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• schedule_outreach_batch

  Schedule several drafted threads at once. mode=live emails real people; get the user's approval of every email first.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadIds (required) — array
  • mode (required) — string
  • idempotencyKey (required) — string
  • followUps — array

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• send_outreach_follow_up

  Send a message in an existing outreach thread from the user's mailbox. Get the user's approval of the exact text first.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • threadId (required) — string
  • body (required) — string
  • idempotencyKey (required) — string
  • ccEmails — array

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• review_outreach_reply

  Act on a reply Ranklybee drafted for an inbound email. action=send emails a real person; get the user's approval first.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • suggestionId (required) — string
  • action (required) — string
  • body (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• stop_outreach_sequence

  Cancel the remaining emails of a scheduled sequence.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • sequenceId (required) — string
  • reason (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_outreach_automation_overview read-only

  Read what the outreach agent did over the last 7, 30, or 90 days.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_outreach_automation_policy read-only

  Read whether the outreach agent is running and its limits.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_outreach_automation_runs read-only

  List recent runs of the outreach agent.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_outreach_automation_exceptions read-only

  List the cases the outreach agent stopped on and left for a human.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • statuses — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• set_outreach_automation_status

  Pause or resume the outreach agent. While active it finds prospects and sends emails on its own.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • status (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• update_outreach_automation_exception

  Change the status or notes of an exception.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • exceptionId (required) — string
  • status (required) — string
  • assigneeUserId
  • resolutionNotes

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_leads_overview read-only

  Read lead counts by tier and stage, the monitor state, keywords, and customer profiles.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_brand_mentions_overview read-only

  Read how often and where the brand is mentioned.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_mentions read-only

  List collected posts that matched a keyword, including brand mentions that are not leads.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • page — integer
  • sort — string
  • dateTo — string
  • orders — array
  • search — string
  • purpose — string
  • sources — array
  • dateFrom — string
  • pageSize — integer
  • platform — string
  • scoreMax — integer
  • scoreMin — integer
  • favorites — boolean
  • keywordId — string
  • sentiment — string
  • upvotesMax — integer
  • upvotesMin — integer
  • commentsMax — integer
  • commentsMin — integer
  • needsResponse — boolean

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• run_lead_scan

  Search the monitored platforms now and score what is found. Uses the plan's lead scan allowance.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• set_lead_feedback

  Tell Ranklybee whether a lead was a good match so scoring improves.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • mentionId (required) — string
  • feedback (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_lead_favorite

  Add or remove a lead from the user's favorites.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • mentionId (required) — string
  • favorite (required) — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• dismiss_lead

  Hide a lead that is not relevant.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • mentionId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• restore_lead

  Bring back a dismissed lead.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • mentionId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• generate_lead_reply

  Draft a reply to a lead's post in the chosen tone. Nothing is posted; the user posts it themselves.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • mentionId (required) — string
  • idempotencyKey (required) — string
  • tone — string
  • regenerate — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_lead_reply

  Edit a drafted reply, or record that the user posted or dismissed it.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • mentionId (required) — string
  • action (required) — string
  • body — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• create_lead_keyword

  Add a keyword to monitor, with its search phrases and platforms.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • keyword (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_lead_keyword

  Replace a monitoring keyword's phrases and platforms.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • keywordId (required) — string
  • keyword (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_lead_keyword_status

  Pause or resume monitoring for one keyword.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • keywordId (required) — string
  • status (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_lead_keyword destructive

  Delete a monitoring keyword.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • keywordId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• create_lead_icp

  Add a customer profile that leads are scored against.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • icp (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_lead_icp

  Replace a customer profile.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • icpId (required) — string
  • icp (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_lead_icp destructive

  Delete a customer profile.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • icpId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• update_lead_sources

  Set which platforms are searched for leads.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • platforms (required) — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_lead_monitor

  Set how often leads are scanned and whether the monitor is active.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • frequency (required) — string
  • status (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_lead_alert_rules read-only

  List the rules that notify the user about new leads.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_lead_alert_rule

  Create a rule that notifies a channel when matching leads arrive.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • rule (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_lead_alert_rule_status

  Pause or resume one alert rule.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • ruleId (required) — string
  • status (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_lead_alert_rule destructive

  Delete an alert rule.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • ruleId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• get_ai_visibility_overview read-only

  Read how often AI assistants mention the brand: visibility, share of voice, position, and trend.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string
  • engines — array
  • categories — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_ai_visibility_prompts read-only

  List the tracked prompts with visibility, position, and the brands each answer names.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string
  • engine — string
  • engines — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_ai_visibility_prompt_runs read-only

  List the recorded answers for one prompt across AI engines.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitorId (required) — string
  • to — string
  • from — string
  • engine — string
  • engines — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_visibility_competitors read-only

  Read the ranking of brands in AI answers, share of voice, and head-to-head prompts.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string
  • engine — string
  • compare — array
  • engines — array
  • category — string
  • sovScope — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_visibility_competitor read-only

  Read one brand's visibility against the user's, with the prompts and sources behind it. brandKey comes from get_ai_visibility_competitors.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • brandKey (required) — string
  • to — string
  • from — string
  • engine — string
  • engines — array
  • category — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_visibility_citations read-only

  Read which domains and pages AI answers cite, and the domains that never mention the brand.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string
  • engine — string
  • engines — array
  • category — string
  • monitorId — string
  • categories — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_visibility_domain_pages read-only

  List the pages of one domain that AI answers cite.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • domain (required) — string
  • to — string
  • from — string
  • engine — string
  • engines — array
  • category — string
  • monitorId — string
  • categories — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_sentiment_overview read-only

  Read how positively AI answers describe the brand and the themes driving it.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string
  • engine — string
  • engines — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_sentiment_driver read-only

  Read one sentiment theme with quotes and suggested tasks; the summary and tasks are written on first read. themeKey comes from get_ai_sentiment_overview.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • themeKey (required) — string
  • to — string
  • from — string
  • engine — string
  • engines — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_sentiment_benchmark read-only

  Compare how favorably AI answers describe the brand and its rivals.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string
  • rival — string
  • engine — string
  • engines — array

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_ai_response read-only

  Read the full text of one recorded AI answer.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • runId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• suggest_ai_visibility_prompts

  Ask AI for prompts worth tracking for the website. Nothing is tracked until you create them.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • description — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• create_ai_visibility_prompt

  Add a prompt to track across AI engines. Counts against the plan's prompt limit.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitor (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• bulk_create_ai_visibility_prompts

  Add up to 100 prompts at once. Counts against the plan's prompt limit.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitors (required) — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_ai_visibility_prompt

  Replace a tracked prompt's settings.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitorId (required) — string
  • monitor (required) — object

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_ai_visibility_prompt_status

  Pause or resume tracking for one prompt.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitorId (required) — string
  • status (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• run_ai_visibility_prompt

  Ask the AI engines one tracked prompt now and record the answers.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitorId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• delete_ai_visibility_prompt destructive

  Delete a tracked prompt and its history.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitorId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• exclude_ai_visibility_brand

  Leave a brand out of competitor comparisons.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • name (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• restore_ai_visibility_brand

  Bring an excluded brand back into competitor comparisons.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • normalizedName (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• add_ai_visibility_competitor

  Save a brand seen in AI answers as a competitor in the site profile.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • name (required) — string
  • domain (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• create_ai_visibility_topic

  Create a topic to group prompts.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • name (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• rename_ai_visibility_topic

  Rename a prompt topic.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • topicId (required) — string
  • name (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_ai_visibility_topic destructive

  Delete a topic. Its prompts are kept.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • topicId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• move_ai_visibility_prompts

  Move prompts into a topic, or pass topicId null to ungroup them.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • monitorIds (required) — array
  • topicId (required)

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_ai_sentiment_task

  Mark a suggested sentiment task as done or not done.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • taskId (required) — string
  • done (required) — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_search_performance read-only

  Read Google Search Console clicks, impressions, top queries and pages, and whether the property is connected.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • to — string
  • from — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• sync_search_console

  Pull the latest data from Google Search Console.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • idempotencyKey (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• get_seo_health read-only

  Read the latest search health report and open alerts for a website.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_ctr_opportunities read-only

  List pages that rank but get fewer clicks than expected.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• review_page_snippet read-only

  Fetch a page and review its title and meta description against the queries it ranks for.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • pageUrl (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_seo_changes read-only

  List the on-page changes logged for a website and their measured effect.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• log_seo_change

  Record a change made to a page so its effect on search performance is measured.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • pageUrl (required) — string
  • kind (required) — string
  • note
  • after
  • before
  • changedAt — string
  • confirmStacked — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_seo_diagnoses read-only

  List the traffic drop diagnoses run for a website.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_seo_diagnosis read-only

  Read one traffic drop diagnosis with its findings.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • diagnosisId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• start_seo_diagnosis

  Analyze a year of search data for the cause of a traffic drop, optionally for a date range (YYYY-MM-DD).

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • rangeEnd — string
  • rangeStart — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_distribution_status read-only

  Read whether social distribution is connected and which accounts post.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_distribution_pages read-only

  List the website pages that can be turned into social posts.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_distribution_page_atoms read-only

  Read the talking points extracted from a page for social posts.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • pageUrl (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• atomize_distribution_page

  Read a page and extract talking points for social posts.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • pageUrl (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_distribution_campaigns read-only

  List the social distribution campaigns of a website.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_distribution_campaign read-only

  Read one campaign with its schedule and posts.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • campaignId (required) — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_distribution_campaign

  Create a draft campaign that turns a page into scheduled social posts.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • name (required) — string
  • pageUrl (required) — string
  • accountIds (required) — array
  • cadence (required) — object
  • startsAt (required) — string
  • endsAt (required)
  • maxPostsPerAccount (required)
  • mode (required) — string
  • autoPublishAccountIds — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_distribution_campaign

  Replace a draft campaign's settings.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • campaignId (required) — string
  • name (required) — string
  • pageUrl (required) — string
  • accountIds (required) — array
  • cadence (required) — object
  • startsAt (required) — string
  • endsAt (required)
  • maxPostsPerAccount (required)
  • mode (required) — string
  • autoPublishAccountIds — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• activate_distribution_campaign

  Start a campaign so its approved posts are published on schedule. Confirm with the user first.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • campaignId (required) — string
  • confirmStackedChange — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• pause_distribution_campaign

  Pause a running campaign.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • campaignId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• resume_distribution_campaign

  Resume a paused campaign.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • campaignId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• cancel_distribution_campaign destructive

  Cancel a campaign and remove its unpublished posts from the connected social scheduler.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • campaignId (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• list_distribution_posts read-only

  List social posts by campaign, status, or platform.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • platform — string
  • statuses — array
  • campaignId — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• approve_distribution_posts

  Approve posts for publishing to the user's social accounts. Show the user each post first.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • postIds (required) — array

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• edit_distribution_post

  Replace a post's text and approve it for publishing.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • postId (required) — string
  • body (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• reject_distribution_posts

  Reject posts so they are not published.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • postIds (required) — array

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• regenerate_distribution_post

  Write a post again with AI.

  Parameters:

  • projectId (required) — string
  • siteId (required) — string
  • postId (required) — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.