Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.foxreach.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

FoxReach provides a hosted Model Context Protocol (MCP) server that lets AI agents manage your leads, campaigns, templates, and email accounts through natural language. No local installation required — just connect your AI client to FoxReach using your API key. Supported clients: Claude Desktop, Cursor, Claude Code, and any MCP-compatible client.

​
Prerequisites

  • A FoxReach account with an active workspace
  • An API key (create one in Settings > API Keys)
  • A compatible MCP client installed

​
Setup

​
Claude Desktop

1

Open Claude Desktop settings

Go to Settings > Developer > Edit Config to open your claude_desktop_config.json file.
2

Add the FoxReach MCP server

Add the following to your config file. Replace otr_YOUR_KEY_HERE with your actual API key.
{
  "mcpServers": {
    "foxreach": {
      "url": "https://api.foxreach.io/mcp/sse",
      "headers": {
        "X-API-Key": "otr_YOUR_KEY_HERE"
      }
    }
  }
}
3

Restart Claude Desktop

Close and reopen Claude Desktop. You should see the MCP tools icon (hammer) in the chat input area, confirming the connection.

​
Cursor

1

Open Cursor settings

Go to Settings > MCP in Cursor.
2

Add a new MCP server

Click Add new MCP server and configure it with the following JSON:
{
  "foxreach": {
    "url": "https://api.foxreach.io/mcp/sse",
    "headers": {
      "X-API-Key": "otr_YOUR_KEY_HERE"
    }
  }
}
3

Verify connection

The server should show a green status indicator once connected.

​
Claude Code

Run this command in your terminal: 
claude mcp add foxreach \
  --transport sse \
  --header "X-API-Key: otr_YOUR_KEY_HERE" \
  "https://api.foxreach.io/mcp/sse"

​
Available Tools

FoxReach exposes 19 tools across four resource categories:

​
Leads

ToolDescription
list_leadsList leads with optional search and status filtering
get_leadGet a single lead by ID
create_leadCreate a new lead (deduplicates by email)
update_leadUpdate an existing lead’s fields
delete_leadDelete a lead by ID

​
Campaigns

ToolDescription
list_campaignsList campaigns with optional status filtering
get_campaignGet a campaign by ID, including sequence steps
create_campaignCreate a new campaign in draft status
update_campaignUpdate an existing campaign
delete_campaignDelete a campaign (must be in draft status)
start_campaignStart a draft campaign — begins sending
pause_campaignPause an active campaign

​
Templates

ToolDescription
list_templatesList email templates with optional category filtering
get_templateGet a single template by ID
create_templateCreate a new email template
update_templateUpdate an existing template’s fields
delete_templateDelete a template by ID

​
Email Accounts

ToolDescription
list_email_accountsList connected email accounts
get_email_accountGet an email account with warmup and health info

​
Example Prompts

Once connected, you can use natural language to interact with FoxReach:
  • “List all my active campaigns” — calls list_campaigns with status filter
  • “Create a lead for [email protected] at Acme Inc” — calls create_lead
  • “Pause the campaign named Q1 Outreach” — calls list_campaigns to find it, then pause_campaign
  • “Show me all email templates” — calls list_templates
  • “Draft a cold outreach template and save it” — AI writes the copy, then calls create_template

​
Authentication

The MCP server authenticates using your FoxReach API key, the same key used for the REST API. Pass it via the X-API-Key header — all MCP clients support custom headers. All communication is encrypted via HTTPS.
Create a dedicated API key for MCP usage so you can revoke it independently if needed. Go to Settings > API Keys in the dashboard.

​
Troubleshooting

Tools not appearing in Claude Desktop Make sure the URL and X-API-Key header in your config are correct. Restart Claude Desktop after making changes. “401 Unauthorized” error Your API key is invalid, expired, or revoked. Generate a new one in Settings > API Keys. Connection drops or timeouts SSE connections are long-lived. Some network environments or proxies may drop idle connections. Your MCP client will automatically reconnect. Tool calls returning errors The MCP tools call the FoxReach REST API under the hood. Check the error message — it follows the same error format as the API (e.g., 404 for not found, 409 for duplicate email).