SEOPro AI MCP
Run the full agency SEO loop from your AI assistant:
Search Console insight → prioritized action → generated article → CMS publishing → indexing → measurable Google and AI-referral results.
SEOPro AI is a hosted remote MCP server for agencies and marketers. The implementation stays on SEOPro AI infrastructure; this repository contains the public connection metadata, setup guides, reusable agency workflows, and security documentation.
Connect
Remote MCP URL
https://api.seoproai.co/api/mcp
No server package or local runtime is required. Interactive clients use OAuth. Developer clients may use a revocable SEOPro AI API key as a bearer token.
Official MCP Registry identifier: io.github.alpha-ai-labs/seo-agent
| Client | Auth | Setup |
|---|
| Claude | OAuth | Settings → Connectors → Add custom connector → paste the URL → Connect |
| ChatGPT | OAuth | Settings → Apps & Connectors → Advanced/Developer mode → Create → paste the URL |
| Codex | OAuth | codex mcp add seopro-ai --url https://api.seoproai.co/api/mcp, then codex mcp login seopro-ai |
| Claude Code | OAuth or API key | claude mcp add --transport http seopro-ai https://api.seoproai.co/api/mcp |
| Hermes | API key | Add the URL and environment-backed bearer header in ~/.hermes/config.yaml |
| OpenClaw | OAuth or API key | Add a Streamable HTTP entry under mcp.servers; prefer OAuth or keep a static key in an environment variable |
| Cursor / Windsurf | OAuth or API key | Add a remote Streamable HTTP server in MCP settings |
See client setup for copy-paste configurations and current caveats.
Three agency workflows
1. Find client quick wins
Using SEOPro AI, list my websites. For [client site], review the last 28 days of
Search Console performance. Find queries ranking 5–15 with meaningful
impressions, group them by page, and give me a prioritized action plan. Do not
make any changes.
2. Build and generate a content plan
Using SEOPro AI, review [client site]'s search performance and current keyword
plan. Propose a four-week content plan around [service/topic]. Show me the plan
before creating it. After I approve it, create the keyword plan and generate
only the first article.
3. Review, publish, index, and measure
Using SEOPro AI, show me the draft for [article]. Check its title, meta
description, structure, and relevance to the target keyword. Do not publish
until I explicitly approve the final draft. After approval, publish it, submit
the published URL for indexing, and give me a 30-day measurement checklist.
The complete prompt pack is in agency prompt pack.
Demo and example data
The Search Console image is an example connected performance view. Results vary by website.
What the server exposes
The server provides 18 narrowly scoped tools across:
- Websites and account context.
- Search Console summaries, keywords, trends, and AI-referral traffic.
- Technical audits, AI citations, and backlink profiles.
- Keyword/content planning and asynchronous article generation.
- Draft review and explicit-confirmation CMS publishing.
- Explicit-confirmation indexing requests and indexing status.
Read tools are annotated as read-only and non-destructive. Publishing and indexing are annotated as externally consequential and require an explicit confirmation argument on every call.
Privacy and security
- Authentication is required for every MCP request.
- OAuth and API-key access can be revoked.
- Website ownership and subscription limits are enforced by the same backend routes used by the SEOPro AI dashboard.
- Analytics records operational metadata such as tool name, success, latency band, auth method, and normalized client family. It never records credentials, tool arguments, article content, website content, or returned customer data.
- The public repository contains no hosted-server source code or credentials.
Read SECURITY.md, architecture and data handling, and the SEOPro AI Privacy Policy.
Requirements
- An SEOPro AI account. The current acquisition offer is a $1 seven-day trial.
- Connected websites and, for search-performance workflows, Google Search Console.
- A supported CMS connection for publishing workflows.
Start at seoproai.co/mcp.
Repository map
server.json — Official MCP Registry metadata for the hosted endpoint.docs/client-setup.md — Client-specific setup.docs/agency-prompt-pack.md — Safe, reusable agency prompts.docs/compatibility.md — Tested client/auth matrix.docs/troubleshooting.md — Connection and tool-call diagnostics.docs/architecture-and-data-handling.md — Trust boundary and analytics disclosure.docs/directory-listing-copy.md — Canonical short and long listing descriptions.docs/90-second-demo-script.md — Timed narration, capture plan, and privacy checklist.docs/example-tool-results.md — Fictional sample data for screenshots and reviews.assets/ — Public workflow and product-proof visuals.skills/seo-agency-operator/ — Portable Agent Skill for compatible clients and ClawHub.
Support
Email support@seoproai.co or open a GitHub issue without including credentials or customer data. Service availability: seoproai.co.
License
Documentation and repository assets are licensed under MIT. The hosted SEOPro AI service and its implementation remain proprietary and are governed by the Terms.