{
  "markdown": "# TOP GUN GEO-Lens — MCP Brand Visibility Auditor\n\n[![Publish to MCP Registry](https://github.com/Spacemandomains/top_gun_mcp_server/actions/workflows/publish-mcp.yml/badge.svg)](https://github.com/Spacemandomains/top_gun_mcp_server/actions/workflows/publish-mcp.yml)\n\n> **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.\n\n---\n\n## What This Does\n\nTOP 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.\n\nUse it when an agent needs to answer questions like:\n- *\"Is [brand] showing up in AI-powered search results?\"*\n- *\"Why isn't [brand] being recommended by AI assistants?\"*\n- *\"What should [brand] do to rank higher in LLM outputs?\"*\n\n---\n\n## Tools\n\n### `geo_quick_check` — $0.05 USDC\nFast snapshot of brand visibility in AI-indexed sources.\n\n| Output | Detail |\n|--------|--------|\n| Visibility score | 0–100 |\n| Score label | Strong / Moderate / Weak / Not Found |\n| Top 3 citations | URL, title, snippet, source |\n| 2 quick tips | Actionable GEO improvements |\n\n```json\n{\n  \"tool\": \"geo_quick_check\",\n  \"query\": \"Stripe\",\n  \"paymentToken\": \"<stripe-session-id>\"\n}\n```\n\n---\n\n### `audit_brand` — $1.50 USDC\nFull brand visibility audit using dual search (Brave + Exa, 10 results each).\n\n| Output | Detail |\n|--------|--------|\n| Visibility score | 0–100 |\n| Score label | Strong / Moderate / Weak / Not Found |\n| Top 5 citations | URL, title, snippet, source, position |\n| LLM index status | Brave indexed, Exa indexed, estimated reach |\n| 6 GEO recommendations | Prioritized, actionable improvements |\n\n```json\n{\n  \"tool\": \"audit_brand\",\n  \"query\": \"Anthropic\",\n  \"paymentToken\": \"<stripe-session-id>\"\n}\n```\n\n---\n\n### `get_payment_info` — Free\nReturns payment URLs and USDC wallet address for both tiers. **Call this first** if you don't have a payment token.\n\n```json\n{\n  \"tool\": \"get_payment_info\"\n}\n```\n\n---\n\n## Agent Workflow\n\n```\n1. Call get_payment_info          → get payment URLs\n2. Direct user to payment link    → user pays $0.05 or $1.50 USDC\n3. User provides Stripe session ID\n4. Call geo_quick_check or audit_brand with paymentToken\n5. Parse structured results       → score, citations, recommendations\n```\n\nIf `paymentToken` is omitted, the tool returns a payment link instead of results — no error thrown.\n\n---\n\n## Connecting to Claude / MCP Clients\n\nAdd to your `claude_desktop_config.json` (or equivalent MCP config):\n\n```json\n{\n  \"mcpServers\": {\n    \"top-gun-geo-lens\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/top_gun_mcp_server/dist/index.js\"],\n      \"env\": {\n        \"STRIPE_SECRET_KEY\": \"sk_live_...\",\n        \"STRIPE_PAYMENT_URL\": \"https://buy.stripe.com/...\",\n        \"STRIPE_QUICK_CHECK_PAYMENT_URL\": \"https://buy.stripe.com/...\",\n        \"BRAVE_SEARCH_API_KEY\": \"BSA...\",\n        \"EXA_API_KEY\": \"...\",\n        \"USDC_WALLET_ADDRESS\": \"0x...\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Setup\n\n```bash\ngit clone https://github.com/spacemandomains/top_gun_mcp_server\ncd top_gun_mcp_server\nnpm install\ncp .env.example .env        # fill in your keys\nnpm run build\nnpm start\n```\n\n**Required env vars:**\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `STRIPE_SECRET_KEY` | Yes | Stripe secret key for payment verification |\n| `STRIPE_PAYMENT_URL` | Yes | Payment link for full audit ($1.50 USDC) |\n| `STRIPE_QUICK_CHECK_PAYMENT_URL` | Yes | Payment link for quick check ($0.05 USDC) |\n| `BRAVE_SEARCH_API_KEY` | No* | Brave Search API key |\n| `EXA_API_KEY` | No* | Exa neural search API key |\n| `USDC_WALLET_ADDRESS` | No | USDC wallet address shown to payers |\n\n*At least one search API key is required for results.\n\n---\n\n## Pricing Summary\n\n| Tool | Cost | Best For |\n|------|------|----------|\n| `geo_quick_check` | $0.05 USDC | Quick sanity check, high-volume workflows |\n| `audit_brand` | $1.50 USDC | Deep audit, client reports, GEO strategy |\n\n---\n\n## Tech Stack\n\n- **Runtime:** Node.js ≥ 18, TypeScript\n- **Protocol:** [Model Context Protocol](https://modelcontextprotocol.io) (`@modelcontextprotocol/sdk`)\n- **Search:** Brave Search API + Exa neural search\n- **Payments:** Stripe + USDC on-chain\n- **Deploy:** Vercel-ready\n\n---\n\n## For AI Agents — Key Facts\n\n- Transport: `stdio`\n- No streaming — all responses are single text blocks\n- Scores range 0–100; `>= 70` = Strong, `40–69` = Moderate, `1–39` = Weak, `0` = Not Found\n- Payment tokens are Stripe Checkout Session IDs (format: `cs_live_...`)\n- Calling any paid tool without a token returns a structured payment prompt, not an error\n- `audit_brand` is strictly more detailed than `geo_quick_check`; use quick_check for speed/cost, audit for depth\n",
  "bytes": 4931,
  "sha": "c37007fbaf3a71ffbf16617a0eeb10548267bab2d4e8684089885c4e82a080e9",
  "repo_slug": "spacemandomains/top_gun_mcp_server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_spacemandomains_top_gun_geo_le_6bc77fbd/readme"
}