overloop-mcp

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.

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