MCP Server - Mindcase API Documentation

The Mindcase MCP server lets you use all 30+ data collection agents directly from Claude. No code needed — just ask Claude in natural language.

Installation

Requires uv (Python package runner).

Claude Code (CLI)
Claude Desktop
Cursor / Windsurf

claude mcp add mindcase -- uvx mindcase-mcp

Set your API key:

export MINDCASE_API_KEY=mk_live_your_api_key_here

Add to your config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mindcase": {
      "command": "uvx",
      "args": ["mindcase-mcp"],
      "env": {
        "MINDCASE_API_KEY": "mk_live_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving.

Add to your MCP config (.cursor/mcp.json or equivalent):

{
  "mcpServers": {
    "mindcase": {
      "command": "uvx",
      "args": ["mindcase-mcp"],
      "env": {
        "MINDCASE_API_KEY": "mk_live_your_api_key_here"
      }
    }
  }
}

Example Prompts

Once connected, just ask Claude:

“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”
“How many credits do I have left?”

Claude will automatically pick the right agent, pass the parameters, and return structured results.

Available Tools

Utility Tools

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

Data Collection Tools

Every Mindcase agent is registered as its own tool:

Platform	Agents
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
Google Maps	Businesses, Reviews, Reverse Geocoding
Twitter / X	Posts
TikTok	Profiles
Reddit	Posts
Shopify	Products
Indeed	Jobs
App Store	Reviews
Flipkart	Products
Myntra	Products

How It Works

On startup, the MCP server fetches all available agents from the Mindcase API
Each agent is registered as a tool with its parameter schema
When you ask Claude a question, it picks the right tool and passes the parameters
The server runs the agent, polls for results, and returns structured data
Claude formats and presents the results to you

Configuration

Environment Variable	Description	Required
`MINDCASE_API_KEY`	Your Mindcase API key	Yes

Get your API key at app.mindcase.co.

Privacy

Your API key is stored locally and only sent to api.mindcase.co
It is never sent to Anthropic or any other third party
The MCP server does not log conversations
See the full privacy policy

Other Ways to Use Mindcase

Python SDK — pip install mindcase for programmatic access
Node.js SDK — npm install mindcase for JavaScript/TypeScript

​Installation

​Example Prompts

​Available Tools

​Utility Tools

​Data Collection Tools

​How It Works

​Configuration

​Privacy

​Other Ways to Use Mindcase

​Links