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

| 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