Metadata-Version: 2.4
Name: geo-insights-mcp
Version: 0.1.0
Summary: GEO Insights MCP Server - Monitor brand visibility across Chinese AI platforms
Author-email: GEO Insights <fengw7785@gmail.com>
License: MIT
Keywords: ai,brand-monitoring,chinese-ai,deepseek,geo,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# GEO Insights MCP Server

Monitor brand visibility across Chinese AI platforms directly from your AI assistant.

## Supported Platforms

DeepSeek, Doubao (ByteDance), Tongyi Qianwen (Alibaba), Yuanbao (Tencent), Kimi (Moonshot AI), Baidu AI+, Quark, Weibo Zhisou.

## Installation

### Option 1: uvx (recommended)

```bash
uvx geo-insights-mcp
```

Add to your MCP config (Claude Desktop, Cursor, etc.):

```json
{
  "mcpServers": {
    "geo-insights": {
      "command": "uvx",
      "args": ["geo-insights-mcp"],
      "env": {
        "GEO_INSIGHTS_API_KEY": "sk-your-api-key"
      }
    }
  }
}
```

### Option 2: pip

```bash
pip install geo-insights-mcp
GEO_INSIGHTS_API_KEY=sk-your-api-key geo-insights-mcp
```

## Getting an API Key

Sign up at [api.geotoolhub.com](https://api.geotoolhub.com/console/register) or find us on [RapidAPI](https://rapidapi.com/geotoolhub/api/geo-insights).

## Tools

| Tool | Description |
|------|-------------|
| `submit_monitoring_task` | Submit a query to monitor across Chinese AI platforms |
| `get_task_status` | Poll task status (pending → completed) |
| `get_task_result` | Fetch full results with AI responses, citations, and references |

## Example Usage in Claude

After configuring the MCP server, you can ask Claude:

> "Check how Salesforce appears in DeepSeek's AI responses"

Claude will automatically:
1. Call `submit_monitoring_task` with the query
2. Poll `get_task_status` until complete
3. Call `get_task_result` and present the findings

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `GEO_INSIGHTS_API_KEY` | Yes | Your GEO Insights API key |
| `GEO_INSIGHTS_API_URL` | No | API base URL (default: https://api.geotoolhub.com) |

## License

MIT
