Skip to main content
Skills run the playbook. RankEarly MCP gives your agent direct access to keyword libraries, SERP analysis, keyword expansion, clustering, and topic management. Connect using OAuth, no API key needed.

​
Setup

You can connect RankEarly MCP from any MCP client that supports remote HTTP servers and OAuth. For most clients, use https://www.rankearly.pro/api/mcp as the remote MCP server URL.

​
Claude CLI

​
Claude Desktop

Follow Claude Desktop’s custom connector setup guide.
1

Open connectors

Click Customize in the Claude Desktop sidebar, then open Connectors.
2

Add a custom connector

Click the + button and choose Add custom connector.
3

Enter the RankEarly connector details

Set Name to RankEarly and Remote MCP server URL to https://www.rankearly.pro/api/mcp.
4

Save the connector

Confirm the dialog to add the connector. RankEarly will then be available as a connector in Claude Desktop.
Claude Desktop custom connector dialog configured for the RankEarly MCP server

​
Available tools

Most tools center on a keyword library. Your agent can add or refresh keywords, read existing keyword data, expand a topic into more keywords, cluster a library into content structure, analyze saved SERPs, manage topics, and audit content quality.
You can refer to a keyword library by its name or ID — your agent will resolve either one.

​
Pricing and Credits

Most MCP tools are free to call. Credits are only charged for tools that trigger paid upstream data fetches or heavy analysis work. Notes:
  • add_or_update_keyword is charged only when RankEarly successfully fetches fresh keyword data and saves it.
  • expand_keywords charges 8 credits per seed used plus 1 credit per keyword returned. The number of seeds depends on the effort level you choose (see below). Choosing a higher effort means more seeds and a larger estimated keyword range.
  • analyze_serp is charged when the analysis task is started successfully.
  • audit_content_quality is charged per audit run regardless of pass or fail.
  • get_research_status is always free so agents can poll safely without accidental double charging.

​
list_projects

Lists your projects along with how many keyword libraries and research tasks each one contains. Use this when your agent needs to understand which projects you have before picking a library.

​
create_keyword_library

Creates a new keyword library. Each library stores a shared country and language for every keyword inside it (defaults to US / English if not specified). The library is created in your most recently updated active project.

​
list_keyword_libaries

Lists every keyword library across all your projects, including name, keyword count, country, and language. Use this when your agent needs to discover which library to work with.

​
add_or_update_keyword

Fetches fresh SERP and keyword data for a keyword, then saves it into the selected library. If the keyword already exists, it gets updated; otherwise it’s created. Use this when you want to add a keyword or refresh its data.

​
get_keyword

Looks up a keyword in a library without changing anything. Use this when you just want to read the saved data.

​
expand_keywords

Starts keyword expansion for a topic or a set of seed keywords and saves discovered keywords into the selected library. Expansion runs in the background — use get_research_status to check progress. Two ways to start expansion:
  • topic — describe a content idea or feature in plain English (minimum 20 characters). RankEarly generates seed keywords from the topic and expands from there.
  • seeds — pass comma-separated keywords you already know (1–30 keywords). Use this when you have a specific starting point.
topic and seeds are mutually exclusive — pass one or the other. Effort levels control how broad the search is. Pass effort explicitly; it defaults to medium when omitted.

​
get_research_status

Checks the status of a background task — keyword expansion or topic clustering. Returns the current status and a link where you can inspect the result.

​
cluster_keywords

Groups keywords in a library into topics and keyword clusters. Best used after the library already has keywords with SERP data, so you can turn it into a content structure you can prioritize.

​
analyze_serp

Runs a deep content gap analysis on the saved SERP for a keyword and returns the results directly. Pass mode: "content_gap_analysis" — this is currently the only supported mode.

​
list_topics

Lists all topics in a keyword library. Returns each topic’s name, cluster count, and description. Use this to see the content structure that clustering has produced.

​
get_topic_details

Gets detailed information about a specific topic, including its name, description, and all keyword clusters with their keywords. Use this when you need to see the full structure of a topic.

​
delete_topics

Deletes one or more topics from a keyword library by their names. Use this to remove unwanted content structures.

​
audit_content_quality

Audits content quality against a 40+ point E-E-A-T checklist and returns a scored report. Pass a url to audit a published page, or omit it to upload a local draft file instead. The tool returns a curl command. Run it to get the formatted audit report. See Content Audit for the full documentation on what gets checked and how to use this in a writing workflow.