mindcase-mcp 0.1.0

MCP server for Mindcase — 30+ data collection agents accessible from Claude

Mindcase MCP Server

MCP server for Mindcase — 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 and create an API key in the API Console.

2. Install and configure

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):

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):

{
  "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
• Agent Reference
• Python SDK
• Node.js SDK

Privacy

See privacy-policy.md for details on data handling.

License

MIT