<h1 align="center">Famulor MCP</h1>

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.

<a href="https://mcp.famulor.io">mcp.famulor.io</a> · <a href="https://app.famulor.de/api-keys">Get an API key</a> · <a href="https://docs.famulor.io">Docs</a>

---

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.

<details open> <summary>Claude Code</summary>

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

Add the server first — authenticate via your API key when prompted. </details>

<details> <summary>Claude Desktop</summary>

Settings > Connectors > Add custom connector

https://mcp.famulor.io/mcp

Copy the URL, paste it into the connector dialog, and sign in when prompted. </details>

<details> <summary>Cursor</summary>

.cursor/mcp.json

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

Add the server first — authenticate via your API key when prompted. </details>

<details> <summary>Windsurf</summary>

~/.codeium/windsurf/mcp_config.json

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

Add the server first — authenticate via your API key when prompted. </details>

.vscode/mcp.json

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

Add the server first — authenticate via your API key when prompted. </details>

<details> <summary>Cline</summary>

Cline extension > MCP Servers > Configure

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

Add the server first — authenticate via your API key when prompted. </details>

<details> <summary>Continue</summary>

~/.continue/config.yaml

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

Add the server first — authenticate via your API key when prompted. </details>

<details> <summary>OpenClaw</summary>

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

Or in ~/.openclaw/openclaw.json:

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

Tip: there is also a ready-made Famulor skill — openclaw skills install famulor-skill. </details>

<details> <summary>Hermes Agent</summary>

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

Or in ~/.hermes/config.yaml:

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

Apply in-session with /reload-mcp. </details>

<details> <summary>npx (stdio, any MCP client)</summary>

Run the server locally via npm — no hosted endpoint needed. Uses your Famulor API key directly:

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

</details>

~/.config/zed/settings.json

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

Add the server first — authenticate via your API key when prompted. </details>

---

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:

| Variable | Required | Value | | ------------- | -------- | ---------------------------------------------------- | | MCP_SECRET | yes | openssl rand -hex 32 — encrypts OAuth tokens. | | MCP_ISSUER | rec. | Your public URL, e.g. https://mcp.example.com. |

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

Famulor

Setup

What you can do

How auth works

Self-hosting

Deploy to Vercel

Local dev

License

Score

Proud of your score? Add this badge to your README.

Famulor FAQ

How do I install Famulor?

Is Famulor an official MCP server?

Related MCP servers

Related guides