Skip to main content
Glama
AIEthos-ai

mcp-ethostron-live

Official

EthosTron™ Live MCP Server ⚡

License Model Context Protocol Vitest Status

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"]
      }
    }
  }
}

Copilot Chat Usage:

@ethostron Audit https://example.com for GEO and identify missing schema types

2. ChatGPT (OpenAI Custom GPTs & Actions)

For OpenAI ChatGPT (Plus, Team, Enterprise), connect EthosTron Live via OpenAPI Actions pointing to the Cloud Run backend without needing a local daemon:

  1. Open ChatGPT > Explore GPTs > Create (or edit an existing Custom GPT).

  2. Go to the Configure tab > Scroll down to Actions > Click Create new action.

  3. Under Schema, click Import from URL and enter:

    https://aiethos-backend-978593064341.us-west2.run.app/openapi.json
  4. Authentication: Leave as None (the public developer /public/mcp/* endpoints are open & read-only).

  5. Privacy Policy: https://aiethos.ai/privacy

  6. Save and publish your Custom GPT!

ChatGPT Usage:

Audit https://stripe.com for GEO and generate a direct answer remediation block.

3. Google Gemini & Antigravity

For developers building with Google Gemini models or Google Antigravity:

Option A — Antigravity & Gemini CLI (.gemini/config/mcp_config.json):

{
  "mcpServers": {
    "ethostron": {
      "command": "npx",
      "args": ["-y", "@aiethos/ethostron-mcp"]
    }
  }
}

Option B — 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"]
    }
  }
}

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.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: ethostron

  • Type: command

  • Command: 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"]
    }
  }
}

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"]
    }
  }
}

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.txt directives for GPTBot (OpenAI), PerplexityBot, ClaudeBot, and Google-Extended (Gemini).

  • Schema.org Microdata Health: Inspects JSON-LD for Organization, TechArticle, FAQPage, SoftwareApplication, and Product.

  • 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"

📋 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 robots.txt for GPTBot (+10), PerplexityBot (+10), ClaudeBot (+5), and Google-Extended (+5).

2. Schema.org Health

40 Pts

Valid JSON-LD present (+15), Organization/Brand entity grounded (+10), High-citation schema 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 tools
aiethos_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.

NameRequiredDescriptionDefault
brand_nameYesThe brand or product name (e.g., 'Datadog', 'AI Ethos', 'Stripe').
industry_categoryNoOptional industry category (e.g., 'Cloud Observability', 'AI Governance').

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full disclosure burden. It does add genuinely useful behavioral context by naming the three external LLM providers queried and the query class ('common industry queries'), but says nothing about latency, cost, rate limits, whether queries are live or cached, or determinism of results across calls.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with the core action front-loaded and a useful contrast clause ('or whether competitors dominate citations'). No filler, no repetition of the tool name.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema exists, so the description is the only place a caller learns what comes back. It implies a per-LLM citation verdict plus competitor comparison, but never states the shape of the response (per-model breakdown? a single verdict? scored ranking?) or run cost, which matters for a tool that fans out to three providers.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline would be 3, but the description actually introduces mild ambiguity rather than added meaning: it says 'brand or domain' while the schema has only brand_name, and 'common industry queries' loosely gestures at industry_category without explaining how that value scopes the queries. It also arguably duplicates the schema's own examples rather than clarifying them.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb (checks citations) and resource (brand/domain citation presence across named frontier LLMs: OpenAI, Gemini, Claude), which is far more concrete than the tool name alone. It falls short of a 5 because it never distinguishes itself from the sibling tools aiethos_geo_quickscan and aiethos_preview_ethostron_fix, which plausibly overlap in scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the phrase 'for common industry queries' and the competitor-domination framing, so an agent can infer this is a brand-visibility audit. There is no explicit when-to-use, no when-not-to-use, and no routing to the quickscan sibling, which is the most likely alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

NameRequiredDescriptionDefault
urlYesThe full target URL or root domain to audit (e.g., 'https://example.com' or 'example.com').
brand_nameNoOptional brand name to check entity citations for.

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full disclosure burden. It implies a passive read-only audit and lists what gets analyzed, but says nothing about whether the scan fetches live pages, how long it takes, rate limits, or what the result contains — leaving the agent to guess at cost and side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two front-loaded sentences with the action first and the analysis scope second; almost every clause carries information. The trailing "for LLMs like Perplexity, ChatGPT, and Google AI Overviews" is slightly padded but does convey the evaluation targets.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description should say roughly what an audit returns (scores, findings, gap list). It names the analysis dimensions but not the deliverable, so an agent knows what the tool inspects but not what it will get back.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so both parameters are already fully documented in the schema, including accepted URL/domain formats and the optional brand_name. The description adds no parameter-level meaning beyond that, which is the expected baseline rather than a strength.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb and resource ("Performs a fast GEO audit on a domain or URL") and enumerates the four analysis dimensions, so the purpose is unmistakable. It does not, however, distinguish itself from the sibling aiethos_check_llm_citations, even though "identifies top citation gaps" overlaps that tool's apparent domain.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Fast" implies a lightweight variant exists, but the description never states when to choose this over aiethos_check_llm_citations or aiethos_preview_ethostron_fix, and gives no prerequisites or exclusions. Usage must be inferred from the tool name and the word "quickscan."

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

NameRequiredDescriptionDefault
urlYesThe URL of the target page where the content gap exists.
gap_topicYesThe topic, claim, or query missing citation (e.g., 'SOC2 Compliance & Latency', 'Enterprise Pricing').
intent_categoryNoOptional intent category to calibrate structural markers.

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It usefully signals that the output is a *sample* / preview artifact rather than a live page edit, and it enumerates what is produced (inverted-pyramid copy, Schema.org markup, evidence structure). It does not state whether the target URL is crawled, whether anything is persisted, or whether there are cost/rate constraints — real gaps for a generation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The output contents are front-loaded in a single dense sentence, which is efficient, but 'The Taste Test' and 'EthosTron Live engine' are brand filler that consume the highest-attention position without telling the agent anything operational.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Because there is no output schema, the description correctly spends its words enumerating the three returned artifacts, which is the right call. However, for a generation tool with zero annotations it omits the operational facts an agent needs before invoking: side effects, whether the URL is fetched, and how this fits after a citation check.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, including enum values and per-field explanations, so the description is not required to define parameters. It says nothing about url, gap_topic, or intent_category, so it adds no meaning beyond the schema. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: 'Synthesizes a sample authoritative Direct-Answer Content Block' using a named engine. That distinguishes it from the sibling check_llm_citations (diagnostic) and geo_quickscan (audit). The 'Taste Test' branding is decorative rather than informative, but the substantive clause carries the purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no statement of when to use this versus aiethos_check_llm_citations or aiethos_geo_quickscan, and no prerequisites such as whether the URL must already be scanned or whether an existing gap must be confirmed. The word 'preview' hints at a dry-run step but the description never says so explicitly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 3 tool updatesv0.1.0
    • First observedaiethos_check_llm_citations
    • First observedaiethos_geo_quickscan
    • First observedaiethos_preview_ethostron_fix

TDQS

B3.2/5.0

Scored across 3 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count3/5

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.

Completeness3/5

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

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    AEO & 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.
    114 npm
    MIT
  • A
    license
    B
    quality
    A
    maintenance
    Unifies 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.
    47
    3
    MIT
  • -
    license
    Not graded
    quality
    C
    maintenance
    Enables 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.
    -