MCP Server — Geolix

Overview

Connect AI assistants like Claude, Cursor directly to your Geolix data.

Capabilities

📈

Brand Visibility

Check brand visibility across ChatGPT, Perplexity, Gemini, and more.

⚔️

Competitor Compare

Compare competitors on visibility, sentiment, share of voice.

🔗

Source Analysis

See which domains and URLs AI models cite most often.

Content Inspection

Inspect what AI engines actually read.

Setup

Create an API Key

Connect to Your AI Tool

Property	Value
Server URL	`https://api.geolix.ai/mcp`
Transport	Streamable HTTP
Authentication	`x-api-key` header

Start Asking Questions

Try these natural language prompts:

"How has our brand visibility changed over the past 30 days?"
"Which competitors have the highest share of voice in ChatGPT?"
"Which URLs are cited most by AI search engines?"

Supported Platforms

Claude Code

claude mcp add geolix --transport http https://api.geolix.ai/mcp \
  --header "x-api-key: YOUR_API_KEY"

Cursor

Settings → Tools & Integrations → MCP → Add Custom MCP

URL: https://api.geolix.ai/mcp
Transport: Streamable HTTP
Header: x-api-key: YOUR_API_KEY

VS Code (GitHub Copilot)

Create .vscode/mcp.json:

{
  "mcpServers": {
    "geolix": {
      "type": "http",
      "url": "https://api.geolix.ai/mcp",
      "headers": {
        "x-api-key": "${GEOLIX_API_KEY}"
      },
      "timeout": 120000
    }
  }
}

Windsurf

Settings → MCP → Add Server

URL: https://api.geolix.ai/mcp
Header: x-api-key: YOUR_API_KEY

How it works

AI Assistant  ─MCP protocol──▶  Geolix MCP Server (:8101)
                                   │
                                   ├── list_tools()  → returns 28 tool definitions
                                   │
                                   └── call_tool()   → direct service layer call
                                                        │
                                                        ▼
                                                   Database → JSON → MCP response

The MCP Server is a standalone FastMCP process with manually defined tools.

Permissions

Most tools are read-only — dashboard, sources, detection records only pull data.

A few tools modify configuration（create brands, edit intents）。Write tools are marked with readOnlyHint: false，delete tools with destructiveHint: true；AI 客户端执行前会请求确认。

Write operations require owner or admin role. Any project member can use read tools.

Tools

The server currently provides 28 MCP tools:

Domain	Count	Description
brands	4	Brand management
projects	8	Project management
queries	2	Intent management
runs	4	Detection runs
board	9	Dashboard data
insights	1	Analytics insights

Brands

Tool	R/W	Description
`list_brands`	Read	List all brands
`get_brand`	Read	Get brand details
`create_brand`	Write	Create a brand
`update_brand`	Write	Update a brand

Projects

Tool	R/W	Description
`list_projects`	Read	List all projects
`get_project`	Read	Get project details
`create_project`	Write	Create a project
`update_project`	Write	Update project settings
`list_queries`	Read	List monitoring intents
`add_queries`	Write	Add monitoring intents
`suggest_topics`	Read	AI-generate monitoring topics
`suggest_queries`	Read	AI-generate intent suggestions

Runs

Tool	R/W	Description
`get_run`	Read	Get detection run details
`list_runs`	Read	List detection runs
`trigger_run`	Write	Trigger a detection run
`cancel_run`	Write	Cancel a detection run

Board

Tool	R/W	Description
`get_board`	Read	Dashboard overview
`get_board_sources`	Read	Citation sources
`get_source_detail`	Read	Source detail
`get_competitive_gap`	Read	Competitive gap analysis
`get_by_intent`	Read	Metrics by intent
`get_chat_records`	Read	Q&A records
`get_chat_facets`	Read	Filter facets
`export_chats`	Read	Export Q&A records
`get_completion`	Read	Completion status

Queries

Tool	R/W	Description
`update_query`	Write	Update a monitoring intent
`archive_query`	Write	Archive a monitoring intent

Others

Tool	R/W	Description
`reanalyze_project`	Write	Re-analyze project data

Troubleshooting

401 Unauthorized

Check that the API Key is correct (including the full glx_live_ prefix)
Confirm the key has not been revoked

403 Forbidden

The API Key user must be granted waitlist access
Write operations require owner or admin role

Connection timeout

Confirm the URL is https://api.geolix.ai/mcp
Check your network connection