TOP GUN GEO-Lens

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