Famulor

Famulor MCP

Connect Claude, Codex, Cursor, VS Code, and other MCP clients to the complete tenant-safe Famulor platform API.

MCP endpoint · API & MCP settings · Docs

Setup

Add the server in your client, then sign in to Famulor and approve the requested workspace permissions in the browser. Claude and ChatGPT use OAuth; there is no API key to paste into their connector settings.

Server URL: https://app.famulor.io/mcp is the canonical endpoint. https://mcp.famulor.io/mcp remains online only for legacy clients.

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

https://app.famulor.io/mcp

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

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

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

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

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

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

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

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

mcp_servers:
  famulor:
    url: "https://app.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://app.famulor.io/mcp"
      ],
      "command": "npx"
    }
  }
}

What you can do

Once connected, your AI assistant discovers the current public tool catalog directly from Famulor. The catalog covers, among other areas:

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

History & calls — inspect cross-channel history and transcripts · make and manage calls

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

Audience — manage contacts, tags, segments, suppression and campaign membership

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

Telephony — phone numbers, number verification, assignments and SIP trunks

Messaging & email — WhatsApp, Instagram, Messenger, Telegram, Slack, Teams, Discord, Google Chat, X, helpdesk and email conversation workflows

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

Automations & operations — flows, routines, dashboards, integrations, webhooks, booking, workspace settings and account administration

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 canonical endpoint implements MCP OAuth discovery, authorization code with PKCE, dynamic client registration and Client ID Metadata Documents. Your MCP client opens Famulor in a browser, where you sign in, choose a workspace and approve the requested scopes. API keys are also accepted for server-to-server clients, but are not the Claude or ChatGPT connector path.

Self-hosting

The canonical full-catalog server is part of the Famulor application and is not implemented by this legacy standalone package. The code in this repository is retained for existing self-hosted and npm users.

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