io.github.SEODesignLab/seo-tools

@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

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

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