Social Intel MCP

Social Intel MCP

Instagram influencer discovery for AI agents. Pay per call in USDC viax402 — no API keys, no subscriptions, no sign-up.

socialintel.dev is a data layer for AI agentsrunning influencer-outreach, brand-research, and creator-intelligenceworkflows. This repository ships an MCP server that exposes the same datathrough 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 streamabletransport directly at our hosted server:

https://socialintel.dev/mcp

No install, no pip, no Docker. Your agent's x402 client handles payment oneach tools/call.

If your client needs a stdio wrapper (Claude Desktop on older versions, someCLI 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.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "socialintel": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/socialintel/socialintel-mcp",
        "socialintel-mcp"
      ],
      "env": {
        "SOCIAL_INTEL_API_URL": "https://socialintel.dev"
      }
    }
  }
}

Restart Claude Desktop. search_leads appears in the tool list.

Cursor

Preferences → MCP → add server:

{
  "socialintel": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/socialintel/socialintel-mcp", "socialintel-mcp"]
  }
}

VS Code (with GitHub Copilot or Continue)

.vscode/mcp.json in your workspace:

{
  "servers": {
    "socialintel": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/socialintel/socialintel-mcp", "socialintel-mcp"]
    }
  }
}

Cline (VS Code extension)

Cline auto-detects MCP servers from cline_mcp_settings.json. Add the sameserver block as Claude Desktop above.

Cherry Studio / Zed / any MCP-compatible client

Use the stdio command:

uvx --from git+https://github.com/socialintel/socialintel-mcp socialintel-mcp

Or point the client at the hosted HTTP endpoint if it supports remote MCPs:https://socialintel.dev/mcp

Direct pip install

pip install git+https://github.com/socialintel/socialintel-mcp
SOCIAL_INTEL_API_URL=https://socialintel.dev socialintel-mcp

🛠️ Tools

search_leads

Search Instagram influencers by demographics, location, keyword, orbusiness category.

Each result:

{
  "username": "yoga_with_adriene",
  "full_name": "Adriene Mishler",
  "followers": 10500000,
  "category": "Fitness",
  "bio": "Yoga teacher & filmmaker from Austin TX",
  "public_email": "[email protected]",
  "is_verified": true,
  "is_business": true,
  "gender": "woman"
}

public_email is populated where available — higher on business-verifiedaccounts, lower on personal creator accounts (Instagram platform reality,not a filter we apply).

💰 Payment flow (x402)

Agent payments follow the x402 protocol: a 402 PaymentRequired response carries signed payment requirements; the client signs aUSDC transfer and retries; the server verifies + settles through afacilitator and returns results.

1. Agent calls search_leads(category="Fitness", country="US").
2. Server replies HTTP 402 with extensions.bazaar metadata and acceptsblocks for Base (USDC) and Solana (USDC).
3. If the client runs an x402 client library(x402-httpx,agentcash, the TypeScriptx402 package, etc.), it signs a transfer on either chain and retries.
4. Our server verifies + settles via the CDP facilitator (primary —also catalogues us on agentic.market) orPayAI facilitator (fallback). Results return on the retried call.

Pricing — transparent per-call, no minimums:

Formula: $0.50 + max(0, limit − 20) × $0.01.

Free demo with demo=true skips payment entirely; seeFree demo mode.

🎯 Use cases

Micro-influencer discovery for brand outreach

search_leads(
    category="Beauty",
    country="US",
    min_followers=15000,
    max_followers=200000,
    limit=50,
)

Returns 50 beauty micro-influencers in the US, with public business emailswhere available.

Local creator sourcing (city-level)

search_leads(
    city="Los Angeles",
    category="Food & Beverage",
    min_followers=10000,
    limit=20,
)

LA food creators with 10K+ followers.

Keyword + demographics fusion

search_leads(
    query="personal trainer",
    gender="female",
    country="United Kingdom",
    min_followers=50000,
    max_followers=500000,
)

Female personal trainers in the UK, mid-to-large follower tier.

Free exploration before paying

search_leads(category="Travel", country="Germany", demo=True)

Returns 3 preview results with no payment — perfect for validating filtersbefore spending.

🎛️ Configuration

🧪 Free demo mode

Pass demo=true on any search_leads call. You get up to 3 previewresults, no payment required. The response includes an upgrade_messagepointing at the paid URL so your agent can switch to paid mode aftervalidating filters.

Demo is rate-limited to 5 requests per IP per hour. It reads from ourcache rather than the live data source, so content reflects recent queriesrather than live platform state.

🌐 Multiple transports

• stdio (default) — uvx --from git+... socialintel-mcp
• HTTPS / streamable — connect directly to https://socialintel.dev/mcp
• SSE — the hosted endpoint also serves Server-Sent Events for clientsthat prefer it

The hosted endpoint is the simplest path — zero install, identical tooldefinitions.

🔒 Privacy & telemetry

This server emits one anonymous event per tool call when POSTHOG_API_KEYis set:

• mcp_search_leads — includes only the filter shape (query, country,category, gender, follower range, limit, demo flag) and the resultingrow count. No profile usernames, no emails, no payer addresses.

Events are off by default (no key means no capture). If you enabletelemetry you can point it at your own PostHog project — setPOSTHOG_API_KEY to your own key and the events go to your instance, notours.

Payment-level telemetry (x402 settle, transaction hashes, revenue) iscaptured server-side by socialintel.dev, not by this MCP wrapper.

🗺️ Related

• Website: socialintel.dev
• API docs: socialintel.dev/docs
• OpenAPI spec: socialintel.dev/openapi.json
• x402 protocol: x402.org
• agentcash (x402 CLI/SDK): github.com/merit-systems/agentcash
• Base network (USDC): basescan.org
• CDP Bazaar discovery: agentic.market
• Model Context Protocol: modelcontextprotocol.io

📄 License

MIT — see LICENSE.

🐛 Issues

Bug reports, feature requests, agent-integration questions:github.com/socialintel/socialintel-mcp/issues