\n\n---\n\n## Setup\n\nAdd the server in your client, then sign in to Famulor and approve the requested\nworkspace permissions in the browser. Claude and ChatGPT use OAuth; there is no\nAPI key to paste into their connector settings.\n\n> **Server URL**: `https://app.famulor.io/mcp` is the canonical endpoint.\n> `https://mcp.famulor.io/mcp` remains online only for legacy clients.\n\n\nClaude Code\n\n```bash\nclaude mcp add --transport http famulor https://app.famulor.io/mcp\n```\n\nAdd the server first, then complete the browser-based OAuth flow.\n\n\n\nClaude Desktop\n\n**Settings > Connectors > Add custom connector**\n\n```\nhttps://app.famulor.io/mcp\n```\n\nCopy the URL, paste it into the connector dialog, and sign in when prompted.\n\n\n\nCursor\n\n`.cursor/mcp.json`\n\n```json\n{\n \"mcpServers\": {\n \"famulor\": {\n \"type\": \"http\",\n \"url\": \"https://app.famulor.io/mcp\"\n }\n }\n}\n```\n\nAdd the server first, then complete the browser-based OAuth flow.\n\n\n\nWindsurf\n\n`~/.codeium/windsurf/mcp_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"famulor\": {\n \"serverUrl\": \"https://app.famulor.io/mcp\"\n }\n }\n}\n```\n\nAdd the server first, then complete the browser-based OAuth flow.\n\n\n\nVS Code\n\n`.vscode/mcp.json`\n\n```json\n{\n \"servers\": {\n \"famulor\": {\n \"type\": \"http\",\n \"url\": \"https://app.famulor.io/mcp\"\n }\n }\n}\n```\n\nAdd the server first, then complete the browser-based OAuth flow.\n\n\n\nCline\n\n**Cline extension > MCP Servers > Configure**\n\n```json\n{\n \"mcpServers\": {\n \"famulor\": {\n \"url\": \"https://app.famulor.io/mcp\"\n }\n }\n}\n```\n\nAdd the server first, then complete the browser-based OAuth flow.\n\n\n\nContinue\n\n`~/.continue/config.yaml`\n\n```yaml\nmcpServers:\n - name: famulor\n type: streamable-http\n url: \"https://app.famulor.io/mcp\"\n```\n\nAdd the server first, then complete the browser-based OAuth flow.\n\n\n\nOpenClaw\n\n```bash\nopenclaw mcp add famulor --url https://app.famulor.io/mcp --transport streamable-http --auth oauth\nopenclaw mcp login famulor\n```\n\nOr in `~/.openclaw/openclaw.json`:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"famulor\": {\n \"url\": \"https://app.famulor.io/mcp\",\n \"transport\": \"streamable-http\",\n \"auth\": \"oauth\"\n }\n }\n }\n}\n```\n\nTip: there is also a ready-made Famulor skill — `openclaw skills install famulor-skill`.\n\n\n\nHermes Agent\n\n```bash\nhermes mcp add famulor --url https://app.famulor.io/mcp\nhermes mcp login famulor\n```\n\nOr in `~/.hermes/config.yaml`:\n\n```yaml\nmcp_servers:\n famulor:\n url: \"https://app.famulor.io/mcp\"\n auth: oauth\n```\n\nApply in-session with `/reload-mcp`.\n\n\n\nLegacy npx/stdio package\n\nThe earlier npm package is retained for compatibility, but it does not expose\nthe current platform's complete tool catalog. New integrations should use the\nhosted OAuth endpoint above. Existing stdio users can continue with an API key:\n\n```json\n{\n \"mcpServers\": {\n \"famulor\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"famulor-mcp\"],\n \"env\": { \"FAMULOR_API_KEY\": \"your-api-key\" }\n }\n }\n}\n```\n\n\n\n\nZed\n\n`~/.config/zed/settings.json`\n\n```json\n{\n \"context_servers\": {\n \"famulor\": {\n \"args\": [\n \"-y\",\n \"mcp-remote@latest\",\n \"https://app.famulor.io/mcp\"\n ],\n \"command\": \"npx\"\n }\n }\n}\n```\n\nAdd the server first, then complete the browser-based OAuth flow.\n\n\n---\n\n## What you can do\n\nOnce connected, your AI assistant discovers the current public tool catalog\ndirectly from Famulor. The catalog covers, among other areas:\n\n**Assistants** — create, update, delete AI voice agents · list voices, languages, LLM/multimodal models, TTS/STT providers · toggle inbound and conversation-ended webhooks\n\n**History & calls** — inspect cross-channel history and transcripts · make and manage calls\n\n**Campaigns** — create campaigns, manage retry rules and allowed-hours windows · start, stop and delete\n\n**Audience** — manage contacts, tags, segments, suppression and campaign membership\n\n**Knowledge bases** — create knowledge bases · upload website-scraped documents · update / delete\n\n**Telephony** — phone numbers, number verification, assignments and SIP trunks\n\n**Messaging & email** — WhatsApp, Instagram, Messenger, Telegram, Slack, Teams,\nDiscord, Google Chat, X, helpdesk and email conversation workflows\n\n**WhatsApp** — list senders and templates · check 24h session window · send template or freeform messages\n\n**Automations & operations** — flows, routines, dashboards, integrations,\nwebhooks, booking, workspace settings and account administration\n\nAsk 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.\"*\n\n---\n\n## How auth works\n\nThe canonical endpoint implements MCP OAuth discovery, authorization code with\nPKCE, dynamic client registration and Client ID Metadata Documents. Your MCP\nclient opens Famulor in a browser, where you sign in, choose a workspace and\napprove the requested scopes. API keys are also accepted for server-to-server\nclients, but are not the Claude or ChatGPT connector path.\n\n---\n\n## Self-hosting\n\nThe canonical full-catalog server is part of the Famulor application and is not\nimplemented by this legacy standalone package. The code in this repository is\nretained for existing self-hosted and npm users.\n\n### Deploy to Vercel\n\n```bash\ngit clone https://github.com/bekservice/Famulor-MCP.git\ncd Famulor-MCP\nvercel --prod\n```\n\nSet these env vars in the Vercel project:\n\n| Variable | Required | Value |\n| ------------- | -------- | ---------------------------------------------------- |\n| `MCP_SECRET` | yes | `openssl rand -hex 32` — encrypts OAuth tokens. |\n| `MCP_ISSUER` | rec. | Your public URL, e.g. `https://mcp.example.com`. |\n\nThen point your domain at the deployment and you're live. See\n[DEPLOYMENT.md](./DEPLOYMENT.md) for the full guide including stdio mode for\npower users.\n\n### Local dev\n\n```bash\nnpm install\necho \"MCP_SECRET=$(openssl rand -hex 32)\" > .env\nnpm run dev:http\n# server on http://localhost:8787\n```\n\n```bash\n# health\ncurl http://localhost:8787/health\n\n# OAuth metadata\ncurl http://localhost:8787/.well-known/oauth-authorization-server\n```\n\n---\n\n## License\n\nMIT\n",
"bytes": 8267,
"sha": "70d2ba3b81d7ac9bb93e73743f7614750b2598f876ec3700922645361e7ac84b",
"repo_slug": "bekservice/famulor-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_famulor_famulor_mcp_3e9ef7c3/readme"
}
![\"Famulor\"](\"https://app.famulor.io/famulor-mcp-logo.svg\"){kind=logo}
\n![\"GitHub\"](\"https://img.shields.io/badge/GitHub-bekservice%2FFamulor--MCP-181717?logo=github\"){kind=icon}
![\"Famulor\"](\"https://img.shields.io/badge/Famulor-voice%20agents-29C5F6\"){kind=icon}
![\"MCP\"](\"https://img.shields.io/badge/protocol-MCP-blueviolet\"){kind=icon}
![\"Vercel\"](\"https://img.shields.io/badge/hosted%20on-Vercel-000000?logo=vercel\"){kind=icon}
![\"MIT\"](\"https://img.shields.io/badge/license-MIT-green\"){kind=icon}
![\"Famulor](\"https://www.famulor.io/_next/image?url=https%3A%2F%2Fanzpxaqhcbkfyqdk.public.blob.vercel-storage.com%2Fblog-images%2F1766256900040-79z4hr1mztw.webp&w=3840&q=75\")
\n