@seodesignlab/mcp-server

MCP (Model Context Protocol) server for SEODesignLab's x402-protected SEO endpoints.

Expose professional SEO tools — content briefs, keyword research, SERP analysis, backlink profiles, and on-page audits — to any MCP-compatible AI agent (Claude Desktop, Cursor, VS Code Copilot, etc.) with automatic x402 micropayment handling on Base.

Tools

| Tool | Endpoint | Price | Description | |------|----------|-------|-------------| | get_content_brief | /api/briefs/ | $2.00 | Generate a POP content brief with keyword analysis, LSI terms, and content structure | | keyword_research | /api/dataforseo/keywords/ | $1.50 | Search volume, CPC, and competition difficulty for a keyword | | serp_analysis | /api/dataforseo/serp/ | $2.00 | Top 10 organic results with domain metrics and SERP features | | backlink_profile | /api/dataforseo/backlinks/ | $3.00 | Referring domains, link metrics, and anchor text distribution | | on_page_audit | /api/dataforseo/audit/ | $2.50 | Full on-page SEO audit — meta, headings, images, links, speed |

All prices are in USDC on Base and settled via the x402 protocol.

Quick Start

Install

npm install @seodesignlab/mcp-server
# or
npx @seodesignlab/mcp-server

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | SEO_API_BASE | https://seodesignlab-paywall.seodesignlab.workers.dev | Base URL of the SEO API (CF Worker paywall) | | X402_PAY_TO | (none) | Base wallet address for x402 payments. When set, payment headers are attached automatically. | | X402_NETWORK | base | Network for x402 settlement

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "seodesignlab-seo": {
      "command": "npx",
      "args": ["-y", "@seodesignlab/mcp-server"],
      "env": {
        "SEO_API_BASE": "https://seodesignlab-paywall.seodesignlab.workers.dev",
        "X402_PAY_TO": "0xc78e3D02622061961156a18E10bbbF07d8e94529",
        "X402_NETWORK": "base"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json in your project root or global settings):

{
  "mcpServers": {
    "seodesignlab-seo": {
      "command": "npx",
      "args": ["-y", "@seodesignlab/mcp-server"],
      "env": {
        "SEO_API_BASE": "https://seodesignlab-paywall.seodesignlab.workers.dev",
        "X402_PAY_TO": "0xc78e3D02622061961156a18E10bbbF07d8e94529",
        "X402_NETWORK": "base"
      }
    }
  }
}

VS Code (Copilot)

Add to your VS Code MCP settings (.vscode/mcp.json):

{
  "servers": {
    "seodesignlab-seo": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@seodesignlab/mcp-server"],
      "env": {
        "SEO_API_BASE": "https://seodesignlab-paywall.seodesignlab.workers.dev",
        "X402_PAY_TO": "0xc78e3D02622061961156a18E10bbbF07d8e94529",
        "X402_NETWORK": "base"
      }
    }
  }
}

Usage Examples

Once configured, the SEO tools appear automatically in your AI agent. Just ask:

Content Brief

Generate a content brief for "HVAC repair Brooklyn"

→ Calls get_content_brief → Returns POP brief with LSI terms, word count targets, heading structure.

Keyword Research

What's the search volume and CPC for "roofing contractor Tampa"?

→ Calls keyword_research → Returns monthly volume, CPC, competition score.

SERP Analysis

Show me the top 10 results for "dentist near me" in Rockville Centre

→ Calls serp_analysis → Returns top 10 results with domain authority, titles, descriptions.

Backlink Profile

Analyze the backlink profile of seodesignlab.com

→ Calls backlink_profile → Returns referring domains, link counts, domain rating.

On-Page Audit

Audit https://drbrattrvc.com/services/teeth-whitening/

→ Calls on_page_audit → Returns meta analysis, heading structure, image coverage, technical issues.

x402 Payment Flow

AI Agent (Claude, Cursor, etc.)
    │
    ▼
MCP Server (this package)
    │
    ▼  Adds X-Payment-* headers
Cloudflare Worker (x402 paywall)
    │
    ├── Payment valid? ──► YES ──► Proxy to SEO API ──► Return data
    │
    └── No payment? ──► 402 + x402 settlement instructions

When X402_PAY_TO is configured, the MCP server attaches payment headers to every request. The Cloudflare Worker validates the x402 payment and either:

1. Paid → Forwards the request to the SEO backend on Render, returns the result.
2. Unpaid → Returns a 402 Payment Required with the price, wallet address, and settlement instructions.

x402 Client Integration

For production use, pair this MCP server with an x402-compatible client that can automatically settle micropayments. The server is designed to be payment-agnostic — it works with or without an x402 client.

API Endpoints

The MCP server proxies to these backend endpoints at SEO_API_BASE:

POST /api/briefs/

Request:

{
  "keyword": "HVAC repair Brooklyn",
  "location": "United States",
  "language": "en"
}

Response: Full POP content brief with keyword analysis, LSI terms, recommended structure.

POST /api/dataforseo/keywords/

Request:

{
  "keyword": "roofing contractor Tampa",
  "location": "United States",
  "language": "en"
}

Response: Search volume, CPC, competition, related keywords.

POST /api/dataforseo/serp/

Request:

{
  "keyword": "dentist near me",
  "location": "United States",
  "language": "en"
}

Response: Top 10 organic results with titles, URLs, descriptions, and domain metrics.

POST /api/dataforseo/backlinks/

Request:

{
  "domain": "seodesignlab.com"
}

Response: Referring domains, backlinks count, domain rating, anchor distribution.

POST /api/dataforseo/audit/

Request:

{
  "url": "https://drbrattrvc.com/services/teeth-whitening/"
}

Response: Meta title/description analysis, heading structure, image alt coverage, link counts, page speed, content quality, technical issues.

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally (stdio transport)
npm run dev

# Type check
npx tsc --noEmit

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

Publishing

⚠️ Don't publish yet! Wait until the Cloudflare Worker paywall is deployed and live.

When ready:

npm run build
npm publish --access public

License

MIT © SEODesignLab