TOP GUN GEO-Lens

io.github.SpacemandomainsPublished by GitHub account Spacemandomainsv1.0.0Updated Oct 27, 2026

Brand visibility auditing across LLMs, AI search, and answer engines with GEO reports and scores.

Overview

AI-generated overview

Remote MCP server that scores how visible a brand is in AI search and LLM-indexed sources, returning citations and GEO recommendations.

What you can do
  • Run a quick brand visibility check and get a 0-100 score, top 3 citation URLs and 2 improvement tips
  • Run a full brand audit with dual search (Brave + Exa) and get a score, score label, top 5 citations, LLM index status and 6 prioritized GEO recommendations
  • Retrieve payment links and a USDC wallet address for both paid tiers
When to use it
Useful when an assistant needs to answer whether a brand shows up in AI-powered search, why AI assistants do not recommend it, or what to do to rank higher in LLM answers, and for client-facing GEO reports.
Requirements
A remote streamable HTTP endpoint; no local install or credentials are declared for connecting. Each paid call requires a payment token (a Stripe Checkout session ID) obtained after paying $0.05 or $1.50 USDC through the payment links returned by the payment-info tool. Self-hosting the README's local setup instead needs Node.js 18 or later plus Stripe and search API keys.
Before you install
Both analysis tools cost money in USDC ($0.05 for the quick check, $1.50 for the full audit) and will not return results without a valid payment token; the payment-info tool exposes a USDC wallet address, so verify the destination before paying. Queries are sent to third-party search providers (Brave and Exa). The README's self-hosted configuration lists secrets such as STRIPE_SECRET_KEY, BRAVE_SEARCH_API_KEY and EXA_API_KEY, which should be kept out of shared configs.

Installation

In SourceWeft

  1. Open TOP GUN GEO-Lens 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.Spacemandomains%2Ftop-gun-geo-lens/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": {
    "top-gun-geo-lens": {
      "type": "http",
      "url": "https://top-gun-mcp-server.vercel.app/api/mcp"
    }
  }
}

README

TOP GUN GEO-Lens — MCP Brand Visibility Auditor

[Publish to MCP Registry]

For AI Agents: This is an MCP server. Connect it, call its tools, and instantly know whether any brand is visible to LLMs and AI search engines — with actionable recommendations to improve it.


What This Does

TOP GUN GEO-Lens measures how visible a brand is across the sources that power AI answers: Brave AI Search, Exa neural search, and LLM-indexed content. It returns a scored report with citations, index status, and concrete GEO (Generative Engine Optimization) recommendations.

Use it when an agent needs to answer questions like:

  • "Is [brand] showing up in AI-powered search results?"
  • "Why isn't [brand] being recommended by AI assistants?"
  • "What should [brand] do to rank higher in LLM outputs?"

Tools

geo_quick_check — $0.05 USDC

Fast snapshot of brand visibility in AI-indexed sources.

OutputDetail
Visibility score0–100
Score labelStrong / Moderate / Weak / Not Found
Top 3 citationsURL, title, snippet, source
2 quick tipsActionable GEO improvements
json
{  "tool": "geo_quick_check",  "query": "Stripe",  "paymentToken": "<stripe-session-id>"}

audit_brand — $1.50 USDC

Full brand visibility audit using dual search (Brave + Exa, 10 results each).

OutputDetail
Visibility score0–100
Score labelStrong / Moderate / Weak / Not Found
Top 5 citationsURL, title, snippet, source, position
LLM index statusBrave indexed, Exa indexed, estimated reach
6 GEO recommendationsPrioritized, actionable improvements
json
{  "tool": "audit_brand",  "query": "Anthropic",  "paymentToken": "<stripe-session-id>"}

get_payment_info — Free

Returns payment URLs and USDC wallet address for both tiers. Call this first if you don't have a payment token.

json
{  "tool": "get_payment_info"}

Agent Workflow

1. Call get_payment_info          → get payment URLs2. Direct user to payment link    → user pays $0.05 or $1.50 USDC3. User provides Stripe session ID4. Call geo_quick_check or audit_brand with paymentToken5. Parse structured results       → score, citations, recommendations

If paymentToken is omitted, the tool returns a payment link instead of results — no error thrown.


Connecting to Claude / MCP Clients

Add to your claude_desktop_config.json (or equivalent MCP config):

json
{  "mcpServers": {    "top-gun-geo-lens": {      "command": "node",      "args": ["/path/to/top_gun_mcp_server/dist/index.js"],      "env": {        "STRIPE_SECRET_KEY": "sk_live_...",        "STRIPE_PAYMENT_URL": "https://buy.stripe.com/...",        "STRIPE_QUICK_CHECK_PAYMENT_URL": "https://buy.stripe.com/...",        "BRAVE_SEARCH_API_KEY": "BSA...",        "EXA_API_KEY": "...",        "USDC_WALLET_ADDRESS": "0x..."      }    }  }}

Setup

bash
git clone https://github.com/spacemandomains/top_gun_mcp_servercd top_gun_mcp_servernpm installcp .env.example .env        # fill in your keysnpm run buildnpm start

Required env vars:

VariableRequiredDescription
STRIPE_SECRET_KEYYesStripe secret key for payment verification
STRIPE_PAYMENT_URLYesPayment link for full audit ($1.50 USDC)
STRIPE_QUICK_CHECK_PAYMENT_URLYesPayment link for quick check ($0.05 USDC)
BRAVE_SEARCH_API_KEYNo*Brave Search API key
EXA_API_KEYNo*Exa neural search API key
USDC_WALLET_ADDRESSNoUSDC wallet address shown to payers

*At least one search API key is required for results.


Pricing Summary

ToolCostBest For
geo_quick_check$0.05 USDCQuick sanity check, high-volume workflows
audit_brand$1.50 USDCDeep audit, client reports, GEO strategy

Tech Stack

  • Runtime: Node.js ≥ 18, TypeScript
  • Protocol: Model Context Protocol (@modelcontextprotocol/sdk)
  • Search: Brave Search API + Exa neural search
  • Payments: Stripe + USDC on-chain
  • Deploy: Vercel-ready

For AI Agents — Key Facts

  • Transport: stdio
  • No streaming — all responses are single text blocks
  • Scores range 0–100; >= 70 = Strong, 40–69 = Moderate, 1–39 = Weak, 0 = Not Found
  • Payment tokens are Stripe Checkout Session IDs (format: cs_live_...)
  • Calling any paid tool without a token returns a structured payment prompt, not an error
  • audit_brand is strictly more detailed than geo_quick_check; use quick_check for speed/cost, audit for depth

Source: README.md at commit 0d27277

Tools

3

geo_quick_check

Quick brand visibility snapshot across LLM-indexed sources. Returns a score (0–100), top 3 citation URLs, and 2 quick improvement tips. Single-source search (5 results). Costs $0.05 USDC. For full citations, LLM index status, and 6 GEO recommendations use audit_brand ($1.50).

ParametersqueryrequiredpaymentToken

audit_brand

Full brand visibility audit across LLM-indexed sources (Brave + Exa, 10 results). Returns a visibility score (0–100), score label, top 5 citation URLs, LLM index status, and 6 actionable GEO recommendations. Costs $1.50 USDC. For a quick snapshot at $0.05 use geo_quick_check.

ParametersqueryrequiredpaymentToken

get_payment_info

Get payment URLs and USDC wallet address for both audit tiers.

Takes no parameters.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% 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

    Declare a license in the repository or the registry entry.