Overloop MCP Server

MCP (Model Context Protocol) server for the Overloop AI API v2. Gives AI agents (Claude, Cursor, etc.) tools to manage prospects, organizations, campaigns, sourcings, conversations, and more.

⚠️ Beta Notice: This MCP server is currently in beta. APIs and tool interfaces may change between versions. Please report any issues on GitHub.

Quick Start

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "overloop": {
      "command": "node",
      "args": ["/path/to/overloop-mcp/dist/index.js"],
      "env": {
        "OVERLOOP_API_KEY": "your_api_key_here"
      }
    }
  }
}

For Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "overloop": {
      "command": "node",
      "args": ["/path/to/overloop-mcp/dist/index.js"],
      "env": {
        "OVERLOOP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
OVERLOOP_API_KEY	Yes	Your Overloop API key (find it here)
OVERLOOP_API_URL	No	Override API base URL (default: https://api.overloop.ai)

Available Tools

Prospects

Tool	Description
list_prospects	List prospects with filtering, sorting, search, and pagination
create_prospect	Create a new prospect (with custom fields support)
get_prospect	Retrieve a prospect by ID or email
update_prospect	Update prospect fields
delete_prospect	Permanently delete a prospect

Organizations

Tool	Description
list_organizations	List organizations with filtering and search
create_organization	Create a new organization
get_organization	Retrieve an organization by ID
update_organization	Update organization fields
delete_organization	Permanently delete an organization

Lists

Tool	Description
list_lists	List all prospect lists
create_list	Create a new list
get_list	Retrieve a list by ID
update_list	Update a list name
delete_list	Delete a list

Campaigns

Tool	Description
list_campaigns	List campaigns with filtering and search
create_campaign	Create a campaign with inline steps and sourcing
get_campaign	Retrieve a campaign (expand=steps,sourcing for full details)
update_campaign	Update campaign settings, activate/pause
delete_campaign	Delete a campaign

Campaign Steps

Tool	Description
list_step_types	List all available step types with default configs
list_campaign_steps	List steps in a campaign
add_campaign_step	Add a step to a campaign sequence
get_campaign_step	Retrieve a specific step
update_campaign_step	Update a step's config
remove_campaign_step	Remove a step

Campaign Enrollments

Tool	Description
list_campaign_enrollments	List enrollments for a campaign
enroll_prospect	Enroll a prospect into a campaign
get_campaign_enrollment	Retrieve an enrollment
disenroll_prospect	Disenroll a prospect

Sourcings

Tool	Description
list_sourcing_search_options	Get available values for search criteria fields
list_sourcings	List sourcings with filtering
create_sourcing	Create a sourcing with search criteria
get_sourcing	Retrieve a sourcing
update_sourcing	Update sourcing criteria
delete_sourcing	Delete a sourcing
start_sourcing	Activate a paused sourcing
pause_sourcing	Pause an active sourcing
clone_sourcing	Clone a sourcing

Sending Addresses

Tool	Description
list_sending_addresses	List all connected sending addresses

Conversations

Tool	Description
list_conversations	List conversations with filtering
get_conversation	Retrieve a conversation
update_conversation	Update conversation name
archive_conversation	Archive a conversation
unarchive_conversation	Unarchive a conversation
assign_conversation	Assign to a team member

Users

Tool	Description
get_current_user	Get the API key owner
list_users	List team members
get_user	Retrieve a user by ID

Custom Fields

Tool	Description
list_custom_fields	List custom field definitions

Exclusion List

Tool	Description
list_exclusion_list	List excluded emails/domains
add_to_exclusion_list	Add an email or domain
remove_from_exclusion_list	Remove an exclusion

Account

Tool	Description
get_account	Get account info, plan, and credits

Development

npm install
npm run dev      # watch mode
npm run build    # production build
npm start        # run the server

Project Structure

src/
  index.ts                    # Server entry point
  api.ts                      # Overloop API HTTP client
  tools/
    prospects.ts              # Prospect CRUD
    organizations.ts          # Organization CRUD
    lists.ts                  # List CRUD
    campaigns.ts              # Campaign CRUD
    campaign-steps.ts         # Campaign step management
    campaign-enrollments.ts   # Campaign enrollment management
    sourcings.ts              # Sourcing management
    sending-addresses.ts      # Sending address listing
    conversations.ts          # Conversation management
    users.ts                  # User management
    custom-fields.ts          # Custom field listing
    exclusion-list.ts         # Exclusion list management
    account.ts                # Account info

License

MIT