company logo

Help center

Go to Rank Prompt
Powered by
All collectionsIntegrationsConnect Claude Code

Connect Claude Code

Connect Claude Code to Rank Prompt through the MCP server or the Rank Prompt skill, so it can read your visibility data and turn it into changes in your website's code.

Claude Code is Anthropic's coding tool that works inside your repositories. Connected to Rank Prompt, it reads your reports, prompts and citations and turns what they find into real changes in your website repo: content edits, technical SEO fixes, structured data and more.

There are two ways to connect it, and you can use both:

MCP server

Claude Code skill

What it is

A hosted server Claude Code calls as a tool

Files in your repo that teach Claude Code the Rank Prompt API and workflow

Sign-in

OAuth in the browser, no key to copy

An API key in an environment variable

Works in

Claude Code, Cursor and any MCP client

Claude Code

Best for

Reading data and running reports from any client

Turning reports into pull requests in your site's repo

Both run on your account's monthly API request allowance; credits are spent only by actions that cost credits in the app, such as running a new report. See Developer API.

What Claude Code can do with it

  • Pull your latest report for any brand

  • List the prompts that name your brand and the ones that miss it

  • Read the pages AI platforms cite and where you could get cited

  • Write content, schema markup and meta changes in your repo

  • Run a new report and wait for the results, in the same session

A typical loop: run a report on the AI platforms you track, let Claude Code turn what it found into content and technical changes, ship them, then run the report again to see whether your Visibility score moved.


Option 1: the MCP server

  1. In Rank Prompt, open Settings, then MCP under Developers

  2. Copy the command under Add to Claude Code and run it:

claude mcp add --transport http --scope user rankprompt https://mcp.rankprompt.com/mcp
  1. In Claude Code, run /mcp and follow the sign-in link

Or copy the prompt under Or let Claude Code set it up for you, paste it into Claude Code, and it adds the server and signs you in. Signing in creates one scoped MCP key on your account, named after the client that connected, such as MCP (Claude Code); revoke it anytime from API under Developers. Other clients and manual setup has the config for Cursor and other clients.

Several clients at once

Each client you connect keeps its own key: a laptop and a desktop, two Claude Code profiles, Claude Code and Cursor all stay signed in together, and revoking one key from API under Developers signs out only that client. Up to 10 connections stay live per account; connecting an eleventh closes the oldest, which asks to sign in again (run /mcp in Claude Code).

If you belong to a team, the sign-in page asks which account the connection acts in. It then works on that account's brands and draws on that account's request pool; buying credits or plans stays with that account's owner.

The MCP server also lists the agent skills, the same named jobs the agent runs in the app, such as This week's visibility or Me vs a competitor. Ask Claude Code for one by name and it runs it with the server's tools, on your credits and your request allowance.


Option 2: the Claude Code skill

1. Create an API key

Open API under Developers in Settings, click Create key on the API keys tab, and copy the key (it is shown once). Then set it, with the API address, before you run Claude Code:

# macOS / Linux
export RANKPROMPT_API_KEY="rp_live_xxx"
export RANKPROMPT_API="https://api.rankprompt.com"
# Windows (PowerShell)
$env:RANKPROMPT_API_KEY = "rp_live_xxx"
$env:RANKPROMPT_API = "https://api.rankprompt.com"

A key acts in the account you have open when you create it.

2. Install the skill

The Claude Code skill section at the bottom of the MCP page has a prompt to paste into Claude Code (Paste this into Claude Code): it downloads the skill, asks for your key and sets it up. Pick This repo or All projects under Where to install.

To run the install yourself, open Prefer to run the install yourself?. From inside your website's repository:

# macOS / Linux
mkdir -p .claude/skills/rankprompt && for f in SKILL.md API.md WORKFLOW.md; do curl -fsSL "https://app.rankprompt.com/skills/rankprompt/$f" -o ".claude/skills/rankprompt/$f"; done
# Windows (PowerShell)
$dir=".claude\skills\rankprompt"; New-Item -ItemType Directory -Force $dir | Out-Null; "SKILL.md","API.md","WORKFLOW.md" | % { Invoke-WebRequest "https://app.rankprompt.com/skills/rankprompt/$_" -OutFile "$dir\$_" }

For every project, install into ~/.claude/skills/rankprompt/ instead.

3. Ask Claude Code

Open your website's repository in Claude Code and try:

Use the rankprompt skill: pull my latest visibility report and list the
top 3 things to fix on this site, then implement the first one.

Read the pages AI cites for my prompts and draft outreach emails for the
three sites that do not mention my brand yet.

Run a new Rank Prompt report for my brand, wait for it, and turn what it
found into a pull request with content and structured data changes.

Claude Code edits files in your repo and can open pull requests for each change, with the report it came from linked.


Plans and costs

Every plan can connect Claude Code, Free included. What the plan changes is the monthly request allowance (1,000 a month on Free) and the credits you have.

Action

Cost

Reading data (reports, prompts, citations)

Requests from your monthly allowance

Running a new report

Credits, as in the app


FAQ

Do I install the skill in every project?

No. Install it into ~/.claude/skills/rankprompt/ (All projects) and every project has it.

Does it work with several brands?

Yes. Name the brand in your prompt and Claude Code works on that brand.

Will it change my live site?

No. Claude Code edits files in your local repository. Nothing is live until you commit, push and deploy as you normally do.

What if my API key is revoked?

API calls fail with an authentication error. Create a new key and update RANKPROMPT_API_KEY. An MCP connection whose key was revoked, expired after 90 days or was closed by the limit of 10 says it needs to reconnect; sign in again with /mcp.

Can I see what Claude Code requested?

Yes. The Overview tab of the API page shows recent requests, Claude Code's included.


Next steps

  • Developer API: request limits, keys and webhooks

  • API reference: every endpoint

  • Understanding your visibility score: what Claude Code is reading


Questions?

Email [email protected] and I'll help.

Did this answer your question?
😞
😐
😁