Connect Syft to Your AI Agent

Syft exposes an MCP (Model Context Protocol) server that lets AI assistants query your visitor data, enqueue leads into motions, and build automations.

Pro Plan Required

The Syft MCP server is available exclusively on Pro plans. Upgrade your plan to get started.

Connecting via OAuth (Claude, ChatGPT)

Claude and ChatGPT support OAuth-based connections. No API key needed — you'll authenticate through a secure popup.

Claude

1. Open the Claude app and go to Settings > Connectors > Add custom connector (or Customize > Connectors > + > Add custom connector).
2. Enter the Syft MCP server URL:

   https://app.syftdata.com/api/mcp/mcp

3. A Syft login popup will appear. Sign in with your Syft account.
4. Once authenticated, Syft tools will be available in your Claude conversations.

ChatGPT

1. Go to the ChatGPT Admin Console and click + Create.
2. Set the Name to Syft and the MCP Server URL to:

   https://app.syftdata.com/api/mcp/mcp

3. Leave all other settings as defaults and click Create.
4. Complete the OAuth sign-in when prompted. Syft tools will now be available in your ChatGPT conversations.

Connecting via API Key (Cursor, Windsurf)

For clients that use a JSON configuration file, add the following to your mcpServers config:

{
  "mcpServers": {
    "syft": {
      "url": "https://app.syftdata.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer <your-syft-api-key>"
      }
    }
  }
}

Replace <your-syft-api-key> with your API key from the Syft dashboard at Settings > Data Collection > API Key.

Where to add this config

Client	Config file location
Cursor	Settings > MCP > Add new global MCP server
Windsurf	~/.codeium/windsurf/mcp_config.json

Connecting Claude Code

Claude Code supports MCP servers natively.

1. Add the Syft MCP server from your terminal:

   claude mcp add syft --transport http https://app.syftdata.com/api/mcp/mcp

2. Start Claude Code and run:

   /mcp

3. A browser window will open asking you to authenticate with Syft. Sign in and approve access.

Once approved, syft will appear in /mcp along with its tools (query_entities, lookup_entities, build_motion, etc.) and is ready to use.

Available Tools

Once connected, your AI agent can use the following Syft tools:

Tool	Description
Query Entities	Natural-language search for accounts and contacts. "Find SaaS companies in the US who visited our pricing page."
Lookup Entities	Look up specific contacts by email or companies by domain, including their site activity and session history.
Enqueue Leads	Push a list of leads into an active motion for outreach (LinkedIn, CRM sync, etc.).
Build Motion	Create or edit an automation workflow through a conversational, multi-turn flow.
Get Org Setup	View your ICPs, personas, signals, motions, and connected integrations.
Get Billing Info	Check your credit usage, plan details, and billing history.

tip

See Example Scenarios for step-by-step walkthroughs of what you can do with these tools.