DocumentationAPI Reference

Guides

MCP

Connect Cursor, Claude, ChatGPT, and other MCP clients to Furnace.

Furnace runs a hosted MCP (Model Context Protocol) server so AI clients like Cursor, Claude, and ChatGPT can work with your account directly — create campaigns, add people, read replies, and more. The tools mirror the Client API and update automatically.

Server URL

Add this as a remote (HTTP) MCP server in your client:

https://mcp.getfurnace.io/mcp

You can also copy this from Account Settings → MCP in Furnace.

Connect with OAuth

  1. In your MCP client, add a new remote / HTTP MCP server using the URL above.
  2. When prompted, sign in to Furnace and click Approve.
  3. Your client receives an access token automatically — there is no API key to paste.

Server updates apply on your next session without any change to your MCP config.

What you get

Tools mirror the Furnace Client API — campaigns, flows, leads, inbox threads, webhooks, API keys, and mailbox connect sessions. The API Reference documents the underlying endpoints and objects.

When adding people, tag by name (Hunter, Running Meta Ads) rather than inventing UUIDs. Send email_verification only when you already have a verifier result; never guess ok. Tags are person-level; custom_lead_data is campaign-level personalization.

Advanced: API key

For scripts or clients that do not support OAuth, you can authenticate with an API key instead:

Authorization: Bearer f_your_key_here

Create a key under Account Settings → API keys — see Authentication. Prefer OAuth for interactive MCP clients.