Skip to main content

​
Famulor MCP Server

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

Connect a client

Setup for ChatGPT, Claude, Cursor, and more

Hosted server

mcp.famulor.io — no install required

GitHub

Source code and deployment

​
Overview

The Famulor MCP server exposes the full Famulor platform as 66 tools your AI assistant can call. Ask in plain language — the model chooses the right tools. Example prompts:
  • “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”
New to MCP? Start with MCP Client setup — add the server URL, then sign in with OAuth and your API key in the browser.

​
Hosted endpoints

EndpointURL
MCP (canonical)https://mcp.famulor.io/mcp
Base URLhttps://mcp.famulor.io/ (also accepted)
Healthhttps://mcp.famulor.io/health
OAuth metadatahttps://mcp.famulor.io/.well-known/oauth-authorization-server
Both https://mcp.famulor.io/ and https://mcp.famulor.io/mcp work as MCP URLs in connector dialogs.

​
What you can do

AreaCapabilities
AssistantsCreate, update, delete AI voice agents · list voices, languages, LLM/multimodal models, TTS/STT providers · toggle inbound and conversation-ended webhooks
CallsMake outbound calls · list / get / delete call records
CampaignsCreate campaigns, retry rules, allowed-hours windows · start, stop, delete
LeadsAdd leads (incl. secondary contacts) · update status and merge variables · delete
Knowledge basesCreate knowledge bases · upload website-scraped documents · update / delete
Phone numbersSearch by country and dial pattern · purchase · release · SIP trunk CRUD
ConversationsList, read, reply to chats · enable/disable AI per conversation (human takeover)
WhatsAppList senders and templates · check 24h session window · send template or freeform messages
SMSSend via your purchased numbers
Mid-call toolsRegister custom HTTP integrations the assistant can call mid-conversation
AI RepliesGenerate context-aware replies for external chat platforms

​
Authentication

The server uses MCP OAuth 2.1 (RFC 8414 metadata, RFC 7591 Dynamic Client Registration, PKCE S256):
  1. Your MCP client opens a browser tab.
  2. You paste your Famulor API key.
  3. The client receives an access token; the server encrypts it 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 re-prompts for sign-in.
Do not put your API key in mcp.json, environment variables in shared configs, or version control. Use OAuth sign-in through your client.

​
Supported clients

  • ChatGPT — custom app with OAuth (setup guide)
  • Claude — Desktop connector and Claude Code CLI (setup guide)
  • Cursor, Windsurf, VS Code, Cline, Continue, Zed
See MCP Client for step-by-step instructions per client.

​
Demo video

​
Self-hosting

The hosted server at https://mcp.famulor.io works out of the box. To run your own instance:

​
Deploy to Vercel

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP
vercel --prod
Set these environment variables in the Vercel project:
VariableRequiredValue
MCP_SECRETyesopenssl rand -hex 32 — encrypts OAuth tokens
MCP_ISSUERrecommendedYour public URL, e.g. https://mcp.example.com
Point your domain at the deployment. See the DEPLOYMENT.md guide in the repository for stdio mode and full details.

​
Local development

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

curl http://localhost:8787/health
curl http://localhost:8787/.well-known/oauth-authorization-server

​
About MCP

Model Context Protocol (MCP) lets AI assistants securely connect to external tools and data. The Famulor MCP server maps platform APIs to MCP tools so clients like ChatGPT and Claude can manage your voice agents on your behalf — after you authenticate with your API key via OAuth.

​
Resources

​
License

MIT — see the GitHub repository for details.
Related pages: MCP Client, Famulor Skill.