socialintel/socialintel-mcp

> Instagram influencer discovery for AI agents. Pay per call in USDC via
> x402 — no API keys, no subscriptions, no sign-up.
**socialintel.dev** is a data layer for AI agents
running influencer-outreach, brand-research, and creator-intelligence
workflows. This repository ships an MCP server that exposes the same data
through the Model Context Protocol so any MCP-compatible client (Claude,
Cursor, VS Code, Cline, …) can call it natively.
📋 Table of Contents
- 🚀 Quickstart — hosted endpoint
- 🔌 MCP clients
- 🛠️ Tools
- 💰 Payment flow (x402)
- 🎯 Use cases
- 🎛️ Configuration
- 🧪 Free demo mode
- 🌐 Multiple transports
- 🔒 Privacy & telemetry
- 🗺️ Related
- 📄 License
🚀 Quickstart — hosted endpoint
**Recommended.** Point any MCP client that speaks HTTP/SSE or streamable
transport directly at our hosted server:
No install, no pip, no Docker. Your agent's x402 client handles payment on
each tools/call.
If your client needs a stdio wrapper (Claude Desktop on older versions, some
CLI clients), see the MCP clients section for uvx /
pip install setups that proxy stdio → HTTPS.
🔌 MCP clients
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop. search_leads appears in the tool list.
Cursor
Preferences → MCP → add server:
VS Code (with GitHub Copilot or Continue)
.vscode/mcp.json in your workspace:
Cline (VS Code extension)
Cline auto-detects MCP servers from cline_mcp_settings.json. Add the same
server block as Claude Desktop above.
Cherry Studio / Zed / any MCP-compatible client
Use the stdio command:
Or point the client at the hosted HTTP endpoint if it supports remote MCPs:
https://socialintel.dev/mcp
Direct pip install
🛠️ Tools
search_leads
Search Instagram influencers by demographics, location, keyword, or
business category.
| Param | Type | What it does |
|---|---|---|
| query | string | Keyword on name/bio (e.g. yoga, travel blogger) |
| country | string | ISO code (US, DE, UK, IN, BR) or full name |
| city | string | City filter (e.g. Los Angeles). Pair with country |
| category | string | Fitness · Beauty · Travel · Food & Beverage · Gaming · Fashion · Lifestyle · Sports · Education · Finance · Tech · … |
| gender | string | male / female (also man / woman) |
| min_followers | int | Floor. 10000 = micro, 100000 = macro |
| max_followers | int | Ceiling. 100000 excludes mega-accounts |
| limit | int | 1–100 (default 20). Price scales with limit |
| demo | bool | true = 3 free preview results, no payment |
Each result:
public_email is populated where available — higher on business-verified
accounts, lower on personal creator accounts (Instagram platform reality,
not a filter we apply).
💰 Payment flow (x402)
Agent payments follow the x402 protocol: a 402 Payment
Required response carries signed payment requirements; the client signs a
USDC transfer and retries; the server verifies + settles through a
facilitator and returns results.
1. Agent calls search_leads(category="Fitness", country="US").
2. Server replies HTTP 402 with extensions.bazaar metadata and accepts
blocks for **Base (USDC)** and **Solana (USDC)**.
3. If the client runs an x402 client library
(x402-httpx,
agentcash, the TypeScript
x402 package, etc.), it signs a transfer on either chain and retries.