> ## Documentation Index
> Fetch the complete documentation index at: https://socialintel.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Integration

> Connect Social Intel API to Claude Desktop, Cursor, or any MCP client.

Social Intel API ships an MCP (Model Context Protocol) server that exposes a `search_leads` tool. Any MCP-compatible client — Claude Desktop, Cursor, Windsurf, or custom agents — can use it directly.

## Claude Desktop

Add this to your Claude Desktop MCP config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json theme={null}
{
  "mcpServers": {
    "social-intel": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/socialinteldev/social-intel-mcp",
        "social-intel-mcp"
      ],
      "env": {
        "PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}
```

Replace `0xYOUR_PRIVATE_KEY` with your Base wallet private key (must have USDC).

After saving, restart Claude Desktop. The `search_leads` tool will appear automatically.

## Cursor

Add the same config to Cursor's MCP settings (Settings > MCP Servers):

```json theme={null}
{
  "social-intel": {
    "command": "uvx",
    "args": [
      "--from", "git+https://github.com/socialinteldev/social-intel-mcp",
      "social-intel-mcp"
    ],
    "env": {
      "PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
    }
  }
}
```

## AgentCash (no wallet setup needed)

The simplest way to use Social Intel API with AI agents. AgentCash handles wallet management and USDC payments:

```bash theme={null}
npx agentcash@latest discover https://socialintel.dev
```

No private key needed — AgentCash manages its own wallet.

## What the MCP tool does

The `search_leads` tool accepts the same parameters as the REST API:

| Parameter       | Type    | Description                               |
| --------------- | ------- | ----------------------------------------- |
| `query`         | string  | Keyword search (name or bio)              |
| `category`      | string  | Business category (Fitness, Beauty, etc.) |
| `country`       | string  | Country code (US, UK, DE, etc.)           |
| `gender`        | string  | "male" or "female"                        |
| `min_followers` | integer | Minimum follower count                    |
| `max_followers` | integer | Maximum follower count                    |
| `limit`         | integer | Results to return (1-100, default 20)     |

### Example prompt

> "Find 20 fitness influencers in the US with at least 10,000 followers"

Claude will automatically call `search_leads` with `category=Fitness`, `country=US`, `min_followers=10000`, `limit=20`.

## Smithery

Social Intel MCP is also listed on [Smithery](https://smithery.ai/servers/socialinteldev/social-intel-mcp) for one-click installation in supported clients.