SEOLinkMap Private MCP Server and Agentic SEO

Quick Start

Connecting takes one URL and one sign-in. Your MCP URL is on the SEOLinkMap dashboard, top right, and every client below takes that same URL.

Find Your MCP URL

Log into SEOLinkMap, open the Dashboard, and copy the MCP URL from the top right corner. It looks like this:

https://seolinkmap.com/private-mcp/{YOUR-UNIQUE-UUID}

Connect Your Client

The server speaks MCP over HTTP with OAuth, so any client that can add a remote MCP server can add this one. The first call from a new client opens a SEOLinkMap sign-in in your browser.

Claude.ai

Add the server as a connector in Claude.ai:

1. Open Claude.ai Settings
2. Go to Connectors
3. Click "Add custom connector"
4. Paste your SEOLinkMap MCP URL: https://seolinkmap.com/private-mcp/{YOUR_UUID}
5. Complete the SEOLinkMap sign-in

Claude Desktop

Claude Desktop shares connectors with Claude.ai. Add the server under Settings, then Connectors, and it appears in the desktop app on the same account.

Claude Code

Add from the terminal:

claude mcp add --transport http seolinkmap https://seolinkmap.com/private-mcp/{YOUR_UUID}

How To Do SEO With Claude Code walks the full loop -- reading the audit, editing the source, and remeasuring the live page.

Claude API

The Messages API connects to remote MCP servers through the MCP connector. Name the server once in mcp_servers and expose its tools with an mcp_toolset entry:

import anthropic
client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["mcp-client-2025-11-20"],
    mcp_servers=[{
        "type": "url",
        "url": "https://seolinkmap.com/private-mcp/{YOUR_UUID}",
        "name": "seolinkmap",
        "authorization_token": "{OAUTH_ACCESS_TOKEN}"
    }],
    tools=[{
        "type": "mcp_toolset",
        "mcp_server_name": "seolinkmap"
    }],
    messages=[{
        "role": "user",
        "content": "Switch to client-website.com and tell me what to work on next"
    }]
)

The access token comes from completing the SEOLinkMap OAuth flow once from your application.

VS Code with GitHub Copilot

Add to your VS Code MCP configuration:

{
  "mcpServers": {
    "seolinkmap": {
      "type": "http",
      "url": "https://seolinkmap.com/private-mcp/{YOUR_UUID}"
    }
  }
}

Cursor IDE

Configure in Cursor's MCP settings:

{
  "mcpServers": {
    "seolinkmap": {
      "type": "http",
      "url": "https://seolinkmap.com/private-mcp/{YOUR_UUID}",
      "description": "SEOLinkMap statistical SEO analysis"
    }
  }
}

Windsurf IDE

Add to Windsurf MCP configuration:

{
  "mcpServers": {
    "seolinkmap": {
      "type": "http",
      "url": "https://seolinkmap.com/private-mcp/{YOUR_UUID}",
      "name": "SEOLinkMap"
    }
  }
}

Other Clients And Custom Code

Any MCP client library that supports the HTTP transport and OAuth connects to the same URL. There is nothing SEOLinkMap-specific to implement: the client discovers the tools over the standard protocol and your sign-in scopes what they can see.

What The Server Does

It puts every dataset SEOLinkMap holds on a project in front of the agent, and it puts the platform's own prioritised to-do list first. An agent that starts with get_next_actions gets the same ordered answer the dashboard shows, and every other tool drills into one item on that list.

The read side covers the crawl, the audit, internal links, Search Console rankings, Analytics traffic, keyword data, the change log, competitor research statistics, backlink prospects and AI Overview tracking. The write side records what was done to the site and moves outreach through its states, so the work an agent does lands on the client's report.

Paid operations queue rather than run. A crawl, a layout recalculation, a competitor research order, a prospecting order or a new tracked prompt all wait for a human to approve them on the dashboard or hand the agent an approval code. Prices are on the pricing page.

Example Agent Conversations

Complete SEO Audit

Statistical Validation

Content Optimization

Available Tools

The tools come in families, and each family below opens with what it lets an agent do. Read the opening paragraph of each and skip the cards unless you are building an agent and need the parameters.

Where To Start

Three tools frame every session. One returns the prioritised to-do list, one returns the accuracy notice an agent should carry into any SEO advice, and one describes the platform and the account behind the connection.

Projects And Account

Data is scoped per project, and an agency can hold fifty or more, so the agent lists projects and the user picks one before anything else runs. New projects queue for approval like any other paid operation.

Site Audit

The audit is the last scheduled pass over the crawl, grouped by category and issue. The summary shows only issues with findings, and the pages tool lists what each issue touches.

Pages And Links

Page data comes from the stored crawl. The list tool finds pages, the page tool details one, and the two link tools walk the internal link graph in either direction.

Content Analysis

These measure text or a live URL with the same code that measured the pages in the correlation sets, so a draft can be placed beside the ranking pages metric by metric. The URL tool also audits the page live against the scheduled audit's rules, which is how an agent confirms a fix landed.

Rankings, Traffic And Keywords

Rankings come from Google Search Console and traffic from Google Analytics, each connected on the project's settings page. Keyword data draws on both plus the crawl and any competitor research.

The Change Log

The change log is what ranking and traffic movements get explained against. The crawler logs on-page edits it detects between crawls. The agent logs what the crawler cannot see: links won, redirects, schema, sitemap and robots work, a Business Profile change, or the date of a Google update.

Competitor Research

Competitor research measures the pages that rank for one keyword and reports which factors correlate with position on that SERP. The tools return the written action plan, the correlation statistics with their four resource allocation buckets, and the backlink picture. Two tiers exist, standard and premium; the pricing page has what each includes.

Backlink Prospector

The Backlink Prospector reads dozens of SERPs per keyword and returns the sites worth writing to, each with a contact route and a drafted pitch. Its tools cover read, write, order and detailed reports: list orders, work the prospects as a queue, record what came of each outreach, and order more keywords. Sending happens in the user's own mail tool, never here.

AI Visibility

AI Visibility tracks, every day, whether Google shows an AI Overview for a prompt and whether this project is cited in it. Its tools cover write, read and order: list the tracked prompts, read the verdict and the citation rate with its confidence interval, and queue a new prompt, which waits for human approval like every other paid operation.

Crawls And Approvals

A crawl re-fetches the site; a layout recalculation recomputes PageRank and the link map from the pages already crawled at half the credit cost. Both queue with an estimated cost, and both wait for a human. The human approves on the dashboard, or hands the agent an approval code to submit.

Knowledge Base

The SEOLinkMap article corpus is searchable from the same connection, so an agent can cite the documentation for a feature it is using.

Authentication And Permissions

SEOLinkMap is the OAuth provider for its own MCP server. The client sends you to a SEOLinkMap sign-in, and you sign in however you sign in to SEOLinkMap: Google, LinkedIn, GitHub, or a SEOLinkMap username and password. The token the client receives is scoped to your account.

The agent sees only the projects your account can see and only the project it has switched to. It cannot edit your website. Anything that costs credits queues for approval, and the approval is yours, on the dashboard or by handing the agent a code.

Errors

Errors come back as instructions rather than codes. When a call cannot proceed, the response says what blocked it and what to do next in plain language written for the model reading it: no project selected, so list projects and switch first; no ranking data, so connect Search Console on the settings page; an order saved but short of credits, and where credits are bought.

That means an agent rarely needs error handling of its own. It reads the sentence and follows it.

Why SERP-Specific Statistics

Generic SEO advice is a global average, and the SERP you are competing on is a local forecast. The correlation data here is measured on the ten pages ranking for one keyword, with outliers removed and the relationship tested for significance, so it can and does contradict the average from one keyword to the next.

Each factor lands in one of four buckets. CRITICAL is what every ranking page already satisfies. OPPORTUNITY is where the ranking pages vary and the SERP says the factor matters. GAMBLE is a relationship too thin to confirm. AVOID has no measured relationship with rank. SEO Resource Allocation explains how the buckets are derived.

Support

Connection and tool problems go to SEOLinkMap support. Account and billing live on the dashboard, and missing ranking or traffic data is almost always the Google integration on the project's settings page.