GEOly
Description
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, Gemini, Perplexity, Grok, Google AI), and this server puts that data — visibility KPIs, competitor share, citation…
About
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, Gemini, Perplexity, Grok, Google AI), and this server puts that data — visibility KPIs, competitor share, citation sources, market intelligence, and site…
Details
- Author
- geoly-ai
- Categories
- Marketing, Other, AI
Jump to
Setup
Install GEOly in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/geoly-ai/GEOly-MCP
Follow the installation instructions in the repository README, then restart your MCP client.
The official remote MCP server forGEOly— 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:
- 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).
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."
Prerequisite:a GEOly account with a workspace and a monitored brand (sign upand finish brand onboarding first — a brand-new workspace has no data to query yet).
claude mcp add --transport http geoly https://app.geoly.ai/api/mcp
{ "mcpServers": { "geoly": { "url": "https://app.geoly.ai/api/mcp" } } }
Settings → Connectors →Add custom connector, then pastehttps://app.geoly.ai/api/mcpas the URL. Claude walks you through the OAuth consent in the browser.
In ChatGPT settings, enable developer mode for connectors, then add a custom connector with the URLhttps://app.geoly.ai/api/mcpand complete the OAuth sign-in. Yes — you can ask ChatGPT about your brand's visibility inside ChatGPT.
code --add-mcp '{"name":"geoly","type":"http","url":"https://app.geoly.ai/api/mcp"}'
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
{ "mcpServers": { "geoly": { "serverUrl": "https://app.geoly.ai/api/mcp" } } }
gemini mcp add --transport http geoly https://app.geoly.ai/api/mcp
{ "mcpServers": { "geoly": { "httpUrl": "https://app.geoly.ai/api/mcp" } } }
Cline supports remote servers natively (note the camel-casedstreamableHttp):
{ "mcpServers": { "geoly": { "type": "streamableHttp", "url": "https://app.geoly.ai/api/mcp" } } }
If the OAuth browser flow doesn't trigger in your Cline version, use themcp-remotebridge below instead.
Clients without native remote/OAuth support can bridge throughmcp-remote:
{ "mcpServers": { "geoly": { "command": "npx", "args": ["-y", "mcp-remote", "https://app.geoly.ai/api/mcp"] } } }
The same tools, packaged as a command line built for agents — seeGEOly-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
Agencies and multi-workspace users: a single connection can span every workspace you belong to, or pin one withhttps://app.geoly.ai/api/mcp?org_id=<id>(get IDs from thelist_organizationstool).
- 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.
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 (7)
Brand monitoring — citations, domains & pages (5)
Brand monitoring — competitors, topics & sentiment (7)
Market intelligence — resolve & browse (4)
Market intelligence — categories, whitespace & momentum (3)
Market intelligence — AI search queries (2)
Require write access granted on the OAuth consent screen. Static tokens and multi-workspace connections stay read-only.
Heavy market-intelligence queries may count toward plan quotas, andtrigger_promptconsumes monitoring credits. Seewww.geoly.aifor plans.
- 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 withmcp-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.
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 throughwww.geoly.ai.
Documentation and examples in this repository areMIT licensed. The GEOly service itself is a commercial product.
Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.
Hosted Amazon Seller & Vendor MCP server. Connect Claude, ChatGPT, Cursor, Codex, Gemini, GitHub Copilot to live Amazon SP-API and Ads API data
Run a free AI-visibility scan from inside your assistant: see how often ChatGPT, Claude, Perplexity and Gemini recommend a B2B company when buyers ask for vendors, and get the fixes.
A shared campaign canvas for you and your AI agent: briefed by your brand rules, gated by your approval.
Run your Linkedin account from claude or chatgpt
Chat with any brand's Meta (Facebook/Instagram) ads inside Claude — research a competitor's ad library, surface their longest-running winners, extract hooks/formats, and clone winning ads for your own brand.
Agent-operated social media management for agencies — publish, schedule, approve, and analyze posts across 11 networks (www.aidelly.ai).
Aivie helps users search CRM contacts, campaigns, reports, segments, themes, emails, and Instagram posts, then inspect details, manage segment membership and publication state, create and update private Aivie records, or prepare and publish Meta ad promotions through ChatGPT, Claude, Gemini, Copilot, etc..
Market & competitive intelligence for Claude & AI assistants: trends, alerts, keywords & more.
Intelligent Growth: Product Marketing MCP Server
Run positioning, messaging, competitive analysis and launch planning from Claude or ChatGPT with a hosted product marketing MCP server.
Outbound sales agent for Claude Code: per-prospect research, email writing, Gmail sending, reply tracking, and structured rejection feedback.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




