@forgemeshlabs/seo-authority-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0 - 2026-08-14
+
+- Initial MCP release with ten paid SEO tools and one free capabilities tool.
+- Added optional automatic x402 USDC settlement on Base.
+- Added Docker, Glama, Smithery, and official MCP registry metadata.

package/GLAMA.md

@@ -0,0 +1,44 @@
+# SEO Authority MCP for Glama
+
+Canonical MCP server: `seo-authority-mcp`
+
+Use this repository's Dockerfile in the Glama Dockerfile admin page:
+
+```text
+https://glama.ai/mcp/servers/forgemeshlabs/seo-authority-mcp/admin/dockerfile
+```
+
+Build steps:
+
+```json
+["npm ci", "npm run build", "npm prune --omit=dev"]
+```
+
+Command arguments:
+
+```json
+["node", "dist/index.js"]
+```
+
+Environment schema:
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "SEO_API_BASE": { "type": "string", "default": "https://seo.forgemesh.io" },
+    "SEO_X402_PRIVATE_KEY": { "type": "string", "description": "Optional secret EVM private key for automatic payment." },
+    "SEO_MAX_PAYMENT_USDC": { "type": "string", "default": "0.15" }
+  },
+  "required": []
+}
+```
+
+Runtime notes:
+
+- Transport: stdio; no inbound port.
+- Node.js 22 or newer.
+- Without a private key, paid tools return structured x402 challenge metadata and spend nothing.
+- With a private key, the MCP settles exact USDC payments on Base and requires a non-empty transaction hash.
+- The default backend allowlist contains only `seo.forgemesh.io`.
+- `SEO_MAX_PAYMENT_USDC` limits each automatic settlement; default `0.15` covers every current tool.

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 ForgeMesh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

package/README.md

@@ -0,0 +1,93 @@
+# SEO Authority MCP
+
+[![MCP Server](https://glama.ai/mcp/servers/forgemeshlabs/seo-authority-mcp/badges/card.svg)](https://glama.ai/mcp/servers/forgemeshlabs/seo-authority-mcp)
+
+Give AI agents typed SEO authority, keyword, competitor, content, audit, and internal-link tools backed by [seo.forgemesh.io](https://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
+
+```bash
+npx -y @forgemeshlabs/seo-authority-mcp
+```
+
+## Claude Desktop
+
+Challenge-only mode—safe default, never spends:
+
+```json
+{
+  "mcpServers": {
+    "seo-authority": {
+      "command": "npx",
+      "args": ["-y", "@forgemeshlabs/seo-authority-mcp"]
+    }
+  }
+}
+```
+
+Automatic x402 settlement:
+
+```json
+{
+  "mcpServers": {
+    "seo-authority": {
+      "command": "npx",
+      "args": ["-y", "@forgemeshlabs/seo-authority-mcp"],
+      "env": {
+        "SEO_X402_PRIVATE_KEY": "YOUR_DEDICATED_LOW_BALANCE_WALLET_KEY",
+        "SEO_MAX_PAYMENT_USDC": "0.15"
+      }
+    }
+  }
+}
+```
+
+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 |
+
+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
+
+```bash
+docker build -t seo-authority-mcp:0.1.0 .
+docker run --rm -i --read-only --cap-drop=ALL seo-authority-mcp:0.1.0
+```
+
+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 |
+| `SEO_MAX_PAYMENT_USDC` | No | `0.15` | Per-call payment ceiling |
+| `SEO_API_BASE` | No | `https://seo.forgemesh.io` | Backend URL |
+| `SEO_ALLOW_CUSTOM_API_BASE` | No | `false` | Explicitly allows a custom HTTPS backend |
+| `SEO_REQUEST_TIMEOUT_MS` | No | `30000` | Upstream timeout, capped at 120 seconds |
+
+## Links
+
+- API: https://seo.forgemesh.io
+- OpenAPI: https://seo.forgemesh.io/openapi.json
+- x402 discovery: https://seo.forgemesh.io/.well-known/x402
+- Contact: clawdbotworker@gmail.com
+
+## License
+
+MIT

package/SECURITY.md

@@ -0,0 +1,13 @@
+# Security Policy
+
+## Supported versions
+
+Security fixes are provided for the latest published release.
+
+## Reporting
+
+Report vulnerabilities privately to clawdbotworker@gmail.com. Do not include wallet private keys, payment signatures, or other credentials in reports.
+
+## Wallet safety
+
+Use a dedicated low-balance wallet. Keep `SEO_X402_PRIVATE_KEY` in the MCP client's secret environment configuration, never in source control. Automatic payments are capped per call by `SEO_MAX_PAYMENT_USDC`.

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+type Args = Record<string, unknown>;
+type RequestSpec = {
+    path: string;
+    method?: "GET" | "POST";
+    body?: Args;
+};
+export declare function requestForTool(name: string, args: Args): RequestSpec;
+export declare function callSeoTool(name: string, args: Args): Promise<unknown>;
+export {};

package/dist/client.js

@@ -0,0 +1,101 @@
+import { x402Client, x402HTTPClient } from "@x402/core/client";
+import { ExactEvmScheme } from "@x402/evm/exact/client";
+import { toClientEvmSigner } from "@x402/evm";
+import { privateKeyToAccount } from "viem/accounts";
+const configuredBase = (process.env.SEO_API_BASE || "https://seo.forgemesh.io").replace(/\/+$/, "");
+const parsedBase = new URL(configuredBase);
+if (parsedBase.protocol !== "https:")
+    throw new Error("SEO_API_BASE must use HTTPS");
+if (parsedBase.hostname !== "seo.forgemesh.io" && process.env.SEO_ALLOW_CUSTOM_API_BASE !== "true") {
+    throw new Error("Custom SEO_API_BASE requires SEO_ALLOW_CUSTOM_API_BASE=true");
+}
+const API_BASE = parsedBase.toString().replace(/\/$/, "");
+const timeoutMs = Math.max(1_000, Math.min(120_000, Number(process.env.SEO_REQUEST_TIMEOUT_MS || 30_000)));
+const maxAtomic = BigInt(Math.round(Number(process.env.SEO_MAX_PAYMENT_USDC || "0.15") * 1_000_000));
+function encodeQuery(path, params) {
+    const url = new URL(path, `${API_BASE}/`);
+    for (const [key, value] of Object.entries(params))
+        url.searchParams.set(key, value);
+    return `${url.pathname}${url.search}`;
+}
+export function requestForTool(name, args) {
+    switch (name) {
+        case "get_seo_capabilities": return { path: "/capabilities" };
+        case "get_domain_authority": return { path: encodeQuery("/v1/domain-authority", { domain: String(args.domain) }) };
+        case "compare_domain_authority": return { path: "/v1/authority-compare", method: "POST", body: { domains: args.domains } };
+        case "score_page_seo": return { path: "/v1/url-seo-score", method: "POST", body: { url: args.url, html: args.html } };
+        case "correct_seo_query": return { path: encodeQuery("/v1/query-correct", { q: String(args.query) }) };
+        case "expand_seo_query": return { path: encodeQuery("/v1/query-expand", { q: String(args.query) }) };
+        case "find_keyword_opportunities": return { path: "/v1/keyword-opportunity", method: "POST", body: args };
+        case "find_competitor_content_gaps": return { path: "/v1/competitor-gap", method: "POST", body: args };
+        case "create_seo_content_brief": return { path: "/v1/content-brief", method: "POST", body: args };
+        case "audit_site_seo": return { path: "/v1/site-audit", method: "POST", body: args };
+        case "find_internal_link_opportunities": return { path: "/v1/internal-link-opportunities", method: "POST", body: args };
+        default: throw new Error(`Unknown tool: ${name}`);
+    }
+}
+function parseChallenge(response, body) {
+    const raw = response.headers.get("payment-required");
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(Buffer.from(raw, "base64").toString("utf8"));
+    }
+    catch {
+        return body;
+    }
+}
+function safeChallenge(challenge) {
+    const accept = challenge?.accepts?.[0] || {};
+    const amount = String(accept.amount || "0");
+    return { payment_required: true, amount_usdc: /^\d+$/.test(amount) ? Number(amount) / 1_000_000 : null, network: accept.network || null, pay_to: accept.payTo || null, scheme: accept.scheme || null, resource: challenge?.resource?.url || null, next_step: "Set SEO_X402_PRIVATE_KEY to let this MCP settle automatically, or pay the challenge with another x402 client." };
+}
+function findTx(value) {
+    if (typeof value === "string" && /^0x[a-fA-F0-9]{64}$/.test(value))
+        return value;
+    if (!value || typeof value !== "object")
+        return null;
+    for (const item of Object.values(value)) {
+        const found = findTx(item);
+        if (found)
+            return found;
+    }
+    return null;
+}
+function init(spec, extraHeaders = {}) {
+    return { method: spec.method || "GET", headers: { accept: "application/json", ...extraHeaders, ...(spec.body ? { "content-type": "application/json" } : {}) }, ...(spec.body ? { body: JSON.stringify(spec.body) } : {}), signal: AbortSignal.timeout(timeoutMs) };
+}
+export async function callSeoTool(name, args) {
+    const spec = requestForTool(name, args);
+    const url = `${API_BASE}${spec.path}`;
+    const challengeResponse = await fetch(url, init(spec));
+    const challengeBody = await challengeResponse.clone().json().catch(() => null);
+    if (challengeResponse.status !== 402) {
+        if (!challengeResponse.ok)
+            throw new Error(`SEO API ${challengeResponse.status}: ${JSON.stringify(challengeBody).slice(0, 300)}`);
+        return challengeBody;
+    }
+    const challenge = parseChallenge(challengeResponse, challengeBody);
+    const privateKey = process.env.SEO_X402_PRIVATE_KEY;
+    if (!privateKey)
+        return safeChallenge(challenge);
+    if (!/^0x[a-fA-F0-9]{64}$/.test(privateKey))
+        throw new Error("SEO_X402_PRIVATE_KEY must be a 32-byte hex private key");
+    const amount = BigInt(challenge?.accepts?.[0]?.amount || 0);
+    if (amount <= 0n || amount > maxAtomic)
+        throw new Error(`Payment exceeds SEO_MAX_PAYMENT_USDC (${Number(maxAtomic) / 1_000_000})`);
+    const account = privateKeyToAccount(privateKey);
+    const httpClient = new x402HTTPClient(new x402Client().register("eip155:*", new ExactEvmScheme(toClientEvmSigner(account))));
+    const required = httpClient.getPaymentRequiredResponse(header => challengeResponse.headers.get(header), challengeBody);
+    const payload = await httpClient.createPaymentPayload(required);
+    const paid = await fetch(url, init(spec, httpClient.encodePaymentSignatureHeader(payload)));
+    const paidBody = await paid.json().catch(() => null);
+    if (!paid.ok)
+        throw new Error(`Paid SEO API ${paid.status}: ${JSON.stringify(paidBody).slice(0, 300)}`);
+    const receipt = httpClient.getPaymentSettleResponse(header => paid.headers.get(header));
+    const transaction = findTx(receipt);
+    if (!transaction)
+        throw new Error("Facilitator returned no settlement transaction hash");
+    return { ...paidBody, x402_settlement: { amount_usdc: Number(amount) / 1_000_000, network: challenge?.accepts?.[0]?.network, transaction } };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { callSeoTool } from "./client.js";
+import { tools } from "./tools.js";
+const server = new Server({ name: "seo-authority-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const data = await callSeoTool(request.params.name, (request.params.arguments || {}));
+        return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return { content: [{ type: "text", text: JSON.stringify({ error: { code: "SEO_TOOL_ERROR", message } }) }], isError: true };
+    }
+});
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC5G,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC1E,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE;IAC9D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAC,CAAC;QACjH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9H,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const tools: Tool[];
+export declare const paidToolNames: Set<string>;

package/dist/tools.js

@@ -0,0 +1,55 @@
+const readOnly = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+const string = (description) => ({ type: "string", description });
+const page = {
+    type: "object",
+    properties: { url: string("Absolute page URL."), title: string("Page title."), text: string("Visible page text."), html: string("Page HTML, when required.") },
+    required: ["url"]
+};
+export const tools = [
+    { name: "get_seo_capabilities", description: "Retrieve free capability, provenance, and unavailable-metric disclosures before choosing a paid SEO tool.", annotations: readOnly, inputSchema: { type: "object", properties: {} } },
+    { name: "get_domain_authority", description: "Measure one domain's open-web SEO authority using Common Crawl harmonic centrality and PageRank graph data; costs $0.01 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { domain: string("Domain or URL to measure, such as example.com.") }, required: ["domain"] } },
+    { name: "compare_domain_authority", description: "Compare open-web SEO authority for 2 to 20 domains and rank the results; costs $0.02 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { domains: { type: "array", description: "Two to twenty domains or URLs.", minItems: 2, maxItems: 20, items: { type: "string" } } }, required: ["domains"] } },
+    { name: "score_page_seo", description: "Score supplied page HTML for deterministic on-page SEO checks without claiming page authority; costs $0.01 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { url: string("Canonical URL for the supplied page."), html: string("Complete page HTML, up to 512 KB.") }, required: ["url", "html"] } },
+    { name: "correct_seo_query", description: "Correct likely spelling errors in an SEO search query; costs $0.005 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { query: string("SEO query to correct.") }, required: ["query"] } },
+    { name: "expand_seo_query", description: "Generate deterministic long-tail and intent-oriented variants of an SEO query; costs $0.01 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { query: string("Seed SEO query to expand.") }, required: ["query"] } },
+    { name: "find_keyword_opportunities", description: "Generate and prioritize long-tail keyword opportunities without fabricating volume, CPC, SERP, or difficulty metrics; costs $0.05 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { seed: string("Seed topic or keyword."), audience: string("Optional target audience."), domain_authority_score: { type: "number", minimum: 0, maximum: 100, description: "Optional known authority score used for prioritization." } }, required: ["seed"] } },
+    {
+        name: "find_competitor_content_gaps",
+        description: "Find content gaps from customer-supplied site and competitor pages without claiming live SERP verification; costs $0.10 USDC.",
+        annotations: readOnly,
+        inputSchema: {
+            type: "object",
+            properties: {
+                site: {
+                    type: "object",
+                    description: "Your domain and supplied pages.",
+                    properties: {
+                        domain: string("Your domain."),
+                        pages: { type: "array", minItems: 1, maxItems: 50, items: page }
+                    },
+                    required: ["domain", "pages"]
+                },
+                competitors: {
+                    type: "array",
+                    description: "One to ten competitors with supplied pages.",
+                    minItems: 1,
+                    maxItems: 10,
+                    items: {
+                        type: "object",
+                        properties: {
+                            domain: string("Competitor domain."),
+                            pages: { type: "array", minItems: 1, maxItems: 50, items: page }
+                        },
+                        required: ["domain", "pages"]
+                    }
+                }
+            },
+            required: ["site", "competitors"]
+        }
+    },
+    { name: "create_seo_content_brief", description: "Create an evidence-tagged SEO content brief from a keyword and supplied competitor or site pages; costs $0.10 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { keyword: string("Primary keyword or topic."), competitor_pages: { type: "array", maxItems: 50, items: page, description: "Optional competitor pages providing evidence." }, site_pages: { type: "array", maxItems: 50, items: page, description: "Optional existing site pages for differentiation and linking." } }, required: ["keyword"] } },
+    { name: "audit_site_seo", description: "Audit supplied page HTML for on-page, duplication, and internal-link problems; costs $0.15 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { pages: { type: "array", minItems: 1, maxItems: 50, description: "Pages to audit; each requires url and html.", items: { ...page, required: ["url", "html"] } } }, required: ["pages"] } },
+    { name: "find_internal_link_opportunities", description: "Find missing contextually relevant internal links across supplied pages; costs $0.05 USDC.", annotations: readOnly, inputSchema: { type: "object", properties: { domain: string("Site domain."), pages: { type: "array", minItems: 2, maxItems: 50, items: page, description: "Two or more site pages with title and text for best results." } }, required: ["domain", "pages"] } }
+];
+export const paidToolNames = new Set(tools.slice(1).map(tool => tool.name));
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/examples/claude_desktop_config.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "seo-authority": {
+      "command": "npx",
+      "args": ["-y", "@forgemeshlabs/seo-authority-mcp"],
+      "env": {
+        "SEO_MAX_PAYMENT_USDC": "0.15"
+      }
+    }
+  }
+}

package/glama.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["clawdbotworker"]
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@forgemeshlabs/seo-authority-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.forgemeshlabs/seo-authority-mcp",
+  "description": "SEO authority, keyword opportunities, competitor gaps, content briefs, site audits, and internal-link intelligence via x402.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": { "seo-authority-mcp": "dist/index.js" },
+  "files": ["dist", "tool_manifest.json", "README.md", "GLAMA.md", "glama.json", "server.json", "smithery.yaml", "LICENSE", "SECURITY.md", "CHANGELOG.md", "examples"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/generate-manifest.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/index.js",
+    "test": "vitest run --cache=false"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@x402/core": "^2.16.0",
+    "@x402/evm": "^2.16.0",
+    "viem": "^2.38.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3",
+    "vitest": "^4.1.10"
+  },
+  "keywords": ["mcp", "model-context-protocol", "seo", "domain-authority", "keyword-research", "competitor-analysis", "site-audit", "x402", "usdc", "base", "glama", "forgemesh"],
+  "author": "ForgeMesh",
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/forgemeshlabs/seo-authority-mcp.git" },
+  "bugs": { "url": "https://github.com/forgemeshlabs/seo-authority-mcp/issues" },
+  "homepage": "https://github.com/forgemeshlabs/seo-authority-mcp#readme",
+  "publishConfig": { "access": "public" },
+  "engines": { "node": ">=22" }
+}

package/server.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.forgemeshlabs/seo-authority-mcp",
+  "description": "SEO authority, keyword, competitor, content, site-audit, and internal-link tools with optional automatic x402 payments.",
+  "repository": { "url": "https://github.com/forgemeshlabs/seo-authority-mcp", "source": "github" },
+  "version": "0.1.0",
+  "packages": [{
+    "registryType": "npm",
+    "identifier": "@forgemeshlabs/seo-authority-mcp",
+    "version": "0.1.0",
+    "transport": { "type": "stdio" },
+    "environmentVariables": [
+      { "name": "SEO_API_BASE", "description": "Optional backend override; defaults to https://seo.forgemesh.io.", "isRequired": false, "isSecret": false, "format": "string" },
+      { "name": "SEO_X402_PRIVATE_KEY", "description": "Optional EVM wallet private key for automatic x402 USDC settlement.", "isRequired": false, "isSecret": true, "format": "string" },
+      { "name": "SEO_MAX_PAYMENT_USDC", "description": "Maximum automatic payment per tool call; defaults to 0.15 USDC.", "isRequired": false, "isSecret": false, "format": "string" }
+    ]
+  }]
+}

package/smithery.yaml

@@ -0,0 +1,27 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    properties:
+      seoApiBase:
+        type: string
+        description: SEO API base URL. Defaults to https://seo.forgemesh.io.
+      seoX402PrivateKey:
+        type: string
+        description: Optional EVM private key for automatic x402 settlement.
+      seoMaxPaymentUsdc:
+        type: string
+        description: Maximum automatic USDC payment per call. Defaults to 0.15.
+  commandFunction: |-
+    (config) => ({
+      command: 'npx',
+      args: ['-y', '@forgemeshlabs/seo-authority-mcp'],
+      env: {
+        SEO_API_BASE: config.seoApiBase || 'https://seo.forgemesh.io',
+        SEO_X402_PRIVATE_KEY: config.seoX402PrivateKey || '',
+        SEO_MAX_PAYMENT_USDC: config.seoMaxPaymentUsdc || '0.15'
+      }
+    })
+  exampleConfig:
+    seoApiBase: https://seo.forgemesh.io
+    seoMaxPaymentUsdc: '0.15'

package/tool_manifest.json

@@ -0,0 +1,465 @@
+{
+  "server": "seo-authority-mcp",
+  "version": "0.1.0",
+  "source": "https://seo.forgemesh.io/openapi.json",
+  "tools": [
+    {
+      "name": "get_seo_capabilities",
+      "description": "Retrieve free capability, provenance, and unavailable-metric disclosures before choosing a paid SEO tool.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_domain_authority",
+      "description": "Measure one domain's open-web SEO authority using Common Crawl harmonic centrality and PageRank graph data; costs $0.01 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "domain": {
+            "type": "string",
+            "description": "Domain or URL to measure, such as example.com."
+          }
+        },
+        "required": [
+          "domain"
+        ]
+      }
+    },
+    {
+      "name": "compare_domain_authority",
+      "description": "Compare open-web SEO authority for 2 to 20 domains and rank the results; costs $0.02 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "domains": {
+            "type": "array",
+            "description": "Two to twenty domains or URLs.",
+            "minItems": 2,
+            "maxItems": 20,
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "domains"
+        ]
+      }
+    },
+    {
+      "name": "score_page_seo",
+      "description": "Score supplied page HTML for deterministic on-page SEO checks without claiming page authority; costs $0.01 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "description": "Canonical URL for the supplied page."
+          },
+          "html": {
+            "type": "string",
+            "description": "Complete page HTML, up to 512 KB."
+          }
+        },
+        "required": [
+          "url",
+          "html"
+        ]
+      }
+    },
+    {
+      "name": "correct_seo_query",
+      "description": "Correct likely spelling errors in an SEO search query; costs $0.005 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "SEO query to correct."
+          }
+        },
+        "required": [
+          "query"
+        ]
+      }
+    },
+    {
+      "name": "expand_seo_query",
+      "description": "Generate deterministic long-tail and intent-oriented variants of an SEO query; costs $0.01 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Seed SEO query to expand."
+          }
+        },
+        "required": [
+          "query"
+        ]
+      }
+    },
+    {
+      "name": "find_keyword_opportunities",
+      "description": "Generate and prioritize long-tail keyword opportunities without fabricating volume, CPC, SERP, or difficulty metrics; costs $0.05 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "seed": {
+            "type": "string",
+            "description": "Seed topic or keyword."
+          },
+          "audience": {
+            "type": "string",
+            "description": "Optional target audience."
+          },
+          "domain_authority_score": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 100,
+            "description": "Optional known authority score used for prioritization."
+          }
+        },
+        "required": [
+          "seed"
+        ]
+      }
+    },
+    {
+      "name": "find_competitor_content_gaps",
+      "description": "Find content gaps from customer-supplied site and competitor pages without claiming live SERP verification; costs $0.10 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "site": {
+            "type": "object",
+            "description": "Your domain and supplied pages.",
+            "properties": {
+              "domain": {
+                "type": "string",
+                "description": "Your domain."
+              },
+              "pages": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 50,
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "url": {
+                      "type": "string",
+                      "description": "Absolute page URL."
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "Page title."
+                    },
+                    "text": {
+                      "type": "string",
+                      "description": "Visible page text."
+                    },
+                    "html": {
+                      "type": "string",
+                      "description": "Page HTML, when required."
+                    }
+                  },
+                  "required": [
+                    "url"
+                  ]
+                }
+              }
+            },
+            "required": [
+              "domain",
+              "pages"
+            ]
+          },
+          "competitors": {
+            "type": "array",
+            "description": "One to ten competitors with supplied pages.",
+            "minItems": 1,
+            "maxItems": 10,
+            "items": {
+              "type": "object",
+              "properties": {
+                "domain": {
+                  "type": "string",
+                  "description": "Competitor domain."
+                },
+                "pages": {
+                  "type": "array",
+                  "minItems": 1,
+                  "maxItems": 50,
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "url": {
+                        "type": "string",
+                        "description": "Absolute page URL."
+                      },
+                      "title": {
+                        "type": "string",
+                        "description": "Page title."
+                      },
+                      "text": {
+                        "type": "string",
+                        "description": "Visible page text."
+                      },
+                      "html": {
+                        "type": "string",
+                        "description": "Page HTML, when required."
+                      }
+                    },
+                    "required": [
+                      "url"
+                    ]
+                  }
+                }
+              },
+              "required": [
+                "domain",
+                "pages"
+              ]
+            }
+          }
+        },
+        "required": [
+          "site",
+          "competitors"
+        ]
+      }
+    },
+    {
+      "name": "create_seo_content_brief",
+      "description": "Create an evidence-tagged SEO content brief from a keyword and supplied competitor or site pages; costs $0.10 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "keyword": {
+            "type": "string",
+            "description": "Primary keyword or topic."
+          },
+          "competitor_pages": {
+            "type": "array",
+            "maxItems": 50,
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "description": "Absolute page URL."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Page title."
+                },
+                "text": {
+                  "type": "string",
+                  "description": "Visible page text."
+                },
+                "html": {
+                  "type": "string",
+                  "description": "Page HTML, when required."
+                }
+              },
+              "required": [
+                "url"
+              ]
+            },
+            "description": "Optional competitor pages providing evidence."
+          },
+          "site_pages": {
+            "type": "array",
+            "maxItems": 50,
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "description": "Absolute page URL."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Page title."
+                },
+                "text": {
+                  "type": "string",
+                  "description": "Visible page text."
+                },
+                "html": {
+                  "type": "string",
+                  "description": "Page HTML, when required."
+                }
+              },
+              "required": [
+                "url"
+              ]
+            },
+            "description": "Optional existing site pages for differentiation and linking."
+          }
+        },
+        "required": [
+          "keyword"
+        ]
+      }
+    },
+    {
+      "name": "audit_site_seo",
+      "description": "Audit supplied page HTML for on-page, duplication, and internal-link problems; costs $0.15 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "pages": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 50,
+            "description": "Pages to audit; each requires url and html.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "description": "Absolute page URL."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Page title."
+                },
+                "text": {
+                  "type": "string",
+                  "description": "Visible page text."
+                },
+                "html": {
+                  "type": "string",
+                  "description": "Page HTML, when required."
+                }
+              },
+              "required": [
+                "url",
+                "html"
+              ]
+            }
+          }
+        },
+        "required": [
+          "pages"
+        ]
+      }
+    },
+    {
+      "name": "find_internal_link_opportunities",
+      "description": "Find missing contextually relevant internal links across supplied pages; costs $0.05 USDC.",
+      "annotations": {
+        "readOnlyHint": true,
+        "destructiveHint": false,
+        "idempotentHint": true,
+        "openWorldHint": true
+      },
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "domain": {
+            "type": "string",
+            "description": "Site domain."
+          },
+          "pages": {
+            "type": "array",
+            "minItems": 2,
+            "maxItems": 50,
+            "items": {
+              "type": "object",
+              "properties": {
+                "url": {
+                  "type": "string",
+                  "description": "Absolute page URL."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Page title."
+                },
+                "text": {
+                  "type": "string",
+                  "description": "Visible page text."
+                },
+                "html": {
+                  "type": "string",
+                  "description": "Page HTML, when required."
+                }
+              },
+              "required": [
+                "url"
+              ]
+            },
+            "description": "Two or more site pages with title and text for best results."
+          }
+        },
+        "required": [
+          "domain",
+          "pages"
+        ]
+      }
+    }
+  ]
+}