SEOLinkMap Private MCP Server and Agentic SEO

Statistical SEO intelligence for AI agents. Access correlation coefficients, p-values, and SERP-specific analysis through natural language.

⚠️ Important: This MCP server provides statistical analysis and SEO recommendations. Always validate findings with your own testing and business context. The MCP data is computed and trusted, but the LLM accessing it may change the meaning through explanation.

Quick Start

Prerequisites:

Active SEOLinkMap account
Your unique MCP URL (found in dashboard, top right)
MCP-compatible client (see integrations below)

Find Your MCP URL

Log into SEOLinkMap → Dashboard → Look for your unique MCP URL in the top right corner. It will look like:

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

All Supported Integrations

Claude.ai (Web Interface)

Add as a remote MCP server in Claude.ai:

Go to Claude.ai Settings
Navigate to Integrations
Click "Add Integration"
Enter your SEOLinkMap MCP URL: https://seolinkmap.com/private-mcp/{YOUR_UUID}
Complete OAuth authentication

Claude API Integration

Use Claude API with MCP server via HTTP requests:

// Example using Claude API with MCP
const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "your-claude-api-key"
  },
  body: JSON.stringify({
    model: "claude-3-sonnet-20240229",
    max_tokens: 1000,
    messages: [{
      role: "user", 
      content: "Use the SEOLinkMap MCP server to analyze my website"
    }],
    tools: [{
      type: "mcp_server",
      mcp_server: {
        url: "https://seolinkmap.com/private-mcp/{YOUR_UUID}",
        name: "seolinkmap"
      }
    }]
  })
});

OpenAI GPT API Integration

Connect via MCP-to-OpenAI bridge or custom integration:

// Example OpenAI integration with MCP server
import { OpenAI } from 'openai';

const openai = new OpenAI({
  apiKey: 'your-openai-api-key'
});

// Custom function calling that bridges to your MCP server
const response = await openai.chat.completions.create({
  model: "gpt-4",
  messages: [{
    role: "user",
    content: "Analyze my SEO data using SEOLinkMap"
  }],
  functions: [
    {
      name: "seolinkmap_analysis",
      description: "Access SEOLinkMap SEO data and analysis",
      parameters: {
        type: "object",
        properties: {
          action: { type: "string" },
          project: { type: "string" }
        }
      }
    }
  ]
});

VS Code with GitHub Copilot

Add to your VS Code MCP configuration:

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

Claude Desktop App

Add to Claude Desktop configuration file:

{
  "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"
    }
  }
}

JetBrains IDEs (IntelliJ, WebStorm, etc.)

Install MCP plugin and configure:

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

Continue.dev (VS Code Extension)

Add to Continue configuration:

{
  "mcpServers": [
    {
      "name": "seolinkmap",
      "url": "https://seolinkmap.com/private-mcp/{YOUR_UUID}",
      "description": "SEOLinkMap MCP Server"
    }
  ]
}

Custom Applications & APIs

For custom applications that need to integrate with your MCP server, you'll need to implement the MCP protocol. The MCP server endpoint is:

https://seolinkmap.com/private-mcp/{YOUR_UUID}

Your custom application will need to:

Implement the MCP client protocol
Handle OAuth authentication with SEOLinkMap
Use MCP standard messages for tool discovery and calling
Follow the Model Context Protocol specification

Example MCP libraries for custom integration:

// Python
from mcp import Client

# JavaScript/TypeScript  
import { Client } from "@modelcontextprotocol/sdk/client/index.js"

// Connect to your MCP server
const client = new Client({
  url: "https://seolinkmap.com/private-mcp/{YOUR_UUID}",
  transport: "http"
});

Protocol Support: Your SEOLinkMap MCP server supports HTTP transport, making it compatible with any client that can make HTTP requests and handle OAuth authentication.

What This MCP Server Does

Transform hours of SEO analysis into seconds of conversational AI queries:

Statistical SEO Analysis: Get correlation coefficients and p-values for 65+ ranking factors
Multi-Project Management: Switch between client websites conversationally
Real-time Content Analysis: Optimize any text with statistical targets
SERP Intelligence: Access research showing what actually works for specific keywords
Performance Tracking: Query Google Search Console and Analytics data naturally

Example Agent Conversations

Complete SEO Audit

You: "Switch to client-website.com, analyze the homepage, and show me the top 3 technical issues"

Agent Response: Switches project, analyzes technical metrics, and provides prioritized recommendations with statistical backing from SERP research.

Statistical Validation

You: "What does my competitor research say about title tag optimization for 'SEO tools'?"

Agent Response: "Based on your research: Title length shows r=-0.34, p=0.02, suggesting shorter titles (45-55 chars) correlate with better rankings for this keyword."

Content Optimization

You: "Analyze this article title and compare it to statistical targets: 'Complete SEO Tools Analysis Guide'"

Agent Response: Provides readability scores, keyword density, and optimization recommendations based on your SERP research data.

Available Tools

When chatting, the LLM will handle specific details on tool usage. When building an agentic system, you may need to know what to expect for input and output.

Project Management

list_projects

View all your SEO projects/websites

Parameters: None
Use Case: "Show me all my client websites"

switch_project

Change active project context for subsequent queries

Required: identifier (project name, domain, or ID)
Use Case: "Switch to client-website.com"

Page Analysis

list_pages

List all pages with basic SEO metrics

Optional: limit (max 100), offset (pagination)
Use Case: "Show me all pages on this site"

get_page

Detailed analysis of specific page

Required: identifier (page ID, URL pattern, or title)
Use Case: "Analyze the homepage"

analyze_text_content

Real-time SEO analysis of any text

Required: content (text to analyze)
Optional: target_keyword, include_ngrams
Use Case: "Analyze this article for SEO factors"

analyze_url_content

Analyze live webpage (active project domain only)

Required: url (from active project)
Use Case: "Analyze https://client.com/new-page"

Link Analysis

get_links_in

Find all internal links pointing to specific page

Required: page_id
Use Case: "What pages link to my homepage?"

get_links_out

Find all internal links from specific page

Required: page_id
Use Case: "What does this page link to?"

Performance Data

get_ranking_data

Google Search Console rankings and click data

Optional: page_id, days (max 90), limit, aggregated
Requirements: Google Search Console integration
Use Case: "How are my rankings trending?"

get_traffic_data

Google Analytics traffic and user behavior

Optional: page_id, days (max 90)
Requirements: Google Analytics integration
Use Case: "Which pages get most traffic?"

Statistical Analysis

get_serp_correlations

Statistical correlation data with rigorous methodology

Requirements: Competitor Research purchase
Optional: research_id, keyword, metric_name
Returns: Correlation coefficients, p-values, confidence intervals
Use Case: "What factors correlate with rankings for keyword X?"

get_competitor_research_action_plan

AI-generated optimization strategies from research

Required: research_id
Use Case: "Show optimization recommendations for my keyword research"

list_competitor_researches

View available competitor research projects

Use Case: "What competitor research do I have available?"

Keyword Intelligence

get_keyword_data

Keyword performance and associations

Optional: page_id
Use Case: "What keywords does this page rank for?"

get_backlink_data

Comprehensive backlink analysis

Optional: page_id, limit (max 500), include_guidance
Use Case: "Find link building opportunities"

Operations

queue_crawl

Request updated site analysis

Optional: notes (for approval)
Note: May require credits
Use Case: "Update my site analysis"

queue_competitor_research

Order new competitor research

Required: keywords (array), tier ("basic" $30/keyword or "advanced" $50/keyword)
Use Case: "Research competitors for these 5 keywords"

create_new_project

Add new website/project to your account

Required: website (URL), name (project name)
Optional: notes (for approval)
Use Case: "Add new-client.com as a project"

approval_code

Submit approval code for queued operations

Required: code (approval code from user)
Use Case: Complete paid operations after user approval

account_info

Check credits and usage status

Use Case: "How many credits do I have?"

Authentication & Security

OAuth Flow

Provider: SEOLinkMap (with Google, LinkedIn, GitHub options)
Flow: Standard OAuth 2.0 authorization code flow
Scopes: Read access to your SEOLinkMap projects and data

Data Access & Permissions

User-controlled: Only access your own SEOLinkMap projects
Project-scoped: You control which projects MCP can access
Website content: Cannot modify your actual website content or files
SEOLinkMap operations: Can queue crawls, research, and analysis within your account
No cross-user data: Cannot access other users' information

Rate Limits

Credit-based system: Expensive operations consume credits
Queue system: Analysis requests processed in order
Fair usage: Designed for conversational AI patterns

Data Requirements

For Full Functionality:

Ranking Data: Requires Google Search Console integration
Traffic Data: Requires Google Analytics integration
Statistical Analysis: Requires Competitor Research purchase ($30-50/keyword)
URL Analysis: Limited to pages within active project domain

Error Handling

Common Errors & Solutions

AUTHENTICATION_FAILED

Invalid or expired OAuth token

Solution: Re-authenticate with SEOLinkMap

PROJECT_NOT_FOUND

Project not accessible or doesn't exist

Solution: Use list_projects to see available projects

INTEGRATION_REQUIRED

No ranking/traffic data available

Solution: Integrate Google Search Console or Google Analytics

INSUFFICIENT_CREDITS

Not enough credits for operation

Solution: Purchase credits or upgrade subscription

Key Differentiators

Statistical Rigor

Unlike generic SEO tools, SEOLinkMap provides:

Correlation coefficients with confidence intervals
P-values for statistical significance testing
Tukey's outlier removal for data quality assurance
Cook's Distance for correlation validation testing
Coefficient of Variation analysis
Optimal/observed range of SERP values
Sample methodology: n=10 (typical first page analysis), n=20 when outliers removed
Linear regression slope showing impact on positioning
Behavioral analysis of reported statistical data
SEO Resource Allocation buckets: CRITICAL, OPPORTUNITY, AVOID, and GAMBLE classifications
SERP-specific analysis showing contradictory findings across keywords
Academic methodology with proper hypothesis testing

Conversational Intelligence

Transform hours of manual analysis into seconds of natural language queries:

"What technical factors correlate with rankings?" → Receive r=-0.91, p=0.13, 95% CI [-0.99, 0.42]
"Show optimization targets" → Get specific metrics like "LCP under 8.5 seconds"
"Which pages need better internal linking?" → PageRank-based recommendations

Professional SEO Intelligence: Access statistical analysis worth hundreds monthly through simple conversational commands, backed by mathematical proof that debunks generic SEO advice.

Support

For technical issues or questions:

MCP Server Issues: Contact SEOLinkMap support
Account & Billing: Use SEOLinkMap dashboard
Data Integration: Check Google Search Console/Analytics connections
Research Purchases: Use queue_competitor_research tool with approval codes