Connect Claude, Cursor and Claude Code with MCP

Overview

The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools and data sources. FoxReach hosts an MCP server that gives AI agents like Claude and Cursor direct access to your outreach workspace - no local setup, no scripts, no middleware. Once connected, you can manage leads, campaigns, templates, and email accounts through natural conversation. Ask your AI assistant to “create a campaign to sell SEO services” and it will handle everything for you.

Connect FoxReach to Claude, Cursor and Claude Code (MCP) (1 min)

Claude Desktop using FoxReach MCP to create an SEO campaign

Prerequisites

A FoxReach account with at least one workspace
One of: Claude Desktop, Cursor, or Claude Code

That’s it. No API keys to manage - FoxReach authenticates your MCP connection with OAuth, with FoxReach itself as the identity provider. When you first connect, your AI client opens a browser window on the FoxReach sign-in page. Sign in the way you normally do (Google, an emailed sign-in link, or your email and password), then click Allow on the Connect an AI client screen. The session is then authenticated automatically.

Step 1: Connect Claude Desktop

Open Claude Desktop and go to Settings > Connectors. Click Add custom connector. Enter FoxReach as the name and this as the remote MCP server URL:

https://api.foxreach.io/mcp

Save it. Claude Desktop opens a browser window on FoxReach. Sign in with the account you use for FoxReach and click Allow. Prefer the config file? A plain "url" entry in claude_desktop_config.json does not work for remote servers like FoxReach. Use mcp-remote, a small local proxy, instead (Node.js required). Open Settings > Developer > Edit Config and add:

{
 "mcpServers": {
 "foxreach": {
 "command": "npx",
 "args": ["mcp-remote", "https://api.foxreach.io/mcp"]
 }
 }
}

Save the file, fully quit Claude Desktop, and reopen it. On first use, mcp-remote opens your browser for the same FoxReach sign-in. You’ll know it’s working when you see the MCP tools icon in the chat input area. Click it to see the 36 available FoxReach tools.

Step 2: Connect Cursor

In Cursor, go to Settings > MCP and click Add new MCP server. Configure it with the following JSON:

{
 "foxreach": {
 "url": "https://api.foxreach.io/mcp"
 }
}

Once added, Cursor prompts you to authenticate. Sign in to FoxReach in the browser window and click Allow. The server should then show a green status indicator, and you can use FoxReach tools directly in Cursor’s AI chat.

Step 3: Connect Claude Code

If you use Claude Code (the CLI), run:

claude mcp add foxreach \
 --transport http \
 "https://api.foxreach.io/mcp"

Then run /mcp inside Claude Code to complete the FoxReach sign-in. After signing in, all 36 FoxReach tools are available in your terminal sessions. Other MCP clients, including ChatGPT connectors, work the same way: add https://api.foxreach.io/mcp as a remote MCP server and complete the FoxReach sign-in when the browser window opens. The MCP server does not use static API keys. When your client connects, FoxReach signs you in through its own OAuth flow and then mints a short-lived session key scoped to your personal workspace, so every tool call carries the same permissions and plan limits as the REST API. A few things worth knowing:

Session keys appear under Settings > API Keys as MCP Session (...) entries. They expire on their own after 2 hours and renew automatically while the connection is in use.
Access lasts until you sign out everywhere from Settings or disconnect the client in your AI tool.
MCP sessions are bound to your personal workspace. To let an agent work on a team workspace, use a workspace-scoped API key with the SDKs, the CLI, or the Claude Code plugin instead.
If you connected before September 2026, when sign-in went straight to Google, your client will ask you to sign in to FoxReach once more. This happens one time.

Available Tools

FoxReach exposes 36 tools across seven categories. The same tools power Fenn, the AI co-pilot inside the app, so anything you can ask Fenn you can also ask Claude or Cursor - see Ask Fenn to build a campaign for the in-app version.

Leads

Tool	What it does
`list_leads`	Search and list leads with filters
`get_lead`	Get a lead’s full details
`create_lead`	Create a new lead by email
`import_csv_leads`	Import leads from a CSV uploaded in the FoxReach chat
`update_lead`	Update any field on a lead
`delete_lead`	Remove a lead
`get_lead_activity`	Get a lead’s full activity timeline

Campaigns

Tool	What it does
`list_campaigns`	List all campaigns
`get_campaign`	Get campaign details and sequence steps
`create_campaign`	Create a new draft campaign
`update_campaign`	Update a campaign’s fields
`delete_campaign`	Delete a draft campaign
`start_campaign`	Activate a campaign and begin sending
`pause_campaign`	Pause a running campaign
`resume_campaign`	Resume a paused campaign
`assign_leads_to_campaign`	Add leads to a campaign
`remove_lead_from_campaign`	Remove a lead from a campaign
`assign_accounts_to_campaign`	Assign sending email accounts to a campaign
`remove_account_from_campaign`	Remove a sending account from a campaign

Sequences (Campaign Steps)

Tool	What it does
`list_sequences`	List all steps in a campaign
`create_sequence`	Add an email step to a campaign
`update_sequence`	Edit a sequence step
`delete_sequence`	Remove a step from a campaign

Templates

Tool	What it does
`list_templates`	List all email templates
`get_template`	Get a template’s content
`create_template`	Create a new template
`update_template`	Edit a template
`delete_template`	Remove a template

Email Accounts

Tool	What it does
`list_email_accounts`	List connected email accounts
`get_email_account`	Get account health and warmup status

Analytics

Tool	What it does
`get_workspace_overview`	Workspace-level stats: accounts, campaigns, leads, sends, reply rate
`get_campaign_stats`	Sent, delivered, bounced, replied, and opened counts for a campaign

Inbox

Tool	What it does
`list_inbox_threads`	List inbound reply threads with filters and search
`get_inbox_conversation`	Get the full conversation for an inbox thread
`send_inbox_reply`	Send a reply to an inbox thread
`get_inbox_stats`	Inbox totals, unread count, and category breakdown

Example Workflow 1: Create a Full Campaign

You can set up an entire outreach campaign in a single conversation:

“Create a campaign to sell SEO services. Add an initial outreach email and a follow-up for non-responders after 3 days.”

Claude will call create_campaign, then create_sequence twice - once for the initial email and once for the follow-up with a 3-day delay. All from a single prompt.

Example Workflow 2: Create Leads from a List

You have a list of prospects and want to add them to FoxReach. Just paste them into Claude:

“Add these leads to FoxReach:

sarah@techcorp.io, Sarah Chen, TechCorp, VP Engineering

mike@startupco.com, Mike Johnson, StartupCo, CEO

lisa@enterprise.com, Lisa Wang, Enterprise Ltd, Head of Sales”

Claude will call create_lead for each one, mapping the fields automatically.

Example Workflow 3: Check Campaign Performance

Ask Claude about your campaigns:

“Show me all my active campaigns and their details.”

Claude will call list_campaigns with the active status filter, then get_campaign for each to show you sequence steps and stats.

Example Workflow 4: Draft and Create a Template

Let your AI assistant write outreach copy:

“Write a cold outreach email template for SaaS founders. It should mention a pain point about manual lead management and pitch FoxReach as the solution. Use personalization variables for first name and company. Save it as a template called ‘SaaS Founder Outreach v1’.”

Claude will draft the email with {{first_name}} and {{company}} variables, then call create_template to save it directly to your workspace.

Tips

Start with read-only queries. Use list_leads, list_campaigns, and get_campaign to explore your data before making changes.
Be specific with destructive actions. When asking to delete or pause something, include the name or ID so there’s no ambiguity.
Reconnect if calls start failing. If tool calls stop working after a long session, remove and re-add the FoxReach server in your client to run the FoxReach sign-in again.

Troubleshooting

Tools not showing up? Double-check that the URL in your config is https://api.foxreach.io/mcp. Restart your client after making config changes. Sign-in window doesn’t open? Make sure your default browser is set and that pop-ups aren’t blocked for the sign-in URL. Getting “401 Unauthorized” errors? Your session has expired or the stored tokens are stale. Clear the FoxReach connection in your MCP client and reconnect to sign in again. Getting “No FoxReach account found” errors? The account you signed in with has no FoxReach workspace. Sign in with the email you use for FoxReach, or create an account first. Connection issues? Your client will reconnect automatically if the connection drops. If issues persist, try removing and re-adding the MCP server in your client settings.

What’s Next

Read the MCP server product page for the full picture of what agents can do in FoxReach
Explore the full API documentation for details on every endpoint
Set up webhooks to react to email events in real time
Check out the n8n integration for workflow automation
Questions? Reach out via our contact page

Frequently asked questions

Do I need an API key to use the FoxReach MCP server?

No. The MCP server authenticates with OAuth, with FoxReach itself as the identity provider. Your AI client opens a browser window on the FoxReach sign-in page, you sign in with Google, an emailed sign-in link, or your email and password, and click Allow. FoxReach then mints a short-lived session key behind the scenes. It shows up under Settings > API Keys as an MCP Session entry and expires on its own after 2 hours.

Which AI clients work with the FoxReach MCP server?

Claude Desktop, Cursor, and Claude Code are documented step by step in this guide. Any other client that supports remote MCP servers, including ChatGPT connectors, works the same way: give it https://api.foxreach.io/mcp as the server URL and complete the FoxReach sign-in when the browser window opens.

How many tools does the FoxReach MCP server expose?

36 tools across seven categories: leads, campaigns, sequences, templates, email accounts, analytics, and inbox. They cover the full outreach loop, from creating leads and building a campaign sequence to reading replies and sending a response. The same tools power Fenn, the AI co-pilot inside the FoxReach app.

Can the MCP server work on a shared or team workspace?

Not yet. MCP sessions are bound to the personal workspace of the account you sign in with. If you need an AI agent to work on a team workspace, use a workspace-scoped API key with the Python SDK, the CLI, or the Claude Code plugin instead.

​Overview

​Prerequisites

​Step 1: Connect Claude Desktop

​Step 2: Connect Cursor

​Step 3: Connect Claude Code

​How Sign-In Works

​Available Tools

​Leads

​Campaigns

​Sequences (Campaign Steps)

​Templates

​Email Accounts

​Analytics

​Inbox

​Example Workflow 1: Create a Full Campaign

​Example Workflow 2: Create Leads from a List

​Example Workflow 3: Check Campaign Performance

​Example Workflow 4: Draft and Create a Template

​Tips

​Troubleshooting

​What’s Next

​Frequently asked questions