mcp-ethostron-live
OfficialEthosTron Live MCP server lets AI assistants run GEO audits, preview citation-ready remediation content, and check LLM citation visibility.
Audit a URL/domain:
aiethos_geo_quickscanchecks AI crawler access, Schema.org health, direct-answer readability, and critical citation gaps, optionally using a brand name.Generate a remediation preview:
aiethos_preview_ethostron_fixcreates an authoritative inverted-pyramid direct-answer block with recommended Schema.org markup for a specified gap topic and optional intent category.Check LLM citations:
aiethos_check_llm_citationsdetermines whether a brand/domain is cited across frontier LLMs for common industry queries versus competitors, optionally using an industry category.
Checks Google-Extended crawler access and assesses citation/readiness across Google AI surfaces such as Gemini and Google AI Overviews.
Checks GPTBot crawler access and determines whether a brand is cited across OpenAI LLMs for GEO and AI search readiness.
Checks PerplexityBot crawler access and measures whether a brand is cited in Perplexity answers for industry prompts.
EthosTron™ Live MCP Server ⚡
The official Model Context Protocol (MCP) server for AIEthos.
EthosTron™ Live brings real-time Generative Engine Optimization (GEO) directly into your AI coding assistant (Claude Desktop, Cursor, Antigravity, Windsurf, VS Code). In under 2 seconds, your agent can audit any website for AI search readiness, inspect crawler access (GPTBot, PerplexityBot, ClaudeBot, Google-Extended), detect missing Schema.org entities, and synthesize drop-in Inverted-Pyramid Direct-Answer blocks engineered for citation across frontier models.
⚡ Multi-Assistant Setup & Configuration
EthosTron™ Live supports both local MCP (stdio JSON-RPC) for IDE coding assistants and standard OpenAPI Actions for cloud LLM assistants like ChatGPT:
1. GitHub Copilot (Visual Studio Code)
GitHub Copilot natively supports MCP servers directly within VS Code.
Add to your project's .vscode/mcp.json (or run Command Palette Ctrl+Shift+P / Cmd+Shift+P > Copilot: Manage MCP Servers):
{
"mcp": {
"servers": {
"ethostron": {
"command": "npx",
"args": ["-y", "@aiethos/ethostron-mcp"],
"env": {
"AIETHOS_API_KEY": "ae_live_your_api_key_here"
}
}
}
}
}(Note: AIETHOS_API_KEY is optional for free public quickscans, but required for the active in-IDE remediation suite).
Copilot Chat Usage:
@ethostron Audit https://example.com for GEO and identify missing schema types2. ChatGPT (OpenAI Custom MCP Connectors & Actions)
EthosTron Live supports both native Remote MCP connections (Server-Sent Events / Streamable HTTP) and OpenAPI Actions:
Option A — Native Remote MCP Connection (ChatGPT Pro Developer Mode, Team & Enterprise):
In ChatGPT, add a custom MCP server:
Transport Type: Server-Sent Events (SSE) / Streamable HTTP
First-Party Server URL:
https://aiethos-backend-978593064341.us-west2.run.app/public/mcp/sse(Or Streamable HTTP endpoint:
https://aiethos-backend-978593064341.us-west2.run.app/public/mcp)Glama Hosted Gateway: Connect directly via Glama MCP Directory
Authentication:
None(The public developer endpoints are 100% read-only and unauthenticated)
Option B — OpenAPI Actions (Custom GPTs & Assistants):
Open ChatGPT > Explore GPTs > Create (or edit an existing Custom GPT).
Go to the Configure tab > Scroll down to Actions > Click Create new action.
Under Schema, click Import from URL and enter:
https://aiethos-backend-978593064341.us-west2.run.app/openapi.jsonAuthentication: Leave as
None.Privacy Policy:
https://aiethos.ai/privacySave and publish your Custom GPT!
ChatGPT Usage:
Audit https://stripe.com for GEO and generate a direct answer remediation block.3. Google Antigravity & Gemini
EthosTron Live is available as a native Antigravity Plugin and MCP server:
Option A — Antigravity Agent Marketplace (One-Click Install): Install directly from the Antigravity Agent Marketplace catalog:
<plugin-card catalog-id="antigravity-plugins-partners/plugin/ethostron-live"></plugin-card>Or link directly in your Antigravity plugins directory (~/.gemini/config/plugins/ethostron-live/):
git clone https://github.com/AIEthos-ai/ethostron-mcp ~/.gemini/config/plugins/ethostron-liveOption B — Standalone MCP Server (.gemini/config/mcp_config.json):
{
"mcpServers": {
"ethostron": {
"command": "npx",
"args": ["-y", "@aiethos/ethostron-mcp"],
"env": {
"AIETHOS_API_KEY": "ae_live_your_api_key_here"
}
}
}
}Option C — Google GenAI Python SDK (google-genai):
from google import genai
from google.genai import types
client = genai.Client()
# Connect to EthosTron Live OpenAPI endpoints directly
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="Audit https://example.com using aiethos_geo_quickscan"
)4. Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ethostron": {
"command": "npx",
"args": ["-y", "@aiethos/ethostron-mcp"],
"env": {
"AIETHOS_API_KEY": "ae_live_your_api_key_here"
}
}
}
}Config file locations:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Claude Usage: Click the tool hammer icon in Claude Desktop and prompt: "Audit https://linear.app for GEO".
5. Cursor & Windsurf
In Settings > Features > MCP Servers, add a new server:
Name:
ethostronType:
commandCommand:
npx -y @aiethos/ethostron-mcp
Or add directly to .cursor/mcp.json or .windsurf/mcp.json:
{
"mcpServers": {
"ethostron": {
"command": "npx",
"args": ["-y", "@aiethos/ethostron-mcp"],
"env": {
"AIETHOS_API_KEY": "ae_live_your_api_key_here"
}
}
}
}6. VS Code Autonomous Agents (Cline / Roo Code / Continue)
Add to your extension's MCP configuration (e.g. ~/.cline/mcp_settings.json or Roo Code MCP settings):
{
"mcpServers": {
"ethostron": {
"command": "npx",
"args": ["-y", "@aiethos/ethostron-mcp"],
"env": {
"AIETHOS_API_KEY": "ae_live_your_api_key_here"
}
}
}
}Autonomous coding agents will automatically invoke aiethos_geo_quickscan to diagnose missing Schema.org markup or robots directives, and call aiethos_preview_ethostron_fix to apply verified drop-in code patches.
Related MCP server: geoseo-mcp
🛠️ Available MCP Tools
1. aiethos_geo_quickscan
Performs an instant, sub-2.0s Generative Engine Optimization assessment for any URL:
AI Crawler Permissions: Checks
robots.txtdirectives forGPTBot(OpenAI),PerplexityBot,ClaudeBot, andGoogle-Extended(Gemini).Schema.org Microdata Health: Inspects JSON-LD for
Organization,TechArticle,FAQPage,SoftwareApplication, andProduct.Inverted-Pyramid Readability: Measures opening lead paragraph word count against the optimal LLM answer extraction target (45–65 words).
Deterministic 0–100 Score: Provides immediate numerical grading and high-impact critical gaps.
Claim Link: Includes an activation URL to upgrade to full multi-page audits.
// Example Agent Prompt:
"Audit https://stripe.com for Generative Engine Optimization using aiethos_geo_quickscan"Example Response Output:
{
"domain": "stripe.com",
"url": "https://stripe.com",
"geoScore": 85,
"crawlerStatus": {
"gptBot": "allowed",
"perplexityBot": "allowed",
"claudeBot": "allowed",
"googleExtended": "allowed"
},
"schemaHealth": {
"hasJsonLd": true,
"detectedTypes": ["Organization", "WebSite"],
"missingRecommendedTypes": ["FAQPage", "TechArticle"]
},
"directAnswerReadability": {
"invertedPyramidDetected": true,
"openingParagraphWordCount": 54,
"status": "optimal",
"recommendation": "Opening paragraph is concise and optimized for LLM answer extraction."
},
"criticalGaps": [
"Missing high-citation schema (FAQPage or TechArticle recommended)"
],
"claimUrl": "https://aiethos.ai/activate?domain=stripe.com&claim_token=mcp_8f2a1b9c&utm_source=ethostron_mcp&utm_medium=ai_copilot&utm_campaign=geo_quickscan"
}2. aiethos_preview_ethostron_fix
The automated content remediation engine: Synthesizes a copy-paste ready, 45–60 word Direct-Answer block and matching Schema.org microdata tailored to your topic and intent category.
Supported Intent Topologies:
definitive_architecture: High-authority entity definitions (what it is, core mechanism, business impact).comparative_benchmark: Objective side-by-side technical trade-offs and decision criteria.troubleshooting_resolution: Exact error signatures, root cause explanations, and CLI commands.pricing_commercial: Transparent tier tables, inclusions, and ROI formulas.framework_methodology: Sequential numbered workflows with CLI verification steps.
// Example Agent Prompt:
"Use aiethos_preview_ethostron_fix to generate an authoritative direct answer block for 'SOC2 Compliance & Zero Trust' on https://acme.io with intent_category 'definitive_architecture'"3. aiethos_check_llm_citations
Checks public prompt benchmarks to determine whether a brand is actively cited across frontier LLMs (OpenAI, Gemini, Claude) for common industry prompts, or whether competitors dominate citations.
// Example Agent Prompt:
"Check AI citation share for Datadog in Cloud Observability using aiethos_check_llm_citations"⚡ Active In-IDE Remediation Suite (Paid Subscribers)
Subscribers with a claimed domain and an AIETHOS_API_KEY (ae_live_...) unlock active in-editor remediation tools that turn passive audits into instant drop-in code fixes:
4. aiethos_list_remediations
Lists active Generative Engine Optimization action items for your organization's claimed domain, ranked by dynamic priority score.
Filters:
priority:'all' | 'high' | 'medium' | 'low',limit: default10.Classification: Categorizes gaps into
ADD_FOUNDATIONAL_BLOCK(new Inverted-Pyramid lead) vs.IMPROVE_EXISTING_ANSWER.
5. aiethos_get_remediation_fix
Synthesizes a production-ready, verified remediation fix for a specific action item or page.
Frameworks:
nextjs_app_router,nextjs_pages_router,react,html_vanilla.Returns: Exact Inverted-Pyramid copy (45-65 words), validated Schema.org JSON-LD, target DOM selector hints, and drop-in JSX.
Credit Cost: 20 credits ($0.02).
6. aiethos_lint_staged_content
Pre-commit / in-editor GEO linter. Validates staged file content against the 45-65 word Inverted Pyramid standard, parses and validates JSON-LD schemas, and checks crawler directives.
Credit Cost: 5 credits ($0.005).
7. aiethos_verify_factual_grounding
The Hallucination Sentinel: Validates proposed content or feature descriptions against verified brand assertions to prevent hallucinated claims that could penalize citation authority.
Credit Cost: 10 credits ($0.01).
8. aiethos_deep_scan
Dispatches an asynchronous multi-page deep GEO audit powered by the unified AuditOrchestrator + Ethos-Glamdring pipeline. Automatically scales crawl depth to your subscription tier limit (Pro: 25, Business: 50, Enterprise: 250 pages) unless capped lower via max_pages. Returns an immediate Job Ticket to prevent IDE socket timeouts.
Credit Cost: Flat 100 credits ($0.10).
9. aiethos_check_job_status
Polls the execution status of an asynchronous background job (job_id). Returns progress percentage, pages crawled, and the full Glamdring audit report when finished.
10. aiethos_list_prompts
Retrieves your organization's tracked GEO prompts from Prompt Studio, including query text, intent category, tracked models, and historical citation rates.
11. aiethos_run_prompt_audit
Triggers an on-demand multi-LLM citation audit across ChatGPT Search, Claude, Gemini, and Perplexity for an ad-hoc test query.
Credit Cost: 50 credits ($0.05).
12. aiethos_generate_robots_config
Generates an optimized Next.js app/robots.ts or static public/robots.txt ensuring that AI search crawlers (GPTBot, PerplexityBot, ClaudeBot, Google-Extended) have explicit indexation permissions.
📋 Available Prompt Templates
audit-website-geo: Complete workflow guiding your AI assistant through scanning, diagnosing, and delivering remediation advice for any target URL.remediate-citation-gap: Turns any identified content gap into a publish-ready Inverted-Pyramid markdown block and JSON-LD schema snippet.
🎯 How the MCP GEO Score is Calculated
The MCP GEO score is a deterministic 100-point formula evaluating the 3 technical pillars of AI search citation:
Pillar | Max Points | Measurement Criteria |
1. AI Crawler Access | 30 Pts | Inspects |
2. Schema.org Health | 40 Pts | Valid JSON-LD present (+15), |
3. Direct-Answer Readability | 30 Pts | Inverted-pyramid opening paragraph: 45–65 words (+30). Suboptimal lengths (+15). Missing (+5). |
🔄 Upgrading to Full Multi-Page Audits
The MCP Quickscan is an instant single-page check. To unlock continuous brand governance, click the claimUrl returned in the tool response:
Full Domain Crawl: Deep 20-page crawl with client-side SPA JavaScript rendering.
Web Verification: Tavily search queries indexing 3rd-party coverage and reviews.
Multi-Model Consensus: Parallel evaluation across OpenAI, Gemini, and Claude with hallucination risk penalties.
Autonomous Remediation: Automated GitHub Pull Requests that apply verified JSON-LD patches.
🛡️ Privacy, Security & Quotas
Strictly Read-Only: EthosTron Live never mutates local files, executes git commits, or modifies production databases.
SSRF Protection: Target addresses are validated against private network CIDRs (
127.0.0.1,10.0.0.0/8,192.168.0.0/16,169.254.169.254).Free Anonymous Tier: 5 quickscans per domain per day with zero setup or API key.
Zero Database Pollution: Anonymous scans do not create dummy accounts or pollute customer dashboards.
💻 Local Development & Testing
# Clone repository
git clone https://github.com/AIEthos-ai/ethostron-mcp.git
cd ethostron-mcp
# Install dependencies
pnpm install
# Build TypeScript
pnpm run build
# Run unit tests
pnpm test
# Test JSON-RPC via MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js📄 License
Apache-2.0 © AIEthos LLC
Available Tools
3 toolsaiethos_check_llm_citationsB
Checks whether a target brand or domain is actively cited across frontier LLMs (OpenAI, Gemini, Claude) for common industry queries, or whether competitors dominate citations.
Inputs: brand_name (required), industry_category.
aiethos_geo_quickscanB
Performs a fast Generative Engine Optimization (GEO) audit on a domain or URL. Analyzes AI bot crawlability, Schema.org microdata health, direct-answer readability, and identifies top citation gaps for LLMs like Perplexity, ChatGPT, and Google AI Overviews.
Inputs: url (required), brand_name.
aiethos_preview_ethostron_fixB
The 'Taste Test': Synthesizes a sample authoritative Direct-Answer Content Block using the EthosTron Live engine. Produces inverted-pyramid copy, recommended Schema.org markup, and third-party evidence structure engineered for AI engine citation.
Inputs: url (required), gap_topic (required), intent_category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool maps to a distinct stage: technical GEO audit (quickscan), sample content synthesis (preview_ethostron_fix), and live citation tracking (check_llm_citations). The two diagnostic tools (quickscan vs. citation check) could be momentarily confused since both assess AI visibility, but the descriptions clearly separate on-site technical readiness from off-site citation presence.
All names share the aiethos_ prefix and snake_case, which is good, but the verb conventions are mixed: check_llm_citations is verb-first while geo_quickscan and preview_ethostron_fix are noun/adjective-first. Readable, but not a predictable pattern an agent can generalize from.
Three tools is thin for a GEO platform surface; the set reads as a minimal entry tier. Each tool does earn its place, but the server feels borderline under-scoped rather than well-rounded.
The lifecycle stops at diagnosis and a sample: quickscan audits, preview_ethostron_fix only produces a 'taste test' block, and nothing generates the full fix, applies schema markup, exports reports, or tracks changes over time. Agents hitting the preview tool have no path to the actual remediation output, a notable dead end.
Maintenance
Related MCP Connectors
Live AEO, GEO, JSON-LD Schema, robots.txt AI crawler, and Agent Readiness diagnostic auditor.
SEO, GEO and ADA/WCAG audits, AI citation tracking and site crawls for AI assistants.
Autonomous SEO + GEO growth: keyword research, audits, content, AI answer-engine visibility.
Autonomous AI agent readiness, crawler reachability, and 30-point audit specification engine.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAEO & GEO strategy agent. Get cited by ChatGPT, Perplexity, Claude, and Google AI Overviews. Delivers schema markup, llms.txt, strategy audits, and progress reports via x402 payments on Base.59 npmMIT
- AlicenseBqualityBmaintenanceUnifies traditional SEO and Generative Engine Optimization (GEO) for Google, Bing, Yandex, and major LLMs, providing tools for search performance analysis, citation tracking, on-page audits, and internal link graph analysis.4736 PyPI3MIT
- -licenseNot gradedqualityCmaintenanceEnables AI assistants to perform comprehensive SEO and GEO measurements, including site audits, keyword research, ranking tracking, and brand visibility analysis across search engines and generative AI platforms.-

SitePulsar MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceMeasures and improves how findable, readable, and usable a website is to AI answer engines and autonomous AI agents through hosted AEO audit tools.MIT