Metadata-Version: 2.4
Name: mindcase-mcp
Version: 0.1.0
Summary: MCP server for Mindcase — 30+ data collection agents accessible from Claude
Project-URL: Homepage, https://mindcase.co
Project-URL: Repository, https://github.com/mindcase-co/mindcase-mcp
Project-URL: Documentation, https://docs.mindcase.co
Author-email: Mindcase <team@mindcase.co>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# Mindcase MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-black.svg)](https://opensource.org/licenses/MIT)

MCP server for [Mindcase](https://mindcase.co) — access 30+ data collection agents from Claude. Scrape LinkedIn, Instagram, Google Maps, Amazon, YouTube, and more with natural language.

## Quick Start

### 1. Get an API key

Sign up at [app.mindcase.co](https://app.mindcase.co) and create an API key in the API Console.

### 2. Install and configure

```bash
git clone https://github.com/mindcase-co/mindcase-mcp.git
cd mindcase-mcp
cp .env.example .env
```

Edit `.env` and add your API key:
```
MINDCASE_API_KEY=mk_live_your_api_key_here
```

### 3. Add to Claude

**Claude Code (CLI):**
```bash
claude mcp add mindcase -- uv --directory /path/to/mindcase-mcp run server.py
```

**Claude Desktop:**

Add to your config (`~/.config/Claude/claude_desktop_config.json` on Mac/Linux):

```json
{
  "mcpServers": {
    "mindcase": {
      "command": "uv",
      "args": ["--directory", "/path/to/mindcase-mcp", "run", "server.py"]
    }
  }
}
```

No need to pass the API key in the config — it's read from the `.env` file automatically.

### 4. Use it

Ask Claude things like:
- "Find coffee shops in Manhattan with ratings above 4.5"
- "Search LinkedIn for AI startups in San Francisco"
- "Get Instagram profiles for Nike, Adidas, and Puma"
- "Scrape Amazon reviews for this product"
- "Find Python developer jobs on Indeed in New York"

## Available Tools

### Utility Tools

| Tool | Description |
|------|-------------|
| `list_agents` | Browse all 30+ available data agents |
| `check_credits` | Check your remaining credit balance |
| `get_agent_details` | View parameters and pricing for a specific agent |

### Data Collection Tools

All agents from the Mindcase API are registered as individual tools:

| Platform | Tools |
|----------|-------|
| **LinkedIn** | Profiles, Companies, Employees, Jobs, Posts, People Search, Company Search, Domain Lookup |
| **Instagram** | Profiles, Posts, Comments |
| **YouTube** | Videos, Channels, Comments, Shorts |
| **Amazon** | Products, Reviews, Bestsellers, India Products |
| **Google Maps** | Businesses, Reviews, Reverse Geocoding |
| **Twitter / X** | Posts |
| **TikTok** | Profiles |
| **Reddit** | Posts |
| **Shopify** | Products |
| **Indeed** | Jobs |
| **App Store** | Reviews |
| **Flipkart** | Products |
| **Myntra** | Products |

Each tool accepts the agent's specific parameters and returns structured data in a table format.

## How It Works

1. On startup, the server fetches all available agents from the Mindcase API
2. Each agent is registered as an MCP tool with its parameter schema
3. When Claude calls a tool, the server runs the agent via the API
4. The server polls for results and returns structured data to Claude

## Configuration

| Environment Variable | Description | Required |
|---------------------|-------------|----------|
| `MINDCASE_API_KEY` | Your Mindcase API key (`mk_live_...`) | Yes |

## Documentation

- [Mindcase API Docs](https://docs.mindcase.co)
- [Agent Reference](https://docs.mindcase.co/agents-overview)
- [Python SDK](https://github.com/mindcase-co/mindcase-python)
- [Node.js SDK](https://github.com/mindcase-co/mindcase-node)

## Privacy

See [privacy-policy.md](privacy-policy.md) for details on data handling.

## License

MIT
