Docs / Model Context Protocol (MCP)
AI AGENT STANDARD

Lobby MCP Server

The Model Context Protocol (MCP) server connects Lobby's live creator discovery and intelligence directly to Claude Desktop, Cursor, OpenAI Operator, and custom AI agents.

Quick Actions:

Why Use Lobby with MCP?

forum Direct Chat Interaction
Ask Claude or your agent to "find 10 food creators in Seattle" and get live, verified creator cards with engagement metrics inside the conversation.
smart_toy Autonomous Outreach Generation
AI agents can inspect the creator's recent TikTok videos, extract bio context, and automatically draft hyper-personalized DM and email hooks.

Claude Desktop Quickstart

Add the Lobby MCP configuration to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "lobby": {
      "command": "npx",
      "args": ["-y", "@lobby/mcp-server@latest"],
      "env": {
        "LOBBY_API_KEY": "YOUR_PARTNER_API_TOKEN",
        "LOBBY_BASE_URL": "https://lobby.insightarc.com/api/v1/public/partner"
      }
     }
  }
}
Config File Location:
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor & AI IDE Configuration

In Cursor Settings → Features → MCP, add a new MCP server with the command:

npx -y @lobby/mcp-server@latest

Available MCP Tools (v1.5)

create_or_get_campaign Tool / Inception & Context Memory

Ingests natural language marketing briefs, URLs, or PDF summaries, creates persistent campaign context memory, and decomposes it into validated TikTok topic chips.

Input Arguments
name string (required) Campaign or brand name (e.g., "The Setai Miami Beach").
brief string (required) Detailed product description, target audience, and creator requirements.
location string (optional) Target geography (e.g., "Miami Beach, FL", "Dallas, TX", "Global").
niche string (optional) Creator niche (e.g., "Luxury Travel & Hotels", "Coffee & Cafes").
refine_campaign_context Tool / Stateful Context Evolution

Iteratively evolves campaign context memory across multi-turn Claude/Cursor conversations. Appends new criteria, generates new topic chips, and preserves all previously discovered leads without data loss.

Input Arguments
campaign_slug string (required) Target campaign identifier (e.g. "the-setai-miami").
refinement_text string (required) New prompts, expanded niches, or adjusted criteria to append to campaign memory.
action string (optional) Action mode ("append", "narrow", "expand"). Default: "append".
get_campaign_results Tool / Shortlist & Verification

Retrieves approved candidate creators with 3-video proof justifications, verified direct inboxes, engagement metrics, and ready-to-send personalized pitches.

Input Arguments
campaign_slug string (required) Target campaign identifier.
limit number (optional) Maximum creators to retrieve (default: 100).
export_campaign_csv Tool / Export

Streams structured CSV data formatted with contact columns and AI personalized pitch snippets ready for Instantly or Smartlead cold outreach.

Input Arguments
campaign_slug string (required) Target campaign identifier.
list_campaigns Tool / Query

Lists all active creator discovery and outreach campaigns in your Lobby workspace with summary metrics.

Input Arguments
limit number (optional) Maximum campaigns to return (default: 20).