# Famulor MCP server

AI voice agents: assistants, calls, campaigns, leads, knowledge bases, WhatsApp, SMS & SIP trunks.

## Links
- Registry page: https://www.getdrio.com/mcp/io-famulor-famulor-mcp
- Repository: https://github.com/bekservice/Famulor-MCP
- Website: https://www.famulor.io

## Install
- Command: `npx -y famulor-mcp`
- Endpoint: https://mcp.famulor.io/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Package: Npm famulor-mcp v0.3.1
- Environment variable: FAMULOR_API_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.famulor.io/mcp

## Tools
- get_me - Get the authenticated Famulor user profile, including total balance. Endpoint: https://mcp.famulor.io/mcp
- get_assistants - List all AI assistants on the Famulor account (paginated). Returns the assistant configurations including their fixed variable names. Endpoint: https://mcp.famulor.io/mcp
- get_outbound_assistants - List all outbound-capable assistants. Endpoint: https://mcp.famulor.io/mcp
- get_phone_numbers - List phone numbers eligible to be attached to an assistant (filter by inbound/outbound). Endpoint: https://mcp.famulor.io/mcp
- get_models - List available LLM / multimodal / dualplex model IDs. Endpoint: https://mcp.famulor.io/mcp
- get_voices - List voices compatible with a given engine mode and optional language. Endpoint: https://mcp.famulor.io/mcp
- get_languages - List all supported assistant languages. Endpoint: https://mcp.famulor.io/mcp
- get_synthesizer_providers - List custom TTS providers selectable on an assistant. Endpoint: https://mcp.famulor.io/mcp
- get_transcriber_providers - List custom STT providers selectable on a pipeline assistant. Endpoint: https://mcp.famulor.io/mcp
- create_assistant - Create a new AI assistant. Required: name, voice_id, language_id, type, mode, timezone, initial_message, system_prompt, and either llm_model_id (pipeline) or multimodal_model_id (multimodal/dualplex). For multimodal/dualplex, knowledgebase_mode must be "function_call" when a knowledgebase is attached. Endpoint: https://mcp.famulor.io/mcp
- update_assistant - Update an existing assistant (partial). Only the fields you send are changed. Endpoint: https://mcp.famulor.io/mcp
- delete_assistant - Permanently delete an assistant. Cannot be undone. Endpoint: https://mcp.famulor.io/mcp
- enable_assistant_inbound_webhook - Enable inbound-call webhook notifications for an assistant. Endpoint: https://mcp.famulor.io/mcp
- disable_assistant_inbound_webhook - Disable inbound-call webhook notifications. Endpoint: https://mcp.famulor.io/mcp
- enable_assistant_conversation_ended_webhook - Enable conversation-ended (chat) webhook for an assistant. Endpoint: https://mcp.famulor.io/mcp
- disable_assistant_conversation_ended_webhook - Disable conversation-ended (chat) webhook. Endpoint: https://mcp.famulor.io/mcp
- disable_assistant_webhook - Disable the post-call webhook for an assistant. Endpoint: https://mcp.famulor.io/mcp
- make_call - Initiate an outbound AI phone call with a configured assistant. Endpoint: https://mcp.famulor.io/mcp
- get_call - Retrieve a single call by ID. Endpoint: https://mcp.famulor.io/mcp
- list_calls - List calls with pagination and optional assistant filter. Endpoint: https://mcp.famulor.io/mcp
- delete_call - Delete a call record. Cannot be undone. Endpoint: https://mcp.famulor.io/mcp
- list_conversations - List conversations across your assistants with cursor pagination and filters. Endpoint: https://mcp.famulor.io/mcp
- get_conversation - Get the full message history of a chat conversation by UUID. Endpoint: https://mcp.famulor.io/mcp
- create_conversation - Start a new chat session with an assistant (widget=paid, test=free). Endpoint: https://mcp.famulor.io/mcp
- send_message - Send a user message in an existing chat conversation and get the assistant reply. Endpoint: https://mcp.famulor.io/mcp
- enable_conversation_ai - Re-enable AI replies for a conversation after a human takeover. Endpoint: https://mcp.famulor.io/mcp
- disable_conversation_ai - Disable AI replies for a conversation so a human can take over. Endpoint: https://mcp.famulor.io/mcp
- list_campaigns - List all campaigns you own (call, WhatsApp, SMS), including channel, schedule windows, and fallback config. Endpoint: https://mcp.famulor.io/mcp
- get_campaign - Get a single campaign by ID. Same fields as list_campaigns. Endpoint: https://mcp.famulor.io/mcp
- create_campaign - Create a draft call, WhatsApp, or SMS campaign. Starts in draft — add leads, then start with update_campaign_status. For channel=call require assistant_id; for whatsapp require whatsapp_sender_id + whatsapp_template_id; for sms require sms_from_phone_number_id + sms_body. Endpoint: https://mcp.famulor.io/mcp
- update_campaign_status - Start or stop a call, WhatsApp, or SMS campaign. Starting validates channel config, schedule, and balance. Endpoint: https://mcp.famulor.io/mcp
- delete_campaign - Delete a campaign. Running campaigns are stopped first. Cannot be undone. Endpoint: https://mcp.famulor.io/mcp
- list_leads - List leads with pagination. Endpoint: https://mcp.famulor.io/mcp
- create_lead - Create a new lead in a campaign. IMPORTANT: variable names come from the associated assistant configuration and are fixed; only their values can be supplied here. Endpoint: https://mcp.famulor.io/mcp
- update_lead - Update a lead. Variables are merged with existing ones. Endpoint: https://mcp.famulor.io/mcp
- delete_lead - Delete a lead. Endpoint: https://mcp.famulor.io/mcp
- send_sms - Send an SMS from one of your Famulor phone numbers (must be SMS-capable). Costs are deducted from your balance. Endpoint: https://mcp.famulor.io/mcp
- list_mid_call_tools - List mid-call tools (HTTP integrations callable by an assistant during a call). Endpoint: https://mcp.famulor.io/mcp
- get_mid_call_tool - Get a single mid-call tool by ID. Endpoint: https://mcp.famulor.io/mcp
- create_mid_call_tool - Create a new mid-call HTTP tool. Endpoint: https://mcp.famulor.io/mcp
- update_mid_call_tool - Update a mid-call tool. headers/schema fully replace existing values when provided. Endpoint: https://mcp.famulor.io/mcp
- delete_mid_call_tool - Delete a mid-call tool. Endpoint: https://mcp.famulor.io/mcp
- list_knowledgebases - List all knowledge bases on the account. Endpoint: https://mcp.famulor.io/mcp
- get_knowledgebase - Get a knowledge base by ID. Endpoint: https://mcp.famulor.io/mcp
- create_knowledgebase - Create a new knowledge base. Endpoint: https://mcp.famulor.io/mcp
- update_knowledgebase - Rename or describe an existing knowledge base. Endpoint: https://mcp.famulor.io/mcp
- delete_knowledgebase - Delete a knowledge base permanently. Endpoint: https://mcp.famulor.io/mcp
- list_documents - List documents in a knowledge base. Endpoint: https://mcp.famulor.io/mcp
- get_document - Get a single document by ID. Endpoint: https://mcp.famulor.io/mcp
- create_document - Add a website (URL-scraped) document to a knowledge base. File uploads (pdf/txt/docx) must use the Famulor dashboard or a direct multipart/form-data call. Endpoint: https://mcp.famulor.io/mcp
- update_document - Update a document name or description. Content cannot be changed. Endpoint: https://mcp.famulor.io/mcp
- delete_document - Delete a document from a knowledge base. Endpoint: https://mcp.famulor.io/mcp
- list_all_phone_numbers - List every phone number on the account (regardless of SMS or subscription status). Endpoint: https://mcp.famulor.io/mcp
- search_phone_numbers - Search for purchasable phone numbers via the Famulor provider. Endpoint: https://mcp.famulor.io/mcp
- purchase_phone_number - Purchase a phone number returned by search_phone_numbers (monthly subscription). Endpoint: https://mcp.famulor.io/mcp
- update_phone_number - Update a phone number you own. Currently sets the nickname — a short human-readable label (max 50 chars) shown next to the number. Send null/empty to clear it. Granted (shared) numbers cannot be updated. Endpoint: https://mcp.famulor.io/mcp
- release_phone_number - Release (cancel) a purchased phone number. Endpoint: https://mcp.famulor.io/mcp
- list_folders - List assistant folders (paginated), each with its assistants_count. Folders group assistants, e.g. per customer or brand; an assistant belongs to at most one folder. Endpoint: https://mcp.famulor.io/mcp
- create_folder - Create a folder to group assistants. Assign assistants via the folder_id field on create_assistant / update_assistant. Endpoint: https://mcp.famulor.io/mcp
- update_folder - Rename a folder or change its color (partial — only sent fields change). Endpoint: https://mcp.famulor.io/mcp
- delete_folder - Delete a folder. Assistants inside are NOT deleted — they just become uncategorized. Endpoint: https://mcp.famulor.io/mcp
- list_labels - List assistant labels (paginated), each with its assistants_count. Labels are tags; an assistant can carry multiple labels across folders. Endpoint: https://mcp.famulor.io/mcp
- create_label - Create a label to tag assistants (e.g. "inbound", "outbound"). Assign via the label_ids field on create_assistant / update_assistant. Endpoint: https://mcp.famulor.io/mcp
- update_label - Rename a label or change its color (partial — only sent fields change). Endpoint: https://mcp.famulor.io/mcp
- delete_label - Delete a label. It is removed from all assistants it was assigned to — the assistants themselves are NOT affected. Endpoint: https://mcp.famulor.io/mcp
- list_sip_trunks - List all SIP trunks on the account. Endpoint: https://mcp.famulor.io/mcp
- get_sip_trunk - Get a SIP trunk by ID. Endpoint: https://mcp.famulor.io/mcp
- create_sip_trunk - Provision a new SIP trunk (extension or DID number). Endpoint: https://mcp.famulor.io/mcp
- update_sip_trunk - Update a SIP trunk (partial). Endpoint: https://mcp.famulor.io/mcp
- delete_sip_trunk - Delete a SIP trunk by phone-number ID. Endpoint: https://mcp.famulor.io/mcp
- get_whatsapp_senders - List WhatsApp Business senders. status defaults to "online" — pass "all" to see all. Endpoint: https://mcp.famulor.io/mcp
- get_whatsapp_templates - List approved templates for a WhatsApp sender (status defaults to "approved"). Endpoint: https://mcp.famulor.io/mcp
- get_whatsapp_session_status - Check whether a 24h messaging window is open for a recipient. Endpoint: https://mcp.famulor.io/mcp
- send_whatsapp_template - Send a WhatsApp template message (required when initiating or outside the 24h window). Endpoint: https://mcp.famulor.io/mcp
- send_whatsapp_freeform - Send a freeform WhatsApp message. Requires an open 24h session (use get_whatsapp_session_status to check). Endpoint: https://mcp.famulor.io/mcp
- generate_ai_reply - Generate a context-aware AI reply for a customer message. The system keeps conversation state per customer_identifier (e.g. phone, email, CRM ID). Endpoint: https://mcp.famulor.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.famulor
- Version: 0.3.1
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 12, 2026
- Source: https://registry.modelcontextprotocol.io