New · MCP server + CLI + JSON API

SEO your AI agent
can run

Give your agent a full SEO stack: it plans the month's content, writes and ships blog posts, earns dofollow backlinks from real niche-matched sites, and reads the results back. One API key, connected in a minute.

Get your API key Read the API docs

claude code · rankgoat mcp

> plan next month for redstudio.ie and draft the strongest brief ● whoami 1 site · 14 credits ● plan_auto_brief job queued · polling... ● get_job_status done in 52s Planned "Client portal software for small agencies" commercial intent · comparison format · scheduled Aug 6 ● generate_post 1 credit · writing (1-3 min)... Draft ready. I've left it in your review queue - open it, tweak anything, and hit Approve when you're happy.

Works with Claude Code · Cursor · Windsurf · any MCP client · any agent with a shell

34typed MCP tools

0dependencies

MITopen source

1API key to connect

What your agent can do

Plan content

Read and shape the monthly editorial calendar: AI-planned or hand-written briefs, keywords, post types, schedules, and topic hubs to steer it all.

Write and ship posts

Generate a full post from any brief (1 credit), review the draft, and approve it into the publishing pipeline. Approval stays an explicit, separate call.

Earn real backlinks

Every published post joins the exchange: dofollow links from niche and authority matched member sites, verified at publish and re-checked daily.

Watch it work

Backlink graph, weekly Domain Rating history, Search Console queries, on-page findings and sitemap audits, all as structured JSON your agent can reason over.

Connect in one minute

Create an API key at Settings › API keys in the app, then pick whichever interface your agent speaks.

one line

claude mcp add rankgoat -e RANKGOAT_API_KEY=rg_live_... -- npx -y rankgoat mcp

Cursor, Windsurf, any MCP client

{
  "mcpServers": {
    "rankgoat": {
      "command": "npx",
      "args": ["-y", "rankgoat", "mcp"],
      "env": { "RANKGOAT_API_KEY": "rg_live_..." }
    }
  }
}

structured JSON on every command

export RANKGOAT_API_KEY=rg_live_...
npx -y rankgoat whoami --json
npx -y rankgoat plan list 123 --json
npx -y rankgoat plan generate 456 --wait --json

the raw JSON API

curl -H "Authorization: Bearer rg_live_..." \
  https://rankgoat.app/api/v1/me

Built for agents, not adapted for them

34 typed MCP tools. Each with a JSON schema and a description that says what it reads, what it changes, and what it costs, so the model plans correctly.

Structured JSON everywhere. Every CLI command takes --json; errors are typed envelopes with non-zero exits.

SKILL.md auto-discovery. The npm package ships agent instructions covering workflows, credit costs, and where to keep a human in the loop.

Async done right. Slow operations (AI planning, post generation) return job handles the agent can poll, or block with --wait.

Zero dependencies. The CLI and MCP server are MIT-licensed with no supply chain to audit beyond Node itself.

Instantly revocable. The key is the only credential. Delete it in Settings and every agent integration goes dark that second.

Keep a human in the loop

Two calls have real-world consequences and are deliberately explicit: generating a post spends one of your credits, and approving a post sends it toward publishing on your live site. Everything else is read-only or freely reversible. The tool descriptions and SKILL.md tell agents to check credits before generating and to show you drafts before approving.

FAQ

Does my agent need its own RankGoat account?

No. Your agent acts on your account through an API key you create under Settings, API keys. Revoke the key any time and the agent loses access instantly.

What can the agent actually do?

Everything the member app can do around content and SEO data: read your sites, credits, backlinks, Domain Rating, Search Console and sitemap health; plan and edit the monthly content calendar; generate posts; and approve drafts for publishing. Billing and account settings stay human-only.

What does it cost?

The CLI, MCP server and API are free and included with every RankGoat subscription. Generating a post costs 1 credit, exactly as it does in the app, and the tool descriptions say so, so a well-behaved agent will not spend credits silently.

Which agents work with it?

Any MCP client (Claude Code, Cursor, Windsurf, custom agents) via the built-in MCP server, and any agent that can run shell commands via the CLI, which ships a SKILL.md the agent can read to learn the workflows. Anything else can call the JSON API directly.

Is it safe to let an agent publish?

Publishing still goes through the same pipeline as the app: a generated post lands in your review queue, and approving it is an explicit, separate call. We recommend keeping yourself in the loop on approvals; the SKILL.md tells agents the same thing.

Put an SEO team behind your agent

Create your account, add your site, and hand your agent the key. Source on GitHub and npm.

Start ranking