TOP GUN GEO-Lens — MCP Brand Visibility Auditor

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.

Output	Detail
Visibility score	0–100
Score label	Strong / Moderate / Weak / Not Found
Top 3 citations	URL, title, snippet, source
2 quick tips	Actionable GEO improvements

{
  "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).

Output	Detail
Visibility score	0–100
Score label	Strong / Moderate / Weak / Not Found
Top 5 citations	URL, title, snippet, source, position
LLM index status	Brave indexed, Exa indexed, estimated reach
6 GEO recommendations	Prioritized, actionable improvements

{
  "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.

{
  "tool": "get_payment_info"
}

Agent Workflow

1. Call get_payment_info          → get payment URLs
2. Direct user to payment link    → user pays $0.05 or $1.50 USDC
3. User provides Stripe session ID
4. Call geo_quick_check or audit_brand with paymentToken
5. 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):

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

git clone https://github.com/spacemandomains/top_gun_mcp_server
cd top_gun_mcp_server
npm install
cp .env.example .env        # fill in your keys
npm run build
npm start

Required env vars:

Variable	Required	Description
`STRIPE_SECRET_KEY`	Yes	Stripe secret key for payment verification
`STRIPE_PAYMENT_URL`	Yes	Payment link for full audit ($1.50 USDC)
`STRIPE_QUICK_CHECK_PAYMENT_URL`	Yes	Payment link for quick check ($0.05 USDC)
`BRAVE_SEARCH_API_KEY`	No*	Brave Search API key
`EXA_API_KEY`	No*	Exa neural search API key
`USDC_WALLET_ADDRESS`	No	USDC wallet address shown to payers

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

Pricing Summary

Tool	Cost	Best For
`geo_quick_check`	$0.05 USDC	Quick sanity check, high-volume workflows
`audit_brand`	$1.50 USDC	Deep 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

TOP GUN GEO-Lens