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

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

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",
      "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

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. They're grouped by what they help you do — most agents will pick the right one automatically based on your request.

Discover & research

Tool	Description
Query Entities	Natural-language search across your accounts and contacts. "Find SaaS companies in the US who visited our pricing page." Supports sorting/ranking, e.g. "top 50 accounts by sessions."
Lookup Entities	Deterministic lookup of specific contacts by email or companies by domain — returns their site activity, session history, and intent signals.
Find Connections	Surface warm intros from your team's LinkedIn network. "Do we know anyone at Acme?" Searches connections synced via the Syft extension.

Configure your GTM setup

Tool	Description
Get Org Setup	View your ICPs, personas, signals, motions, connected integrations, and available filter fields.
Build ICP	Create or edit an Ideal Customer Profile (company-level targeting) through a guided, multi-turn conversation.
Build Persona	Create or edit a Persona (contact-level targeting: role, seniority, function) conversationally.
Build Signal	Create or edit a behavioral Signal to watch for — pricing-page visits, demo requests, UTM params, LinkedIn engagement, etc.
Create Target List	Build a Target Account List (TAL) — a target, do-not-track, or competitor list of accounts/contacts.
Delete Entity	Delete an ICP, Persona, or Signal. Refuses with a clear error if the entity is still referenced by a motion or list, so you never break a live filter.

Run & automate

Tool	Description
Build Motion	Create or edit an automation workflow (trigger → filters → actions) through a conversational, multi-turn flow.
Enqueue Leads	Push a list of leads into an active motion for outreach (LinkedIn, CRM sync, email campaigns, etc.).
Get Motion Runs	Review motion runs — pending approvals, in-progress, completed, or failed — with action plans and step details.
Manage Motion Run	Approve, reject, or modify a motion run that's waiting for approval (edit message copy or drop steps before it executes).

Setup & admin

Tool	Description
Get Web Tag Snippet	Generate the Syft tracking-tag install snippet and steps for your platform (HTML, GTM, Next.js, Webflow, Framer, WordPress, Mintlify, Docusaurus, GitBook).
Verify Tag Installation	Confirm the Syft tag is installed and firing for your org.
Send Tag Setup Email	Email platform-specific install instructions to a teammate (e.g. the developer who manages your site).
Invite User to Workspace	Send an email invitation for a teammate to join your Syft workspace.
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.