mcp server

Famulor

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

Description as published by the maintainer. Source

• version 0.3.1
• active
• voice

active — Most recent push to the repository was 2026-06-13. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.

What this server can do

76 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

create_assistant(mode, name, type, tools, record, fillers, timezone, tool_ids, voice_id, folder_id, label_ids, variables, language_id, webhook_url, llm_model_id, max_duration, ringing_time, speech_speed, ambient_sound, endpoint_type, filler_config, system_prompt, initial_message, llm_temperature, phone_number_id, voice_stability, knowledgebase_id, post_call_schema, voice_similarity, is_webhook_active, wait_for_customer, knowledgebase_mode, voice_mail_message, allow_interruptions, min_interrupt_words, multimodal_model_id, reengagement_prompt, tts_emotion_enabled, ambient_sound_volume, chat_llm_fallback_id, endpoint_sensitivity, max_silence_duration, post_call_evaluation, end_call_on_voicemail, interrupt_sensitivity, reengagement_interval, secondary_language_ids, synthesizer_provider_id, transcriber_provider_id, turn_detection_threshold, enable_noise_cancellation, conversation_ended_retrigger, include_recording_in_webhook, max_initial_silence_duration, conversation_ended_webhook_url, send_webhook_only_on_completed, conversation_inactivity_timeout)

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. Required: name, voice_id, language_id, type, mode, timezone, initial_message, system_prompt.

create_campaign(name, channel, sms_body, timezone, max_retries, allowed_days, assistant_id, retry_interval, fallback_channel, phone_number_ids, schedule_windows, fallback_sms_body, retry_on_voicemail, scheduled_start_at, whatsapp_sender_id, messages_per_minute, whatsapp_template_id, max_calls_in_parallel, text_variable_mapping, allowed_hours_end_time, allowed_hours_start_time, goal_completion_variable, retry_on_goal_incomplete, sms_from_phone_number_id, fallback_variable_mapping, fallback_whatsapp_sender_id, mark_complete_when_no_leads, fallback_whatsapp_template_id, fallback_sms_from_phone_number_id)

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. Required: name.

create_conversation(type, variables, assistant_id)

Start a new chat session with an assistant (widget=paid, test=free). Required: assistant_id.

create_document(url, name, type, links, description, knowledgebase_id, relative_links_limit)

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. Required: knowledgebase_id, name, type.

create_folder(name, color)

Create a folder to group assistants. Assign assistants via the folder_id field on create_assistant / update_assistant. Required: name.

create_knowledgebase(name, description)

Create a new knowledge base. Required: name.

create_label(name, color)

Create a label to tag assistants (e.g. "inbound", "outbound"). Assign via the label_ids field on create_assistant / update_assistant. Required: name.

create_lead(variables, campaign_id, phone_number, allow_dupplicate, secondary_contacts)

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. Required: phone_number, campaign_id.

create_mid_call_tool(name, method, schema, headers, timeout, endpoint, description)

Create a new mid-call HTTP tool. Required: name, description, endpoint, method.

create_sip_trunk(sip_address, country_code, phone_number, sip_password, sip_username, outbound_proxy, sip_trunk_type, sip_calling_format, allowed_inbound_ips, inbound_authorization_type)

Provision a new SIP trunk (extension or DID number). Required: sip_trunk_type, phone_number, sip_username, sip_password, sip_address, sip_calling_format, inbound_authorization_type, country_code.

delete_assistant(id)

Permanently delete an assistant. Cannot be undone. Required: id.

delete_call(call_id)

Delete a call record. Cannot be undone. Required: call_id.

delete_campaign(id)

Delete a campaign. Running campaigns are stopped first. Cannot be undone. Required: id.

delete_document(document_id, knowledgebase_id)

Delete a document from a knowledge base. Required: knowledgebase_id, document_id.

delete_folder(id)

Delete a folder. Assistants inside are NOT deleted — they just become uncategorized. Required: id.

delete_knowledgebase(id)

Delete a knowledge base permanently. Required: id.

delete_label(id)

Delete a label. It is removed from all assistants it was assigned to — the assistants themselves are NOT affected. Required: id.

delete_lead(id)

Delete a lead. Required: id.

delete_mid_call_tool(id)

Delete a mid-call tool. Required: id.

delete_sip_trunk(id)

Delete a SIP trunk by phone-number ID. Required: id.

disable_assistant_conversation_ended_webhook(assistant_id)

Disable conversation-ended (chat) webhook. Required: assistant_id.

disable_assistant_inbound_webhook(assistant_id)

Disable inbound-call webhook notifications. Required: assistant_id.

disable_assistant_webhook(assistant_id)

Disable the post-call webhook for an assistant. Required: assistant_id.

disable_conversation_ai(uuid)

Disable AI replies for a conversation so a human can take over. Required: uuid.

enable_assistant_conversation_ended_webhook(webhook_url, assistant_id)

Enable conversation-ended (chat) webhook for an assistant. Required: assistant_id, webhook_url.

enable_assistant_inbound_webhook(webhook_url, assistant_id)

Enable inbound-call webhook notifications for an assistant. Required: assistant_id, webhook_url.

enable_conversation_ai(uuid)

Re-enable AI replies for a conversation after a human takeover. Required: uuid.

generate_ai_reply(message, variables, assistant_id, customer_identifier)

Generate a context-aware AI reply for a customer message. The system keeps conversation state per customer_identifier (e.g. phone, email, CRM ID). Required: assistant_id, customer_identifier, message.

get_assistants(page, per_page)

List all AI assistants on the Famulor account (paginated). Returns the assistant configurations including their fixed variable names.

get_call(call_id)

Retrieve a single call by ID. Required: call_id.

get_campaign(id)

Get a single campaign by ID. Same fields as list_campaigns. Required: id.

get_conversation(uuid)

Get the full message history of a chat conversation by UUID. Required: uuid.

get_document(document_id, knowledgebase_id)

Get a single document by ID. Required: knowledgebase_id, document_id.

get_knowledgebase(id)

Get a knowledge base by ID. Required: id.

get_languages

List all supported assistant languages.

get_me

Get the authenticated Famulor user profile, including total balance.

get_mid_call_tool(id)

Get a single mid-call tool by ID. Required: id.

get_models(type)

List available LLM / multimodal / dualplex model IDs.

get_outbound_assistants

List all outbound-capable assistants.

get_phone_numbers(type)

List phone numbers eligible to be attached to an assistant (filter by inbound/outbound).

get_sip_trunk(id)

Get a SIP trunk by ID. Required: id.

get_synthesizer_providers

List custom TTS providers selectable on an assistant.

get_transcriber_providers

List custom STT providers selectable on a pipeline assistant.

get_voices(mode, language_id)

List voices compatible with a given engine mode and optional language.

get_whatsapp_senders(status)

List WhatsApp Business senders. status defaults to "online" — pass "all" to see all.

get_whatsapp_session_status(sender_id, recipient_phone)

Check whether a 24h messaging window is open for a recipient. Required: sender_id, recipient_phone.

get_whatsapp_templates(status, sender_id)

List approved templates for a WhatsApp sender (status defaults to "approved"). Required: sender_id.

list_all_phone_numbers

List every phone number on the account (regardless of SMS or subscription status).

list_calls(page, per_page, assistant_id)

List calls with pagination and optional assistant filter.

list_campaigns

List all campaigns you own (call, WhatsApp, SMS), including channel, schedule windows, and fallback config.

list_conversations(type, cursor, per_page, assistant_id, customer_phone, external_identifier, whatsapp_sender_phone)

List conversations across your assistants with cursor pagination and filters.

list_documents(knowledgebase_id)

List documents in a knowledge base. Required: knowledgebase_id.

list_folders(page, per_page)

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.

list_knowledgebases

List all knowledge bases on the account.

list_labels(page, per_page)

List assistant labels (paginated), each with its assistants_count. Labels are tags; an assistant can carry multiple labels across folders.

list_leads(page, per_page)

List leads with pagination.

list_mid_call_tools

List mid-call tools (HTTP integrations callable by an assistant during a call).

list_sip_trunks

List all SIP trunks on the account.

make_call(variables, assistant_id, phone_number)

Initiate an outbound AI phone call with a configured assistant. Required: assistant_id, phone_number.

purchase_phone_number(phone_number)

Purchase a phone number returned by search_phone_numbers (monthly subscription). Required: phone_number.

release_phone_number(id)

Release (cancel) a purchased phone number. Required: id.

search_phone_numbers(contains, country_code)

Search for purchasable phone numbers via the Famulor provider.

send_message(uuid, message)

Send a user message in an existing chat conversation and get the assistant reply. Required: uuid, message.

send_sms(to, body, from)

Send an SMS from one of your Famulor phone numbers (must be SMS-capable). Costs are deducted from your balance. Required: from, to, body.

send_whatsapp_freeform(message, sender_id, recipient_phone)

Send a freeform WhatsApp message. Requires an open 24h session (use get_whatsapp_session_status to check). Required: sender_id, recipient_phone, message.

send_whatsapp_template(sender_id, variables, template_id, recipient_name, recipient_phone)

Send a WhatsApp template message (required when initiating or outside the 24h window). Required: sender_id, template_id, recipient_phone.

update_assistant(id, mode, name, type, tools, record, fillers, timezone, tool_ids, voice_id, folder_id, label_ids, variables, language_id, webhook_url, llm_model_id, max_duration, ringing_time, speech_speed, ambient_sound, endpoint_type, filler_config, system_prompt, initial_message, llm_temperature, phone_number_id, voice_stability, knowledgebase_id, post_call_schema, voice_similarity, is_webhook_active, wait_for_customer, knowledgebase_mode, voice_mail_message, allow_interruptions, min_interrupt_words, multimodal_model_id, reengagement_prompt, tts_emotion_enabled, ambient_sound_volume, chat_llm_fallback_id, endpoint_sensitivity, max_silence_duration, post_call_evaluation, end_call_on_voicemail, interrupt_sensitivity, reengagement_interval, secondary_language_ids, synthesizer_provider_id, transcriber_provider_id, turn_detection_threshold, enable_noise_cancellation, conversation_ended_retrigger, include_recording_in_webhook, max_initial_silence_duration, conversation_ended_webhook_url, send_webhook_only_on_completed, conversation_inactivity_timeout)

Update an existing assistant (partial). Only the fields you send are changed. Required: id.

update_campaign_status(action, campaign_id)

Start or stop a call, WhatsApp, or SMS campaign. Starting validates channel config, schedule, and balance. Required: campaign_id, action.

update_document(name, description, document_id, knowledgebase_id)

Update a document name or description. Content cannot be changed. Required: knowledgebase_id, document_id.

update_folder(id, name, color)

Rename a folder or change its color (partial — only sent fields change). Required: id.

update_knowledgebase(id, name, description)

Rename or describe an existing knowledge base. Required: id.

update_label(id, name, color)

Rename a label or change its color (partial — only sent fields change). Required: id.

update_lead(id, status, variables, campaign_id, phone_number)

Update a lead. Variables are merged with existing ones. Required: id.

update_mid_call_tool(id, name, method, schema, headers, timeout, endpoint, description)

Update a mid-call tool. headers/schema fully replace existing values when provided. Required: id.

update_phone_number(id, nickname)

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. Required: id.

update_sip_trunk(id, sip_address, country_code, phone_number, sip_password, sip_username, outbound_proxy, sip_calling_format, allowed_inbound_ips, inbound_authorization_type)

Update a SIP trunk (partial). Required: id.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.famulor.io/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.famulor.io/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/bekservice/Famulor-MCP
• Website — https://www.famulor.io
• npm: famulor-mcp
• Remote endpoint (streamable-http) — https://mcp.famulor.io/mcp

Related, by what their authors tagged them

• Chamade — last commit 2026-06-04, shares voice-agent
  Voice and chat for AI agents — Discord, Teams, Meet, Slack, Zoom, Telegram, WhatsApp, NC Talk, SIP
• ai.mindola/lens — last commit 2026-08-02, shares chatgpt, voice-assistant
  Create your digital twin: a public page that answers from your own material, with citations.
• io.github.elagerway/magpipe — last commit 2026-06-06, shares voice-assistant
  Manage AI voice agents, calls, SMS, contacts, and phone numbers via Magpipe.
• io.github.DIDA-AI/hotelbooking-ai — last commit 2026-08-04, shares chatgpt, model-context-protocol-servers
  Hotel Booking MCP Server (Global/AI Edition)
• com.xcodebuildmcp/XcodeBuildMCP — last commit 2026-08-05, shares model-context-protocol-servers
  XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
• io.github.930m310n/geomelon-mcp — last commit 2026-07-17, shares model-context-protocol-servers
  MCP server for the Geomelon geographic API — stdio and remote HTTP transports
• io.github.930m310n/mcp — last commit 2026-07-17, shares model-context-protocol-servers
  MCP server for the Geomelon geographic API — stdio and remote HTTP transports
• io.github.AgenTeam-AI-2026/mcp-apollo — last commit 2026-04-06, shares model-context-protocol-servers
  Apollo.io MCP server. Search people, enrich contacts, find emails, research companies.
• io.github.cameroncooke/XcodeBuildMCP — last commit 2026-08-05, shares model-context-protocol-servers
  XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
• io.github.dev-proxy-tools/mcp — last commit 2026-08-04, shares model-context-protocol-servers
  MCP server for Dev Proxy that enables AI assistants to interact with Dev Proxy.

These share tags the maintainers applied themselves, such as voice-agent, chatgpt, voice-assistant, model-context-protocol-servers. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

How the author describes it

Topics the maintainer set on GitHub: ai-calling, chatgpt, claude, cursor, famulor, mcp, mcp-server, model-context-protocol, model-context-protocol-servers, nodejs, phone-automation, typescript, voice-agent, voice-assistant.