English | 简体中文

GEOly MCP Server

The official remote MCP server for **GEOly** — AI brand visibility (GEO) for your agent. GEOly tracks how brands are mentioned and cited across AI engines (ChatGPT, Perplexity, Google AI Mode, Google AI Overview, Gemini, Copilot), and this server puts that data — visibility KPIs, competitor share, citation sources, market intelligence, and site audits — directly into Claude, Cursor, Codex, VS Code, or any MCP client.

Hosted, streamable HTTP, OAuth in the browser. One URL, nothing to run locally:

https://app.geoly.ai/api/mcp

What your agent can do

• Pull the same KPIs you see in the app — AIGVR score, mention rate, citation rate per AI platform (`get_brand_overview`), daily trends, and SQL-free controlled aggregation over daily datasets (`query_analytics`).
• Find blind spots. Which buyer queries never mention your brand (`get_prompt_mention_rates`)? Which prompts does a domain fail to get cited on (`get_content_opportunities`)?
• Compare brands head-to-head — 2–4 brands side by side on visibility, footprint, citations, and category ranking across AI engines (`compare_public_brands`).
• Map category whitespace — every topic in a category classified into strengths (covered / leading / close / defend) and opportunities (prioritize / gap / watch) for your brand (`get_category_whitespace`).
• Track momentum. Who is gaining or losing Share of Mention in AI answers, period over period (`get_category_brand_momentum`)?
• See AI-search demand — what people actually ask AI in your product space, which brands win those answers, and which demand territories each brand owns (`get_public_search_queries`).
• Watch the AI shelf. Which products AI recommends most across every category, who is climbing week over week (`list_public_shopping_boards`), and any single product's full AI profile (`get_public_shopping_product_detail`).
• Score competition difficulty — a 0–100 "keyword difficulty for the AI era" per topic (`get_topic_competition_difficulty`).
• Profile AI perception. How do AI models describe a brand? Canonical aspects, polarity, and verbatim evidence (`get_public_brand_perception`).
• Audit AI readiness — GEO site audits covering accessibility, structured data, content structure, and technical checks (`get_audit_detail`).

Try asking

Once connected, ask your agent things like:

> - "How visible was my brand in AI answers over the last 30 days, and on which platform am I weakest?"

> - "Which buyer questions never mention us? Rank them by how often competitors show up instead."

> - "Compare Anker vs Soundcore visibility in the portable-audio category."

> - "Where's the whitespace in my category — which topics should we prioritize?"

> - "Which domains do AI engines cite most in my industry, and are we on any of them?"

> - "Which products are climbing the AI shopping shelf this week — and in which topics does reddit.com steer AI toward my competitor?"

> - "Run down my latest GEO site audit and list the critical issues."

Quick start

Prerequisite: a GEOly account with a workspace and a monitored brand (sign up and finish brand onboarding first — a brand-new workspace has no data to query yet).

Then: add the URL, make one tool call, sign in when the browser opens. That's the whole setup.

Claude Code

claude mcp add --transport http geoly https://app.geoly.ai/api/mcp

Cursor

Or add to `~/.cursor/mcp.json`:

{
  "mcpServers": {
    "geoly": {
      "url": "https://app.geoly.ai/api/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector, then paste `https://app.geoly.ai/api/mcp` as the URL. Claude walks you through the OAuth consent in the browser.

ChatGPT

In ChatGPT settings, enable developer mode for connectors, then add a custom connector with the URL `https://app.geoly.ai/api/mcp` and complete the OAuth sign-in. Yes — you can ask ChatGPT about your brand's visibility inside ChatGPT.

VS Code (GitHub Copilot)

Or from the command line:

code --add-mcp '{"name":"geoly","type":"http","url":"https://app.geoly.ai/api/mcp"}'

Codex CLI

Install through the GEOly plugin marketplace — the plugin registers the remote server and runs the OAuth flow on install, no manual config needed:

codex plugin marketplace add geoly-ai/codex-plugins
codex plugin add geoly-mcp@geoly

Windsurf

Settings → MCP Configuration:

{
  "mcpServers": {
    "geoly": {
      "serverUrl": "https://app.geoly.ai/api/mcp"
    }
  }
}

Gemini CLI

gemini mcp add --transport http geoly https://app.geoly.ai/api/mcp

Or in `~/.gemini/settings.json`:

{
  "mcpServers": {
    "geoly": {
      "httpUrl": "https://app.geoly.ai/api/mcp"
    }
  }
}

Cline

Cline supports remote servers natively (note the camel-cased `streamableHttp`):

{
  "mcpServers": {
    "geoly": {
      "type": "streamableHttp",
      "url": "https://app.geoly.ai/api/mcp"
    }
  }
}

If the OAuth browser flow doesn't trigger in your Cline version, use the `mcp-remote` bridge below instead.

Any other MCP client

Clients without native remote/OAuth support can bridge through `mcp-remote`:

{
  "mcpServers": {
    "geoly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.geoly.ai/api/mcp"]
    }
  }
}

GEOly CLI (terminals & CI)

The same tools, packaged as a command line built for agents — see GEOly-Cli:

# macOS / Linux
curl -fsSL https://geoly.ai/install.sh | sh
# Windows
powershell -ExecutionPolicy Bypass -c "irm https://geoly.ai/install.ps1 | iex"

# No login step — the first call opens the browser to authorize
geoly call get_brand_overview --time_range 30d

Authentication

Agencies and multi-workspace users: a single connection can span every workspace you belong to, or pin one with `https://app.geoly.ai/api/mcp?org_id=` (get IDs from the `list_organizations` tool).

Security & data access

• The server only reads data from workspaces you explicitly share at the OAuth consent screen — nothing beyond that scope.
• Write access is opt-in per resource on the consent screen and covers exactly 4 tools (create prompt / topic / competitor, trigger monitoring). Multi-workspace connections and static tokens are always read-only, no exceptions.
• Revoke a connection any time from your GEOly workspace settings; the client's cached credentials stop working immediately.
• The endpoint is stateless streamable HTTP over TLS. Nothing is installed or executed on your machine.

Tools

60+ tools. The surface adapts to your access — single-brand connections skip the routing tools, read-only connections skip the write tools.

Brand monitoring — overview & KPIs (4)

Brand monitoring — prompts & answers (8)

Brand monitoring — citations, domains & pages (5)

Brand monitoring — competitors, topics & sentiment (9)

Site audits & GA4 (4)

Market intelligence — resolve & browse (4)

Market intelligence — topics (10)

Market intelligence — brands (5)

Market intelligence — categories, whitespace & momentum (3)

Market intelligence — AI search queries (2)

Market intelligence — shopping (4)

Public source domains (3)

Write tools (4)

Require write access granted on the OAuth consent screen. Static tokens and multi-workspace connections stay read-only.

Reports, discovery & routing (5)

Plans & access

Heavy market-intelligence queries may count toward plan quotas, and `trigger_prompt` consumes monitoring credits. See www.geoly.ai for plans.

Troubleshooting

• The first call returns 401 — that's the OAuth handshake by design; your client should open a browser. If it doesn't, the client lacks remote-OAuth support: bridge with `mcp-remote` (see above).
• 402 Payment Required — the workspace subscription is inactive.
• Market-intelligence tools are missing — the topic / brand / category / search-query / shopping tool groups require the Grow plan or above. (The two public source domain tools are separate and available on all connections.)
• Write tools are missing — write access wasn't granted at consent, you're on a static token, or the connection spans multiple workspaces (writes are single-workspace only). Re-authenticate and tick the write permissions you need.
• Opening the URL in a browser shows 405 — expected; the endpoint is POST-only streamable HTTP, not a web page.

Related projects

Support

This repo documents the hosted GEOly MCP server. Issues with docs and config examples are welcome here; for account, plan, or data questions, reach us through www.geoly.ai.

License

Documentation and examples in this repository are MIT licensed. The GEOly service itself is a commercial product.

**www.geoly.ai** · GEOly CLI · © GEOly