Specularis AI Visibility Audit

io.github.AdevAaronsPublished by GitHub account AdevAaronsv1.0.1Updated Oct 24, 2026

Free AI visibility (GEO/AEO) audit: can ChatGPT, Claude and Perplexity find and cite your website?

The publisher's own server: audit.domains - Domain Valuation

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that audits a website's AI visibility (GEO/AEO) and shows which sources ChatGPT, Claude, Perplexity and Gemini cite.

What you can do
  • Run a free AI visibility audit on a website, returning an in-chat snapshot of AI crawler access, structured data and llms.txt
  • Request a full scored PDF report (0–100 across six pillars) by supplying an email address
  • Find the sources AI engines cite for a buyer query and check whether a given domain appears among them
  • Get a link to book a strategy call with the vendor
When to use it
Useful when you want a quick check of whether AI assistants can crawl, read and cite a site, or want to see which third-party sources engines cite for a given buyer question. Aimed at site owners, marketers and agencies working on AI search visibility.
Requirements
Nothing to install: it is a hosted remote endpoint added as a custom connector or HTTP MCP server. No authentication, keys or headers are declared for the hosted service. Self-hosting is optional and needs Node.js plus engine API keys for the citation finder.
Before you install
Supplying an email address to the audit tool sends a report and registers the person as a Specularis lead, so omit it for the snapshot alone. The service is run by a commercial GEO/AEO agency and includes a booking link for its own calls. The audit fetches the target site with real bot user agents, and the citation finder sends queries to third-party AI engines.

Installation

In SourceWeft

  1. Open Specularis AI Visibility Audit in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.AdevAarons%2Fspecularis-mcp-audit/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "specularis-ai-visibility-audit": {
      "type": "http",
      "url": "https://specularis-mcp-audit-production.up.railway.app/mcp"
    }
  }
}

README

Specularis AI Visibility Audit — MCP Server

Run a free AI visibility (GEO/AEO) audit on any website from inside Claude, ChatGPT, or any MCP client — check whether ChatGPT, Claude, Perplexity and Gemini can reach, read and cite it, and find the sources they cite instead.

Hosted endpoint (Streamable HTTP):

https://specularis-mcp-audit-production.up.railway.app/mcp

No installation needed — it's a remote MCP server. Add the URL above and you're done.

Connect it

Claude (claude.ai or Claude Desktop): Settings → Connectors → Add custom connector → paste the URL above.

Claude Code:

bash
claude mcp add --transport http specularis-audit https://specularis-mcp-audit-production.up.railway.app/mcp

Then in any chat: "Audit example.com for AI visibility" — the tool runs.

Tools

ToolWhat it does
run_ai_visibility_audit(website_url, email?, name?, role?)Instant in-chat snapshot: AI crawler access (GPTBot, ClaudeBot, PerplexityBot, CCBot, Google-Extended), JSON-LD structured data, and llms.txt. Include an email to also receive the full scored report — 0–100 across six pillars — as a PDF. role accepts Real Estate Agent, Attorney, Founder or Other and tilts the scoring toward local entity signals, reviews and directories.
find_ai_citations(query, domain)Given a buyer question ("best personal injury lawyer in Miami") and a domain, returns the sources AI engines actually cite when answering it, tagged by engine, plus an appears in X of N count for the domain. The ranked source list is the off-site target list.
book_strategy_call()Returns a link to book a strategy call with Specularis.

Passing email to run_ai_visibility_audit sends a report and registers the person as a Specularis lead. Omit it for the snapshot alone.

Without an MCP client

The same scan engine is reachable over plain HTTP, with no key and no connector:

bash
curl -s "https://specularis-mcp-audit-production.up.railway.app/api/scan?d=example.com"

Pass a bare hostname — no scheme, no path. It returns the full structured scan: per-bot fetch results, browser-vs-bot word counts for render-gap detection, parsed schema types, llms.txt, sitemap, and the six pillar scores. Useful for scanning domains in bulk.

If inconclusive is true, the scan could not complete — read inconclusiveReason and don't report a score.

What the full audit measures

Each bot is fetched with its real published user agent, so the result is what the engine itself would receive — not what a browser sees.

The report scores six pillars out of 100:

PillarMaxWhat it covers
access20Whether GPTBot, ClaudeBot and PerplexityBot can actually reach and receive the page
entity15Organization / Person / LocalBusiness schema, sameAs, address
content15Whether the text answers the questions buyers actually ask
offsite30The directories, review platforms and threads AI engines cite
freshness10Whether the content is maintained
technical10Sitemap, llms.txt, render gaps, crawlability

offsite is deliberately the largest pillar — more than access and entity combined. That reflects how the engines behave: they cite third-party corroboration far more often than a company's own marketing pages, so a technically flawless site can still be invisible.

A note on measuring "blocked". A real block is a 403, or a genuine interstitial with under 80 words of page text. Bot-protection layers return challenge pages intermittently, and counting those as blocks inflates the result — we published numbers once that were wrong for exactly this reason, and corrected them. Re-run before reporting a block.

Across 561 US businesses scanned in 2026, roughly half were effectively invisible to AI engines.

Use it as an agent skill

SKILL.md packages this as a portable agent skill in the open SKILL.md format — when to run an audit, how to read every field it returns, and the order to apply the fixes in. It works against either the MCP tools or the HTTP endpoint above.

Self-hosting

The server is a single-file Node app (Streamable HTTP transport).

bash
npm installnpm start

Point any MCP client at http://localhost:3000/mcp.

VariablePurpose
N8N_WEBHOOK_URLBackend audit engine endpoint for the full PDF report
CONTACT_URLBooking link returned by book_strategy_call
AUDIT_URLWeb-form fallback link included in responses
PORTListen port (default 3000)
PERPLEXITY_API_KEYPrimary engine for find_ai_citations
ANTHROPIC_API_KEYAdds Claude as a second engine
GEMINI_API_KEYAdds Gemini as a third engine
OPENAI_API_KEYAdds ChatGPT as a fourth engine
OPENAI_MODELModel for the ChatGPT engine (default gpt-5-mini)
FINDER_DAY_MAXGlobal daily cap on citation-finder runs (default 250)

find_ai_citations needs at least one engine key. The engines array in each response reports which ones actually ran, so only claim the engines it names.

Who's behind it

Built by Specularis — a GEO/AEO agency helping businesses get found and cited by AI engines. The audit is free; the report is the real deliverable.

License

MIT

Source: README.md at commit aa0b00d

Tools

3

run_ai_visibility_audit

Run AI Visibility Audit

Run a free AI visibility (GEO/AEO) audit on a website — checks whether ChatGPT, Claude, Perplexity, and Gemini can find and cite it. Returns an instant snapshot of crawler access, structured data, and llms.txt. If an email is provided, a full scored report (0–100 across 5 pillars, with copy-paste fixes) is emailed as a PDF. Use this whenever a user asks to audit/check a site's AI visibility, GEO, AEO, or whether AI can find them.

Parametersnameroleemailwebsite_urlrequired

book_strategy_call

Book a Strategy Call

Get the link to book a free Specularis strategy call about AI visibility / GEO / AEO.

Takes no parameters.

find_ai_citations

Find AI Citation Sources

Given a buyer query (e.g. 'best real estate agent in Tampa') and a website domain, find the exact sources ChatGPT, Perplexity, Claude, and Gemini cite when answering that query — and whether the domain appears in any of them. Returns the ranked source list (with which engine cites each) and an 'appears in X of N' gap. Use this whenever a user wants to know where AI gets its answers about their industry, which pages AI trusts for a query, or whether their business shows up in AI recommendations.

Parametersqueryrequireddomainrequired

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Audit integrations