{
  "markdown": "# @seodesignlab/mcp-server\n\nMCP (Model Context Protocol) server for **SEODesignLab's x402-protected SEO endpoints**.\n\nExpose 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.\n\n---\n\n## Tools\n\n| Tool | Endpoint | Price | Description |\n|------|----------|-------|-------------|\n| `get_content_brief` | `/api/briefs/` | $2.00 | Generate a POP content brief with keyword analysis, LSI terms, and content structure |\n| `keyword_research` | `/api/dataforseo/keywords/` | $1.50 | Search volume, CPC, and competition difficulty for a keyword |\n| `serp_analysis` | `/api/dataforseo/serp/` | $2.00 | Top 10 organic results with domain metrics and SERP features |\n| `backlink_profile` | `/api/dataforseo/backlinks/` | $3.00 | Referring domains, link metrics, and anchor text distribution |\n| `on_page_audit` | `/api/dataforseo/audit/` | $2.50 | Full on-page SEO audit — meta, headings, images, links, speed |\n\nAll prices are in **USDC on Base** and settled via the [x402 protocol](https://x402.org).\n\n---\n\n## Quick Start\n\n### Install\n\n```bash\nnpm install @seodesignlab/mcp-server\n# or\nnpx @seodesignlab/mcp-server\n```\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `SEO_API_BASE` | `https://seodesignlab-paywall.seodesignlab.workers.dev` | Base URL of the SEO API (CF Worker paywall) |\n| `X402_PAY_TO` | *(none)* | Base wallet address for x402 payments. When set, payment headers are attached automatically. |\n| `X402_NETWORK` | `base` | Network for x402 settlement\n\n---\n\n## Configuration\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"seodesignlab-seo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@seodesignlab/mcp-server\"],\n      \"env\": {\n        \"SEO_API_BASE\": \"https://seodesignlab-paywall.seodesignlab.workers.dev\",\n        \"X402_PAY_TO\": \"0xc78e3D02622061961156a18E10bbbF07d8e94529\",\n        \"X402_NETWORK\": \"base\"\n      }\n    }\n  }\n}\n```\n\n**Config file locations:**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Cursor\n\nAdd to your Cursor MCP settings (`.cursor/mcp.json` in your project root or global settings):\n\n```json\n{\n  \"mcpServers\": {\n    \"seodesignlab-seo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@seodesignlab/mcp-server\"],\n      \"env\": {\n        \"SEO_API_BASE\": \"https://seodesignlab-paywall.seodesignlab.workers.dev\",\n        \"X402_PAY_TO\": \"0xc78e3D02622061961156a18E10bbbF07d8e94529\",\n        \"X402_NETWORK\": \"base\"\n      }\n    }\n  }\n}\n```\n\n### VS Code (Copilot)\n\nAdd to your VS Code MCP settings (`.vscode/mcp.json`):\n\n```json\n{\n  \"servers\": {\n    \"seodesignlab-seo\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@seodesignlab/mcp-server\"],\n      \"env\": {\n        \"SEO_API_BASE\": \"https://seodesignlab-paywall.seodesignlab.workers.dev\",\n        \"X402_PAY_TO\": \"0xc78e3D02622061961156a18E10bbbF07d8e94529\",\n        \"X402_NETWORK\": \"base\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Usage Examples\n\nOnce configured, the SEO tools appear automatically in your AI agent. Just ask:\n\n### Content Brief\n\n```\nGenerate a content brief for \"HVAC repair Brooklyn\"\n```\n\n→ Calls `get_content_brief` → Returns POP brief with LSI terms, word count targets, heading structure.\n\n### Keyword Research\n\n```\nWhat's the search volume and CPC for \"roofing contractor Tampa\"?\n```\n\n→ Calls `keyword_research` → Returns monthly volume, CPC, competition score.\n\n### SERP Analysis\n\n```\nShow me the top 10 results for \"dentist near me\" in Rockville Centre\n```\n\n→ Calls `serp_analysis` → Returns top 10 results with domain authority, titles, descriptions.\n\n### Backlink Profile\n\n```\nAnalyze the backlink profile of seodesignlab.com\n```\n\n→ Calls `backlink_profile` → Returns referring domains, link counts, domain rating.\n\n### On-Page Audit\n\n```\nAudit https://drbrattrvc.com/services/teeth-whitening/\n```\n\n→ Calls `on_page_audit` → Returns meta analysis, heading structure, image coverage, technical issues.\n\n---\n\n## x402 Payment Flow\n\n```\nAI Agent (Claude, Cursor, etc.)\n    │\n    ▼\nMCP Server (this package)\n    │\n    ▼  Adds X-Payment-* headers\nCloudflare Worker (x402 paywall)\n    │\n    ├── Payment valid? ──► YES ──► Proxy to SEO API ──► Return data\n    │\n    └── No payment? ──► 402 + x402 settlement instructions\n```\n\nWhen `X402_PAY_TO` is configured, the MCP server attaches payment headers to every request. The Cloudflare Worker validates the x402 payment and either:\n\n1. **Paid** → Forwards the request to the SEO backend on Render, returns the result.\n2. **Unpaid** → Returns a `402 Payment Required` with the price, wallet address, and settlement instructions.\n\n### x402 Client Integration\n\nFor production use, pair this MCP server with an [x402-compatible client](https://github.com/coinbase/x402) that can automatically settle micropayments. The server is designed to be payment-agnostic — it works with or without an x402 client.\n\n---\n\n## API Endpoints\n\nThe MCP server proxies to these backend endpoints at `SEO_API_BASE`:\n\n### POST /api/briefs/\n\n**Request:**\n```json\n{\n  \"keyword\": \"HVAC repair Brooklyn\",\n  \"location\": \"United States\",\n  \"language\": \"en\"\n}\n```\n\n**Response:** Full POP content brief with keyword analysis, LSI terms, recommended structure.\n\n### POST /api/dataforseo/keywords/\n\n**Request:**\n```json\n{\n  \"keyword\": \"roofing contractor Tampa\",\n  \"location\": \"United States\",\n  \"language\": \"en\"\n}\n```\n\n**Response:** Search volume, CPC, competition, related keywords.\n\n### POST /api/dataforseo/serp/\n\n**Request:**\n```json\n{\n  \"keyword\": \"dentist near me\",\n  \"location\": \"United States\",\n  \"language\": \"en\"\n}\n```\n\n**Response:** Top 10 organic results with titles, URLs, descriptions, and domain metrics.\n\n### POST /api/dataforseo/backlinks/\n\n**Request:**\n```json\n{\n  \"domain\": \"seodesignlab.com\"\n}\n```\n\n**Response:** Referring domains, backlinks count, domain rating, anchor distribution.\n\n### POST /api/dataforseo/audit/\n\n**Request:**\n```json\n{\n  \"url\": \"https://drbrattrvc.com/services/teeth-whitening/\"\n}\n```\n\n**Response:** Meta title/description analysis, heading structure, image alt coverage, link counts, page speed, content quality, technical issues.\n\n---\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run locally (stdio transport)\nnpm run dev\n\n# Type check\nnpx tsc --noEmit\n```\n\n### Testing with MCP Inspector\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n---\n\n## Publishing\n\n> ⚠️ **Don't publish yet!** Wait until the Cloudflare Worker paywall is deployed and live.\n\nWhen ready:\n\n```bash\nnpm run build\nnpm publish --access public\n```\n\n---\n\n## License\n\nMIT © SEODesignLab",
  "bytes": 6873,
  "sha": "94d76209f2a42cbe18d7608a872302dbdf134b8bde7790e4a3693b7db1de1d92",
  "repo_slug": "seodesignlab/seo-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_seodesignlab_seo_tools_a1024ff0/readme"
}