Famulor MCP

Control your Famulor AI voice agents — calls, leads, campaigns, knowledge bases, conversations, WhatsApp, SIP trunks — directly from Claude, Cursor, Windsurf, VS Code and any other MCP-compatible client.

mcp.famulor.io · Get an API key · Docs

Setup

Add the server in your editor, then sign in with your Famulor API key when prompted in the browser.

Server URL: https://mcp.famulor.io/mcp is the canonical endpoint. Both https://mcp.famulor.io/ and https://mcp.famulor.io/mcp work as MCP URLs, so you can paste either into your client's connector dialog.

claude mcp add --transport http famulor https://mcp.famulor.io/mcp

https://mcp.famulor.io/mcp

{
  "mcpServers": {
    "famulor": {
      "type": "http",
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://mcp.famulor.io/mcp"
    }
  }
}

{
  "servers": {
    "famulor": {
      "type": "http",
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "famulor": {
      "url": "https://mcp.famulor.io/mcp"
    }
  }
}

mcpServers:
  - name: famulor
    type: streamable-http
    url: "https://mcp.famulor.io/mcp"

openclaw mcp add famulor --url https://mcp.famulor.io/mcp --transport streamable-http --auth oauth
openclaw mcp login famulor

{
  "mcp": {
    "servers": {
      "famulor": {
        "url": "https://mcp.famulor.io/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

hermes mcp add famulor --url https://mcp.famulor.io/mcp
hermes mcp login famulor

mcp_servers:
  famulor:
    url: "https://mcp.famulor.io/mcp"
    auth: oauth

{
  "mcpServers": {
    "famulor": {
      "command": "npx",
      "args": ["-y", "famulor-mcp"],
      "env": { "FAMULOR_API_KEY": "your-api-key" }
    }
  }
}

{
  "context_servers": {
    "famulor": {
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.famulor.io/mcp"
      ],
      "command": "npx"
    }
  }
}

What you can do

Once connected, your AI assistant can call any of the 66 tools spanning the full Famulor API. A non-exhaustive tour:

Assistants — create, update, delete AI voice agents · list voices, languages, LLM/multimodal models, TTS/STT providers · toggle inbound and conversation-ended webhooks

Calls — make outbound calls · list / get / delete call records

Campaigns — create campaigns, manage retry rules and allowed-hours windows · start, stop and delete

Leads — add leads (incl. secondary contacts) · update status and merge variables · delete

Knowledge bases — create knowledge bases · upload website-scraped documents · update / delete

Phone numbers — search by country and dial pattern · purchase · release · SIP trunk CRUD

Conversations — list, read and reply to chat conversations · enable/disable AI per conversation for human takeover

WhatsApp — list senders and templates · check 24h session window · send template or freeform messages

SMS — send via your purchased numbers

Mid-call tools — register custom HTTP integrations the assistant can call mid-conversation

AI Replies — generate context-aware replies for external chat platforms

Ask the assistant in plain English, e.g. "Create a German sales assistant using GPT-4.1-mini and the Susi voice", "Start campaign #42 and add these 50 leads", "Show me all calls today where the goal wasn't reached."

How auth works

The server speaks the standard MCP OAuth 2.1 flow (RFC 8414 metadata, RFC 7591 Dynamic Client Registration, PKCE S256). Your MCP client opens a browser tab, you paste your Famulor API key, and the client receives an access token that the server encrypts with AES-256-GCM. Your API key never lands in any database — it lives only inside the token your client stores.

Tokens expire after 30 days; your client simply re-prompts.

Self-hosting

The hosted server at https://mcp.famulor.io works out of the box, but you can run your own if you prefer.

Deploy to Vercel

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP
vercel --prod

Set these env vars in the Vercel project:

Then point your domain at the deployment and you're live. See DEPLOYMENT.md for the full guide including stdio mode for power users.

Local dev

npm install
echo "MCP_SECRET=$(openssl rand -hex 32)" > .env
npm run dev:http
# server on http://localhost:8787

# health
curl http://localhost:8787/health

# OAuth metadata
curl http://localhost:8787/.well-known/oauth-authorization-server

License

MIT