[go: up one dir, main page]

Skip to content
Launch offer: 20% off monthly for as long as you stay, or 35% off your first year. First 10 customers.
MCP server · Updated October 20, 2026

The link building MCP server

BacklinkGenie's MCP server is a remote Model Context Protocol endpoint with 22 tools and 4 prompts. Claude, ChatGPT, Cursor and other AI assistants use it to review pitches, draft replies to editors, import posts and report which links went live.

Server URL (Streamable HTTP)
https://app.backlinkgenie.com/mcp

Add the URL in Claude, Claude Code, ChatGPT or Cursor and sign in in your browser (OAuth). Scripts and clients without OAuth send an API key from Settings → MCP as Authorization: Bearer bg_live_…. Included on every paid plan.

22

tools

4

prompts

8

setup guides

Safety rules every client gets

  • Nothing is approved or sent until you confirm the exact email.
  • Edits and replies pass the quality check: recipient lock, links only to your site, no paid-link offers.
  • Sending stays inside each mailbox's daily limit and the bounce and opt-out rules.
  • Sign-ins and keys are per person; disconnect an app or revoke a key in one click.
Setup

How do I connect my client?

Claude, Claude Code, ChatGPT and Cursor need only the URL and a browser sign-in. The Codex, Gemini CLI, Windsurf and n8n guides use an API key as a Bearer token. Each guide has the exact config.

Client How it connects Auth Guide
Claude Settings → Connectors → Add custom connector, paste the URL Sign in Claude setup
ChatGPT Settings → Connectors, add a custom connector with the URL Sign in ChatGPT setup
Claude Code claude mcp add --transport http …, then /mcp → Authenticate Sign in Claude Code setup
Cursor URL entry in ~/.cursor/mcp.json, then Connect Sign in Cursor setup
Codex codex mcp add … --bearer-token-env-var API key Codex setup
Gemini CLI gemini mcp add --transport http … API key Gemini CLI setup
Windsurf Entry in ~/.codeium/windsurf/mcp_config.json API key Windsurf setup
n8n MCP Client Tool node on an AI Agent API key n8n setup

Cursor

~/.cursor/mcp.json
{
  "mcpServers": {
    "backlinkgenie": {
      "url": "https://app.backlinkgenie.com/mcp"
    }
  }
}

Claude Code

Terminal
claude mcp add --transport http backlinkgenie https://app.backlinkgenie.com/mcp

Codex

~/.zshrc or ~/.bashrc
export BACKLINKGENIE_API_KEY="bg_live_your_key"

Any client or script (JSON-RPC over HTTP)

List tools
POST https://app.backlinkgenie.com/mcp
Authorization: Bearer bg_live_your_key
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}
Tools

Which tools does the BacklinkGenie MCP server have?

22 tools, all on every paid plan. Read tools don't use any emails and are safe to run any time. Tools marked "changes things" send, approve, edit or write new pitches, and your assistant should confirm with you first.

10 read only 12 change things
Tool What it does Type
list_workspaces Lists your sites with their ids, review status and headline numbers. Call it first. Read only
get_overview Prospects found, pitches sent, replies, reply rate, links won, Domain Rating trend and mailbox ramp-up for one site. Read only
run_agent Starts a run that finds new posts in your niche and drafts pitches. Pitches count toward your monthly emails. Changes things
list_drafts Pitches waiting for your approval, with the post, contact and why it fits. Read only
edit_draft Changes a pitch's subject or body. Edits go through the quality check before they're saved. Changes things
approve_draft Queues one pitch for sending. Your assistant is told to ask you first. Changes things
discard_draft Throws a pitch away and skips that site. Changes things
list_replies Conversations where an editor answered, filterable by hot, warm, paid offer, neutral, cold, closed or archived. Read only
get_conversation The full thread for one conversation. Read only
generate_reply Drafts your next reply: the exact page, the anchor text and a sentence the editor can paste. Doesn't send, and replies don't use your email allowance. Read only
send_reply Sends a reply you've confirmed. Passes the same quality check as the dashboard. Changes things
list_links Links you've won and whether each one is still live and followed. Read only
import_posts Gives the agent specific post URLs to pitch. It qualifies them, finds the contact and drafts. Changes things
get_prospect_report Every prospect with its Domain Rating, Google ranking evidence, contact status, fit score and why it fits. Read only
skip_prospect Skips a prospect and discards any pending pitch. Can also block the whole domain. Changes things
add_to_blocklist Adds domains the agent must never contact. Changes things
mark_link_won Records a link an editor added. It's verified on the live page and re-checked weekly. Changes things
check_link Re-checks a won link now: live, removed or nofollow. Read only
get_billing Your plan, its status, outreach emails left this month and recent usage. Read only
create_workspace Adds a new site by URL. It's checked against the acceptable-use rules and profiled. Changes things
update_workspace_profile Edits the profile pitches are written from: product, sender name, niche, differentiator, competitors, audiences, style, minimum DR. Changes things
start_free_report Builds the one-time free prospect report for a site on the free plan. Changes things
Prompts

Which prompts does the server include?

Four ready-made MCP prompts. Clients that support prompts list them in a menu or as slash commands.

daily_review

Walks through today's pitches and replies one at a time and approves only what you confirm.

Arguments: site (optional)

reply_triage

Goes through editor replies, drafts responses and records won links.

Arguments: site (optional)

weekly_report

A short report of the week: pitches, replies, links won and lost, and Domain Rating change.

Arguments: site (optional)

pitch_my_list

Hands the agent specific post URLs to qualify and pitch.

Arguments: urls (required), site (optional)

Why run outreach from an assistant?

BacklinkGenie is an AI link-building outreach agent: it buys a separate sending domain, finds posts in your niche, finds and verifies the editor, writes one pitch per post, sends it and follows up, and checks every won link weekly. BacklinkGenie does the searching, sending and follow-ups, to raise your Domain Rating, organic traffic and AI mentions. The point is the links: placements on posts that already rank, which lift your Domain Rating, send referral traffic and get you named when AI assistants answer questions in your category.

Link outreach is a queue of small decisions: is this post a fit, is this pitch good enough, how do I answer this editor. Doing that from the chat you already have open is faster than switching to another dashboard, and your assistant can pull context from your own docs, changelog or notes while it works. The research, contact lookup, sending, follow-ups and link checks still run inside BacklinkGenie, so nothing depends on your assistant being open. For a wider look at where MCP fits in SEO work, read MCP servers for SEO: running link building from Claude, ChatGPT and Cursor, and for the limits of handing outreach to software, what AI link building agents can and can't do.

What the assistant can't do

  • Send to an address other than the contact BacklinkGenie found for that site (or another address on the same domain).
  • Add links to sites other than yours, or offer payment or an irrelevant or large-scale link swap in a pitch or follow-up. The quality check rejects these. A relevant mutual mention that an editor proposes is fine to accept. If an editor asks you for a fee, their reply is flagged as a paid offer and whether to pay is your call.
  • Go over a mailbox's daily limit or skip the ramp on a new mailbox.
  • Act on a site that failed our review, or do anything beyond the free prospect report on an account without an active paid plan.

Prefer to work without an assistant? Everything here is also in the dashboard. See how it works or compare plans. Ready to connect? Pick your assistant from the integration guides, then try the ready-made link building prompts.

FAQ

Questions people ask

What is the BacklinkGenie MCP server?

It's a remote Model Context Protocol server at https://app.backlinkgenie.com/mcp. Any MCP client, such as Claude, ChatGPT, Cursor or n8n, can connect to it and use 22 tools to run your link outreach: list and approve pitches, read and answer replies, import target posts and check won links.

Can my assistant send emails without asking me?

Not by default. The server tells every assistant to show you exactly what will happen and wait for your explicit go-ahead before any tool that sends email or uses your email allowance: approve_draft, send_reply, run_agent, import_posts, generate_reply and start_free_report. Pitches and follow-ups the assistant writes or edits also pass BacklinkGenie's quality check, which blocks wrong recipients, links to other sites and payment or link-exchange offers. Autopilot, which sends without per-email approval, is a setting you turn on yourself in the dashboard.

How do I authenticate?

By signing in. The server supports OAuth 2.1 with dynamic client registration, so Claude, Claude Code, ChatGPT and Cursor only need the URL: your browser opens BacklinkGenie, you sign in and approve. For scripts, CI and clients without OAuth, create an API key under Settings → MCP (it starts with bg_live_) and send it as a Bearer token. You can disconnect apps and revoke keys there any time.

Which plan includes MCP?

Every paid plan: Starter $99/mo (1 site, 1 mailbox, 1,000 emails), Growth $249/mo (3 sites, 3 mailboxes, 3,000 emails), Agency $499/mo (8 sites, 8 mailboxes, 8,000 emails). All 22 tools work on each one; only the limits on sites, mailboxes and emails differ. Without an active paid plan you can still connect, but the only tool that runs is start_free_report, which builds your one free prospect report. Every other tool returns a message with the upgrade link.

Does using tools cost extra?

No. MCP access is part of every paid plan, and BacklinkGenie charges a flat monthly price with no per-link fee. Pitches and follow-ups written through your assistant count toward the same monthly emails as the dashboard (1 email each); reading data, drafting and sending replies to editors don't use any.

Does the server expose prompts as well as tools?

Yes, four: daily_review, reply_triage, weekly_report and pitch_my_list. Clients that support MCP prompts show them as slash commands or in a prompt menu; in Claude Code, for example, type /mcp__backlinkgenie__daily_review.

Which MCP versions are supported?

The server speaks Streamable HTTP and answers both the current stateless protocol (server/discover) and older clients that start with initialize, so current and older MCP clients both work.

Keep reading

Related

Start with a free prospect report

Up to 40 posts in your niche worth a link, free. Subscribe when you want your assistant running the outreach.

The BacklinkGenie genie The BacklinkGenie genie