Google Search Console integration for Model Context Protocol (MCP)
RanklyBee is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
SEO research, AI visibility, content, leads, and backlink workflows. Sign in with RanklyBee OAuth.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http ranklybee-mcp https://api.ranklybee.com/mcp
# 2 — ask your agent for something these tools do
# list_projects, list_backlink_submission_projects, get_backlink_submission_profile and 191 more
RanklyBee costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http ranklybee-mcp https://api.ranklybee.com/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
194 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
List the signed-in user's Projects with their role and websites. Start here to get a projectId.
No parameter schema on file.
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.
No parameter schema on file.
Read the current active Site's backlink submission profile and readiness state.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | no | — |
List visible, available backlink sources that have a supported submission destination.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| search | string | no | — |
| sourceType | string | no | — |
| page | integer | no | — |
| limit | integer | no | — |
Check paid access, profile confirmation, source policy, inventory, duplicate backlinks, and daily capacity before creating a submission job.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| sourceId | string | yes | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| sourceId | string | yes | — |
| idempotencyKey | string | yes | — |
Read the current state and recorded outcome of a backlink submission job.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| jobId | string | yes | — |
Record the result after a user-approved browser interaction. Use needs_verification for CAPTCHA, MFA, email verification, rate limits, or ambiguous results.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| jobId | string | yes | — |
| status | string | yes | — |
| externalUrl | no | — | |
| externalReference | no | — | |
| message | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | no | — |
| filters | object | no | — |
| page | integer | no | — |
| limit | integer | no | — |
Read one lead with its score, evidence quote, reason, stage, and link.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| leadId | string | yes | — |
List the monitoring keywords (search phrases and platforms) for a Project.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
Move a lead to to_qualify, to_contact, in_conversation, or closed. This fires any stage-changed automations the user configured.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| leadId | string | yes | — |
| stage | string | yes | — |
List the websites in a Project. Most tools need a siteId from this list.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
Read what Ranklybee knows about a website: positioning, audience, products, competitors, and the latest analysis job.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Replace the editable site profile. Read it with get_site_profile first and send every field back, changing only what the user asked for.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| profile | object | yes | — |
Crawl the website again and rebuild its profile. Runs in the background; poll get_site_profile for the result.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| idempotencyKey | string | yes | — |
| reviewFoundation | boolean | no | — |
Read how much of each plan allowance the Project has used in the current period.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
Read the latest content plan for a website with its scheduled article briefs. Returns null when no plan exists.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Generate a new content plan from the site profile and keyword research. Uses the plan's content allowance.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| idempotencyKey | string | yes | — |
Start a reviewed content plan so its briefs are written on their scheduled dates.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| planId | string | yes | — |
Approve or reject a whole content plan.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| planId | string | yes | — |
| decision | string | yes | — |
| reason | string | no | — |
Approve or reject one article brief in a content plan.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| planId | string | yes | — |
| briefId | string | yes | — |
| decision | string | yes | — |
| reason | string | no | — |
Move an article brief to another date (YYYY-MM-DD) on the content calendar.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| planId | string | yes | — |
| briefId | string | yes | — |
| scheduledDate | string | yes | — |
Set the notes the writer follows for one article brief. Send an empty string to clear them.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| planId | string | yes | — |
| briefId | string | yes | — |
| instructions | string | yes | — |
Change the target keyword of one article brief.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| planId | string | yes | — |
| briefId | string | yes | — |
| phrase | string | yes | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| query | string | yes | — |
List the keywords saved for a website's articles.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Add keywords to the content plan as article briefs, optionally on a given date. Returns the keywords that were skipped and why.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| phrases | array | yes | — |
| scheduledDate | string | no | — |
Save keywords to the website's keyword list without scheduling articles for them.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| phrases | array | yes | — |
Remove keywords from the website's saved keyword list.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| phrases | array | yes | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| search | string | no | — |
| limit | integer | no | — |
| offset | integer | no | — |
Read one article with its full content, quality checks, and publication state.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
Write the article for an approved brief. Uses the plan's article allowance and takes a few minutes; poll get_article.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| briefId | string | yes | — |
| idempotencyKey | string | yes | — |
Replace an article's editable content. Read it with get_article first and send every content field back.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
| content | object | yes | — |
Rewrite the chosen fields of an article with AI.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
| fields | array | yes | — |
| idempotencyKey | string | yes | — |
Send a draft article to the approval step.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
Approve or reject an article that is waiting for approval.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
| decision | string | yes | — |
| reason | string | no | — |
List the CMS connections an article can be published to.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Publish an approved article to a connected CMS. The article goes live on the user's website, so confirm with the user first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
| connectionId | string | yes | — |
| idempotencyKey | string | yes | — |
Record the live URL of an article the user published by hand, after checking the page.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
| url | string | yes | — |
| idempotencyKey | string | yes | — |
Delete an article from Ranklybee. This does not remove a page already published on the website.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| assetId | string | yes | — |
Read the refresh opportunities found for published articles and the state of each improvement.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Scan published articles against search data for new refresh opportunities.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| idempotencyKey | string | yes | — |
Write the improved version of an article for one opportunity.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| improvementId | string | yes | — |
| idempotencyKey | string | yes | — |
Replace the drafted content of an improvement. Send every content field back.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| improvementId | string | yes | — |
| content | object | yes | — |
Send a drafted improvement to the approval step.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| improvementId | string | yes | — |
Approve or reject an improvement that is waiting for approval.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| improvementId | string | yes | — |
| decision | string | yes | — |
| reason | string | no | — |
Apply an approved improvement to its article. Confirm with the user first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| improvementId | string | yes | — |
Compare search performance before and after an applied improvement and record the result.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| improvementId | string | yes | — |
Dismiss an improvement opportunity with a reason.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| improvementId | string | yes | — |
| reason | string | yes | — |
Read the automatic writing and publishing schedule for a website.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Replace the automatic writing and publishing schedule. Read it with get_content_automation first; auto_publish_approved publishes without a human review.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| enabled | boolean | yes | — |
| timezone | string | yes | — |
| generationLeadHours | integer | yes | — |
| publishingDays | array | yes | — |
| publishTime | string | yes | — |
| mode | string | yes | — |
| defaultCmsConnectionId | yes | — |
Read the writing preferences for a website: voice, structure, images, linking, and improvement rules.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List the pages articles are allowed to link to.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Add a page of the website that articles should link to.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| url | string | yes | — |
| title | yes | — |
Stop articles from linking to a page.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| url | string | yes | — |
List the products articles can feature.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| query | string | no | — |
Add a product to the catalog. Pass imageStorageKey as null.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| fields | object | yes | — |
| imageStorageKey | yes | — |
Replace a product's fields. Send every field back.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| productId | string | yes | — |
| fields | object | yes | — |
| imageStorageKey | no | — |
Set whether articles may feature a product.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| productId | string | yes | — |
| status | string | yes | — |
Delete a product from the catalog.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| productId | string | yes | — |
Read totals for tracked backlinks, their health, and open replacement tasks.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| from | string | no | — |
| to | string | no | — |
List the backlinks Ranklybee tracks for a website, with status and latest check.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| page | integer | no | — |
| perPage | integer | no | — |
| search | string | no | — |
| statuses | array | no | — |
| dofollow | string | no | — |
| pricingModes | array | no | — |
| categories | array | no | — |
| minimumDomainRating | integer | no | — |
| maximumDomainRating | integer | no | — |
| minimumTraffic | integer | no | — |
| maximumTraffic | integer | no | — |
| sortBy | string | no | — |
| sortOrder | string | no | — |
Start tracking a backlink: the page that links (sourceUrl) and the page it links to (targetUrl).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | no | — | |
| threadId | string | no | — |
| contentAssetId | string | no | — |
| source | string | yes | — |
| sourceUrl | string | yes | — |
| targetUrl | string | yes | — |
| expectedAnchor | string | no | — |
| expectedRel | array | no | — |
| pricingMode | string | no | — |
| priceAmountMinor | integer | no | — |
| priceCurrency | string | no | — |
| pricingSource | string | no | — |
| category | string | no | — |
Fetch the linking page and record whether the backlink is still live.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| backlinkId | string | yes | — |
| idempotencyKey | string | yes | — |
Queue a live check for every tracked backlink of a website.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| idempotencyPrefix | string | yes | — |
Change the status or notes of a task opened for a lost backlink.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| taskId | string | yes | — |
| status | string | yes | — |
| assigneeUserId | string | no | — |
| resolutionNotes | string | no | — |
Close a tracked backlink with a reason.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| backlinkId | string | yes | — |
| reason | string | yes | — |
Read whether the website's existing backlinks have been imported.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Import the website's existing backlinks so duplicates are detected.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Search Ranklybee's library of directories and other backlink sources, with quality, pricing, and link type.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| page | integer | no | — |
| perPage | integer | no | — |
| search | string | no | — |
| sourceType | string | no | — |
| pricingModels | array | no | — |
| linkTypes | array | no | — |
| accountRequirements | array | no | — |
| view | string | no | — |
| sortBy | string | no | — |
| sortOrder | string | no | — |
Read prospect counts by status for a website.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List link prospects with scores, status, and contact. Filter by status, keyword, or Domain Rating.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| page | integer | no | — |
| perPage | integer | no | — |
| sourceJobId | string | no | — |
| sourceMode | string | no | — |
| competitorDomain | string | no | — |
| search | string | no | — |
| keyword | string | no | — |
| statuses | array | no | — |
| pageType | string | no | — |
| minDomainRating | integer | no | — |
| maxDomainRating | integer | no | — |
| contact | string | no | — |
| sortBy | string | no | — |
| sortOrder | string | no | — |
Read the Domain Rating range and page types used to find prospects.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Replace the settings used to find prospects. Send every field.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| minDomainRating | integer | yes | — |
| maxDomainRating | integer | yes | — |
| pageTypes | array | yes | — |
List the keywords used to search for link prospects.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Add keywords to search for link prospects.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| phrases | array | yes | — |
Remove one prospecting keyword.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| keywordId | string | yes | — |
List the pages the user pitches in outreach.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Add or update a page worth pitching, with what makes it link-worthy.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| url | string | yes | — |
| title | string | yes | — |
| type | string | yes | — |
| summary | string | yes | — |
| uniqueValue | string | yes | — |
Add a page as a link prospect and score it.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| url | string | yes | — |
Search the web for link prospects. Runs in the background; poll get_prospect_discovery with the returned job. Uses the plan's prospecting allowance.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| goal | string | no | — |
| confirmedKeywords | array | no | — |
| selectedKeywords | array | no | — |
| refresh | boolean | no | — |
Find prospects among the sites that link to the given competitor domains. Runs in the background.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| competitorDomains | array | yes | — |
| goal | string | no | — |
| refresh | boolean | no | — |
Read the progress and result counts of a discovery job.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| jobId | string | yes | — |
Reject one prospect, or block its whole domain from future discovery (a reason is required to block).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | string | yes | — |
| decision | yes | — |
Allow a previously blocked domain to appear in discovery again.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | string | yes | — |
List the people found for outreach, with email verification status.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| page | integer | no | — |
| perPage | integer | no | — |
| search | string | no | — |
| statuses | array | no | — |
| verificationStatuses | array | no | — |
| sortBy | string | no | — |
| sortOrder | string | no | — |
Add a contact by hand.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | string | yes | — |
| string | yes | — | |
| fullName | string | yes | — |
| role | string | yes | — |
| roleCategory | string | yes | — |
| company | string | no | — |
| source | string | no | — |
| sourceProvider | string | no | — |
| sourceUrl | string | no | — |
| sourceReference | string | no | — |
Check whether a contact's email address is deliverable.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| contactId | string | yes | — |
| status | string | yes | — |
| source | string | yes | — |
| provider | string | yes | — |
| providerReference | string | no | — |
| costMicros | integer | yes | — |
| notes | string | no | — |
| idempotencyKey | string | yes | — |
Look up who to email at a prospect's site. Uses the plan's contact allowance.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | string | yes | — |
| idempotencyKey | string | yes | — |
Set which email address outreach to a prospect goes to.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | string | yes | — |
| string | yes | — | |
| idempotencyKey | string | yes | — |
Add a contact to the do-not-email list with a reason.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| contactId | string | yes | — |
| scope | string | yes | — |
| source | string | no | — |
| reason | string | yes | — |
List the email templates available for outreach.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Create an email template.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| name | string | yes | — |
| subjectTemplate | string | yes | — |
| bodyTemplate | string | yes | — |
| fallbackValues | object | no | — |
Replace an email template's content.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| templateId | string | yes | — |
| name | string | yes | — |
| subjectTemplate | string | yes | — |
| bodyTemplate | string | yes | — |
| fallbackValues | object | no | — |
Delete an email template.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| templateId | string | yes | — |
List the sender identities and templates a new draft can use.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List outreach threads in one bucket (ready, queued, sent, or replied) with their draft and latest message.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| bucket | string | no | — |
| search | string | no | — |
| starredOnly | boolean | no | — |
Write a first email to a prospect's contact from a template and sender. Nothing is sent.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | string | yes | — |
| contactId | string | yes | — |
| senderIdentityId | string | yes | — |
| templateId | string | yes | — |
| generationMode | string | no | — |
Write a first email to a prospect's contact, letting Ranklybee pick the sender and template. Nothing is sent.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| prospectId | string | yes | — |
| contactId | string | yes | — |
Replace the subject and body of an unsent draft.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadId | string | yes | — |
| subject | string | yes | — |
| body | string | yes | — |
Rewrite an unsent draft following an instruction.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadId | string | yes | — |
| instruction | string | yes | — |
Record that the outreach earned a link and start tracking that backlink.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadId | string | yes | — |
| sourceUrl | string | yes | — |
| targetUrl | string | yes | — |
| expectedAnchor | string | no | — |
Close an outreach thread that did not earn a link.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadId | string | yes | — |
| reason | string | no | — |
Reopen a thread that was marked won or lost.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadId | string | yes | — |
Read scheduled and sent emails, sender limits, and replies waiting for review.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Set the sending window, weekdays, and daily limit for one sender identity.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| senderIdentityId | string | yes | — |
| status | string | yes | — |
| windowStartMinute | integer | yes | — |
| windowEndMinute | integer | yes | — |
| allowedWeekdays | array | yes | — |
| dailyLimit | integer | yes | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadId | string | yes | — |
| mode | string | yes | — |
| sendNow | boolean | no | — |
| idempotencyKey | string | yes | — |
| followUps | array | no | — |
Schedule several drafted threads at once. mode=live emails real people; get the user's approval of every email first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadIds | array | yes | — |
| mode | string | yes | — |
| idempotencyKey | string | yes | — |
| followUps | array | no | — |
Send a message in an existing outreach thread from the user's mailbox. Get the user's approval of the exact text first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| threadId | string | yes | — |
| body | string | yes | — |
| ccEmails | array | no | — |
| idempotencyKey | string | yes | — |
Act on a reply Ranklybee drafted for an inbound email. action=send emails a real person; get the user's approval first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| suggestionId | string | yes | — |
| action | string | yes | — |
| body | string | yes | — |
Cancel the remaining emails of a scheduled sequence.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| sequenceId | string | yes | — |
| reason | string | yes | — |
Read what the outreach agent did over the last 7, 30, or 90 days.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| from | string | no | — |
| to | string | no | — |
Read whether the outreach agent is running and its limits.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List recent runs of the outreach agent.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List the cases the outreach agent stopped on and left for a human.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| statuses | array | no | — |
Pause or resume the outreach agent. While active it finds prospects and sends emails on its own.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| status | string | yes | — |
Change the status or notes of an exception.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| exceptionId | string | yes | — |
| status | string | yes | — |
| assigneeUserId | no | — | |
| resolutionNotes | no | — |
Read lead counts by tier and stage, the monitor state, keywords, and customer profiles.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| from | string | no | — |
| to | string | no | — |
Read how often and where the brand is mentioned.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List collected posts that matched a keyword, including brand mentions that are not leads.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| purpose | string | no | — |
| needsResponse | boolean | no | — |
| platform | string | no | — |
| keywordId | string | no | — |
| sentiment | string | no | — |
| search | string | no | — |
| favorites | boolean | no | — |
| sources | array | no | — |
| dateFrom | string | no | — |
| dateTo | string | no | — |
| commentsMin | integer | no | — |
| commentsMax | integer | no | — |
| upvotesMin | integer | no | — |
| upvotesMax | integer | no | — |
| scoreMin | integer | no | — |
| scoreMax | integer | no | — |
| orders | array | no | — |
| sort | string | no | — |
Search the monitored platforms now and score what is found. Uses the plan's lead scan allowance.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Tell Ranklybee whether a lead was a good match so scoring improves.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| mentionId | string | yes | — |
| feedback | string | yes | — |
Add or remove a lead from the user's favorites.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| mentionId | string | yes | — |
| favorite | boolean | yes | — |
Hide a lead that is not relevant.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| mentionId | string | yes | — |
Bring back a dismissed lead.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| mentionId | string | yes | — |
Draft a reply to a lead's post in the chosen tone. Nothing is posted; the user posts it themselves.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| mentionId | string | yes | — |
| tone | string | no | — |
| regenerate | boolean | no | — |
| idempotencyKey | string | yes | — |
Edit a drafted reply, or record that the user posted or dismissed it.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| mentionId | string | yes | — |
| action | string | yes | — |
| body | string | no | — |
Add a keyword to monitor, with its search phrases and platforms.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| keyword | object | yes | — |
Replace a monitoring keyword's phrases and platforms.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| keywordId | string | yes | — |
| keyword | object | yes | — |
Pause or resume monitoring for one keyword.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| keywordId | string | yes | — |
| status | string | yes | — |
Delete a monitoring keyword.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| keywordId | string | yes | — |
Add a customer profile that leads are scored against.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| icp | object | yes | — |
Replace a customer profile.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| icpId | string | yes | — |
| icp | object | yes | — |
Delete a customer profile.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| icpId | string | yes | — |
Set which platforms are searched for leads.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| platforms | array | yes | — |
Set how often leads are scanned and whether the monitor is active.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| frequency | string | yes | — |
| status | string | yes | — |
List the rules that notify the user about new leads.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Create a rule that notifies a channel when matching leads arrive.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| rule | object | yes | — |
Pause or resume one alert rule.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| ruleId | string | yes | — |
| status | string | yes | — |
Delete an alert rule.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| ruleId | string | yes | — |
Read how often AI assistants mention the brand: visibility, share of voice, position, and trend.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engines | array | no | — |
| categories | array | no | — |
| from | string | no | — |
| to | string | no | — |
List the tracked prompts with visibility, position, and the brands each answer names.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
List the recorded answers for one prompt across AI engines.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
| monitorId | string | yes | — |
Read the ranking of brands in AI answers, share of voice, and head-to-head prompts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
| category | string | no | — |
| sovScope | string | no | — |
| compare | array | no | — |
Read one brand's visibility against the user's, with the prompts and sources behind it. brandKey comes from get_ai_visibility_competitors.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
| brandKey | string | yes | — |
| category | string | no | — |
Read which domains and pages AI answers cite, and the domains that never mention the brand.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
| monitorId | string | no | — |
| category | string | no | — |
| categories | array | no | — |
List the pages of one domain that AI answers cite.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
| domain | string | yes | — |
| monitorId | string | no | — |
| category | string | no | — |
| categories | array | no | — |
Read how positively AI answers describe the brand and the themes driving it.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
| themeKey | string | yes | — |
Compare how favorably AI answers describe the brand and its rivals.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| engine | string | no | — |
| engines | array | no | — |
| from | string | no | — |
| to | string | no | — |
| rival | string | no | — |
Read the full text of one recorded AI answer.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| runId | string | yes | — |
Ask AI for prompts worth tracking for the website. Nothing is tracked until you create them.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| description | string | no | — |
Add a prompt to track across AI engines. Counts against the plan's prompt limit.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| monitor | object | yes | — |
Add up to 100 prompts at once. Counts against the plan's prompt limit.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| monitors | array | yes | — |
Replace a tracked prompt's settings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| monitorId | string | yes | — |
| monitor | object | yes | — |
Pause or resume tracking for one prompt.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| monitorId | string | yes | — |
| status | string | yes | — |
Ask the AI engines one tracked prompt now and record the answers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| monitorId | string | yes | — |
| idempotencyKey | string | yes | — |
Delete a tracked prompt and its history.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| monitorId | string | yes | — |
Leave a brand out of competitor comparisons.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| name | string | yes | — |
Bring an excluded brand back into competitor comparisons.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| normalizedName | string | yes | — |
Save a brand seen in AI answers as a competitor in the site profile.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| name | string | yes | — |
| domain | string | yes | — |
Create a topic to group prompts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| name | string | yes | — |
Rename a prompt topic.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| topicId | string | yes | — |
| name | string | yes | — |
Delete a topic. Its prompts are kept.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| topicId | string | yes | — |
Move prompts into a topic, or pass topicId null to ungroup them.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| monitorIds | array | yes | — |
| topicId | yes | — |
Mark a suggested sentiment task as done or not done.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| taskId | string | yes | — |
| done | boolean | yes | — |
Read Google Search Console clicks, impressions, top queries and pages, and whether the property is connected.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| from | string | no | — |
| to | string | no | — |
Pull the latest data from Google Search Console.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| idempotencyKey | string | yes | — |
Read the latest search health report and open alerts for a website.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List pages that rank but get fewer clicks than expected.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Fetch a page and review its title and meta description against the queries it ranks for.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| pageUrl | string | yes | — |
List the on-page changes logged for a website and their measured effect.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Record a change made to a page so its effect on search performance is measured.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| pageUrl | string | yes | — |
| kind | string | yes | — |
| before | no | — | |
| after | no | — | |
| note | no | — | |
| changedAt | string | no | — |
| confirmStacked | boolean | no | — |
List the traffic drop diagnoses run for a website.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Read one traffic drop diagnosis with its findings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| diagnosisId | string | yes | — |
Analyze a year of search data for the cause of a traffic drop, optionally for a date range (YYYY-MM-DD).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| rangeStart | string | no | — |
| rangeEnd | string | no | — |
Read whether social distribution is connected and which accounts post.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
List the website pages that can be turned into social posts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Read the talking points extracted from a page for social posts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| pageUrl | string | yes | — |
Read a page and extract talking points for social posts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| pageUrl | string | yes | — |
List the social distribution campaigns of a website.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
Read one campaign with its schedule and posts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| campaignId | string | yes | — |
Create a draft campaign that turns a page into scheduled social posts.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| name | string | yes | — |
| pageUrl | string | yes | — |
| accountIds | array | yes | — |
| autoPublishAccountIds | array | no | — |
| cadence | object | yes | — |
| startsAt | string | yes | — |
| endsAt | yes | — | |
| maxPostsPerAccount | yes | — | |
| mode | string | yes | — |
Replace a draft campaign's settings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| campaignId | string | yes | — |
| name | string | yes | — |
| pageUrl | string | yes | — |
| accountIds | array | yes | — |
| autoPublishAccountIds | array | no | — |
| cadence | object | yes | — |
| startsAt | string | yes | — |
| endsAt | yes | — | |
| maxPostsPerAccount | yes | — | |
| mode | string | yes | — |
Start a campaign so its approved posts are published on schedule. Confirm with the user first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| campaignId | string | yes | — |
| confirmStackedChange | boolean | no | — |
Pause a running campaign.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| campaignId | string | yes | — |
Resume a paused campaign.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| campaignId | string | yes | — |
Cancel a campaign and remove its unpublished posts from the connected social scheduler.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| campaignId | string | yes | — |
List social posts by campaign, status, or platform.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| campaignId | string | no | — |
| statuses | array | no | — |
| platform | string | no | — |
Approve posts for publishing to the user's social accounts. Show the user each post first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| postIds | array | yes | — |
Replace a post's text and approve it for publishing.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| postId | string | yes | — |
| body | string | yes | — |
Reject posts so they are not published.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| postIds | array | yes | — |
Write a post again with AI.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| projectId | string | yes | — |
| siteId | string | yes | — |
| postId | string | yes | — |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install RanklyBee or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| list_projects | no tags | |
| list_backlink_submission_projects | no tags | |
| get_backlink_submission_profile | no tags | |
| list_backlink_submission_sources | no tags | |
| preflight_backlink_submission | state-write | state-write: declares readOnlyHint: false |
| create_backlink_submission | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| get_backlink_submission | no tags | |
| record_backlink_submission_outcome | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| list_leads | no tags | |
| get_lead | no tags | |
| list_lead_keywords | no tags | |
| move_lead_stage | state-write | state-write: declares readOnlyHint: false |
| list_sites | no tags | |
| get_site_profile | no tags | |
| update_site_profile | state-write | state-write: declares readOnlyHint: false |
| analyze_site | untrusted-inputexternal-sink | untrusted-input: keyword "crawl"; external-sink: declares readOnlyHint: false, openWorldHint: true |
| get_plan_usage | no tags | |
| get_content_plan | no tags | |
| generate_content_plan | state-write | state-write: declares readOnlyHint: false |
| activate_content_plan | state-write | state-write: declares readOnlyHint: false |
| decide_content_plan | state-write | state-write: declares readOnlyHint: false |
| decide_content_brief | state-write | state-write: declares readOnlyHint: false |
| reschedule_content_brief | state-write | state-write: declares readOnlyHint: false |
| update_content_brief_instructions | state-write | state-write: declares readOnlyHint: false |
| update_content_brief_keyword | state-write | state-write: declares readOnlyHint: false |
| search_article_keywords | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| list_article_keywords | no tags | |
| add_article_keywords | state-write | state-write: declares readOnlyHint: false |
| import_article_keywords | state-write | state-write: declares readOnlyHint: false |
| remove_article_keywords | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| list_articles | no tags | |
| get_article | no tags | |
| generate_article | state-write | state-write: declares readOnlyHint: false |
| update_article | state-write | state-write: declares readOnlyHint: false |
| regenerate_article_fields | state-write | state-write: declares readOnlyHint: false |
| submit_article_for_review | state-write | state-write: declares readOnlyHint: false |
| decide_article | state-write | state-write: declares readOnlyHint: false |
| list_cms_connections | no tags | |
| publish_article | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| verify_article_publication | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| delete_article | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| get_article_improvements | no tags | |
| detect_article_improvements | state-write | state-write: declares readOnlyHint: false |
| generate_article_improvement | state-write | state-write: declares readOnlyHint: false |
| update_article_improvement | state-write | state-write: declares readOnlyHint: false |
| submit_article_improvement | state-write | state-write: declares readOnlyHint: false |
| decide_article_improvement | state-write | state-write: declares readOnlyHint: false |
| apply_article_improvement | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| compare_article_improvement | state-write | state-write: declares readOnlyHint: false |
| dismiss_article_improvement | state-write | state-write: declares readOnlyHint: false |
| get_content_automation | no tags | |
| update_content_automation | state-write | state-write: declares readOnlyHint: false |
| get_article_settings | no tags | |
| list_internal_link_targets | no tags | |
| add_internal_link_target | state-write | state-write: declares readOnlyHint: false |
| remove_internal_link_target | state-write | state-write: declares readOnlyHint: false |
| list_products | no tags | |
| create_product | state-write | state-write: declares readOnlyHint: false |
| update_product | state-write | state-write: declares readOnlyHint: false |
| set_product_status | state-write | state-write: declares readOnlyHint: false |
| delete_product | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| get_backlinks_overview | no tags | |
| list_backlinks | no tags | |
| add_backlink | state-write | state-write: declares readOnlyHint: false |
| check_backlink | untrusted-inputexternal-sink | untrusted-input: keyword "fetch"; external-sink: declares readOnlyHint: false, openWorldHint: true |
| check_site_backlinks | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| update_backlink_task | state-write | state-write: declares readOnlyHint: false |
| close_backlink | state-write | state-write: declares readOnlyHint: false |
| get_backlink_inventory_status | no tags | |
| start_backlink_inventory | state-write | state-write: declares readOnlyHint: false |
| list_featured_backlinks | no tags | |
| get_prospecting_summary | no tags | |
| list_prospects | no tags | |
| get_prospect_discovery_settings | no tags | |
| update_prospect_discovery_settings | state-write | state-write: declares readOnlyHint: false |
| list_outreach_keywords | no tags | |
| add_outreach_keywords | state-write | state-write: declares readOnlyHint: false |
| remove_outreach_keyword | state-write | state-write: declares readOnlyHint: false |
| list_linkable_assets | no tags | |
| save_linkable_asset | state-write | state-write: declares readOnlyHint: false |
| add_prospect | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| start_prospect_discovery | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| start_competitor_backlink_discovery | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| get_prospect_discovery | no tags | |
| reject_prospect | state-write | state-write: declares readOnlyHint: false |
| unblock_prospect_domain | state-write | state-write: declares readOnlyHint: false |
| list_contacts | no tags | |
| create_contact | state-write | state-write: declares readOnlyHint: false |
| verify_contact | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| find_prospect_contact | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| select_prospect_contact | state-write | state-write: declares readOnlyHint: false |
| suppress_contact | state-write | state-write: declares readOnlyHint: false |
| list_outreach_templates | no tags | |
| create_outreach_template | state-write | state-write: declares readOnlyHint: false |
| update_outreach_template | state-write | state-write: declares readOnlyHint: false |
| delete_outreach_template | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| get_outreach_draft_options | no tags | |
| list_outreach_threads | no tags | |
| create_outreach_draft | state-write | state-write: declares readOnlyHint: false |
| prepare_outreach_draft | state-write | state-write: declares readOnlyHint: false |
| update_outreach_draft | state-write | state-write: declares readOnlyHint: false |
| regenerate_outreach_draft | state-write | state-write: declares readOnlyHint: false |
| mark_outreach_won | state-write | state-write: declares readOnlyHint: false |
| mark_outreach_lost | state-write | state-write: declares readOnlyHint: false |
| reopen_outreach_thread | state-write | state-write: declares readOnlyHint: false |
| get_outreach_sending_dashboard | no tags | |
| update_outreach_send_policy | state-write | state-write: declares readOnlyHint: false |
| schedule_outreach | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| schedule_outreach_batch | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| send_outreach_follow_up | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| review_outreach_reply | external-sink | external-sink: keyword "send_email", declares readOnlyHint: false, openWorldHint: true |
| stop_outreach_sequence | state-write | state-write: declares readOnlyHint: false |
| get_outreach_automation_overview | no tags | |
| get_outreach_automation_policy | no tags | |
| list_outreach_automation_runs | no tags | |
| list_outreach_automation_exceptions | no tags | |
| set_outreach_automation_status | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| update_outreach_automation_exception | state-write | state-write: declares readOnlyHint: false |
| get_leads_overview | no tags | |
| get_brand_mentions_overview | no tags | |
| list_mentions | no tags | |
| run_lead_scan | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| set_lead_feedback | state-write | state-write: declares readOnlyHint: false |
| set_lead_favorite | state-write | state-write: declares readOnlyHint: false |
| dismiss_lead | state-write | state-write: declares readOnlyHint: false |
| restore_lead | state-write | state-write: declares readOnlyHint: false |
| generate_lead_reply | state-write | state-write: declares readOnlyHint: false |
| update_lead_reply | state-write | state-write: declares readOnlyHint: false |
| create_lead_keyword | state-write | state-write: declares readOnlyHint: false |
| update_lead_keyword | state-write | state-write: declares readOnlyHint: false |
| set_lead_keyword_status | state-write | state-write: declares readOnlyHint: false |
| delete_lead_keyword | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| create_lead_icp | state-write | state-write: declares readOnlyHint: false |
| update_lead_icp | state-write | state-write: declares readOnlyHint: false |
| delete_lead_icp | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| update_lead_sources | state-write | state-write: declares readOnlyHint: false |
| update_lead_monitor | state-write | state-write: declares readOnlyHint: false |
| list_lead_alert_rules | no tags | |
| create_lead_alert_rule | state-write | state-write: declares readOnlyHint: false |
| set_lead_alert_rule_status | state-write | state-write: declares readOnlyHint: false |
| delete_lead_alert_rule | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| get_ai_visibility_overview | no tags | |
| list_ai_visibility_prompts | no tags | |
| list_ai_visibility_prompt_runs | no tags | |
| get_ai_visibility_competitors | no tags | |
| get_ai_visibility_competitor | no tags | |
| get_ai_visibility_citations | no tags | |
| get_ai_visibility_domain_pages | no tags | |
| get_ai_sentiment_overview | no tags | |
| get_ai_sentiment_driver | no tags | |
| get_ai_sentiment_benchmark | no tags | |
| get_ai_response | no tags | |
| suggest_ai_visibility_prompts | state-write | state-write: declares readOnlyHint: false |
| create_ai_visibility_prompt | state-write | state-write: declares readOnlyHint: false |
| bulk_create_ai_visibility_prompts | state-write | state-write: declares readOnlyHint: false |
| update_ai_visibility_prompt | state-write | state-write: declares readOnlyHint: false |
| set_ai_visibility_prompt_status | state-write | state-write: declares readOnlyHint: false |
| run_ai_visibility_prompt | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| delete_ai_visibility_prompt | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| exclude_ai_visibility_brand | state-write | state-write: declares readOnlyHint: false |
| restore_ai_visibility_brand | state-write | state-write: declares readOnlyHint: false |
| add_ai_visibility_competitor | state-write | state-write: declares readOnlyHint: false |
| create_ai_visibility_topic | state-write | state-write: declares readOnlyHint: false |
| rename_ai_visibility_topic | state-write | state-write: declares readOnlyHint: false |
| delete_ai_visibility_topic | state-write | state-write: declares readOnlyHint: false, destructiveHint: true |
| move_ai_visibility_prompts | state-write | state-write: declares readOnlyHint: false |
| set_ai_sentiment_task | state-write | state-write: declares readOnlyHint: false |
| get_search_performance | no tags | |
| sync_search_console | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| get_seo_health | no tags | |
| list_ctr_opportunities | no tags | |
| review_page_snippet | untrusted-input | untrusted-input: keyword "fetch" |
| list_seo_changes | no tags | |
| log_seo_change | state-write | state-write: declares readOnlyHint: false |
| list_seo_diagnoses | no tags | |
| get_seo_diagnosis | no tags | |
| start_seo_diagnosis | state-write | state-write: declares readOnlyHint: false |
| get_distribution_status | no tags | |
| list_distribution_pages | no tags | |
| get_distribution_page_atoms | no tags | |
| atomize_distribution_page | state-write | state-write: declares readOnlyHint: false |
| list_distribution_campaigns | no tags | |
| get_distribution_campaign | no tags | |
| create_distribution_campaign | state-write | state-write: declares readOnlyHint: false |
| update_distribution_campaign | state-write | state-write: declares readOnlyHint: false |
| activate_distribution_campaign | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| pause_distribution_campaign | state-write | state-write: declares readOnlyHint: false |
| resume_distribution_campaign | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| cancel_distribution_campaign | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| list_distribution_posts | no tags | |
| approve_distribution_posts | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| edit_distribution_post | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| reject_distribution_posts | state-write | state-write: declares readOnlyHint: false |
| regenerate_distribution_post | state-write | state-write: declares readOnlyHint: false |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.3.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish RanklyBee can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.