About seo-authority-mcp
seo-authority-mcp is an MCP server for AI agents that need SEO authority, keyword, competitor, content, audit, and internal-link analysis. It uses Common Crawl graph data for authority scores and discloses metric limitations; paid tools can run in challenge-only mode or settle through x402.
Key features
- 01Common Crawl domain authority scoring
- 02Domain authority comparison
- 03On-page SEO checks
- 04Keyword correction and expansion
- 05Keyword and content gap research
- 06Site audits and internal-link suggestions
Use cases
- 01Compare authority across domains
- 02Find keyword opportunities and query variants
- 03Review pages and sites for SEO issues
- 04Identify content gaps and internal links
MCP support
Exposes typed SEO tools to MCP clients, including domain analysis, keyword research, content briefs, audits, and placement vetting. Paid calls return payment and retry details without spending unless automatic x402 settlement is configured.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @forgemeshlabs/seo-authority-mcpSEO_X402_PRIVATE_KEYSecretOptional EVM wallet private key for automatic x402 USDC settlement.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
11Saved tool list · updated 4d ago
This tool takes no parameters.
Details
From the project READMESEO Authority MCP
Give AI agents typed SEO authority, keyword, competitor, content, audit, and internal-link tools backed by seo.forgemesh.io. Authority scores use open Common Crawl graph data. The server does not invent search volume, CPC, live SERP positions, complete backlinks, or Google metrics.
Install
npx -y @forgemeshlabs/seo-authority-mcp
Claude Desktop
Challenge-only mode—safe default, never spends:
{
"mcpServers": {
"seo-authority": {
"command": "npx",
"args": ["-y", "@forgemeshlabs/seo-authority-mcp"]
}
}
}
Automatic x402 settlement:
{
"mcpServers": {
"seo-authority": {
"command": "npx",
"args": ["-y", "@forgemeshlabs/seo-authority-mcp"],
"env": {
"SEO_X402_PRIVATE_KEY": "YOUR_DEDICATED_LOW_BALANCE_WALLET_KEY"
}
}
}
}
Use a dedicated low-balance wallet. Never commit its private key.
Tools
| MCP tool | Purpose | Price |
|---|---|---|
get_seo_capabilities | Source and metric disclosures | Free |
get_domain_authority | Common Crawl graph authority | $0.01 |
compare_domain_authority | Compare 2–20 domains | $0.02 |
score_page_seo | Deterministic on-page checks | $0.01 |
correct_seo_query | Did-you-mean correction | $0.005 |
expand_seo_query | Long-tail query variants | $0.01 |
find_keyword_opportunities | Prioritized keyword ideas | $0.05 |
find_competitor_content_gaps | Supplied-content gap analysis | $0.10 |
create_seo_content_brief | Evidence-tagged brief | $0.10 |
audit_site_seo | Multi-page SEO audit | $0.15 |
find_internal_link_opportunities | Contextual internal links | $0.05 |
vet_placement | Vet a directory, publication or sponsor pitch before paying (domain age, Tranco rank, Google News, link dilution, badge/pay-to-play signals) | $0.05 |
Paid tools use exact USDC settlement on Base. Without SEO_X402_PRIVATE_KEY, each tool returns price, network, receiver, and retry guidance instead of spending.
Docker
docker build -t seo-authority-mcp:0.1.5 .
docker run --rm -i --read-only --cap-drop=ALL seo-authority-mcp:0.1.5
For automatic payment, pass the private key at runtime using your secret manager. Do not bake it into the image.
Environment
| Variable | Required | Default | Purpose |
|---|---|---|---|
SEO_X402_PRIVATE_KEY | No | unset | Enables automatic payment |
X402_MAX_PRICE_USD | No | 0.15 | Per-call payment ceiling; can only LOWER the built-in cap |
X402_SESSION_BUDGET_USD | No | 10 | Cumulative per-process ceiling; can only LOWER the built-in cap |
The backend is fixed to https://seo.forgemesh.io. The server refuses to sign for any payee other than the ForgeMesh SEO wallet, any network other than Base mainnet, any asset other than USDC, or any amount over the cap. Requests are same-origin, time-limited (60s), size-capped (2 MB) and never follow redirects. Tool arguments are validated before any network call. Use a dedicated, low-balance wallet.
Links
- API: https://seo.forgemesh.io
- OpenAPI: https://seo.forgemesh.io/openapi.json
- x402 discovery: https://seo.forgemesh.io/.well-known/x402
- Contact: [email protected]
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.