Famulor MCP Server

io.famulor/famulor-mcp

answering

Famulor is answering right now. Last checked 10 min ago. 45 installs a week from npm. It exposes 76 tools. Last commit 13 Jun 2026.

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

Installs per day peak 27 · avg 7 · +18% w/w

a month agotoday

Uptime history 39 hours of history

39 hours agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

225 ms

Response time

average over 24h

Installs / week

npm and PyPI

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 10 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.famulor-mcp]
url = "https://mcp.famulor.io/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 76

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

mid

create_mid_call_tool

Create a new mid-call HTTP tool.

delete_mid_call_tool

Delete a mid-call tool.

get_mid_call_tool

Get a single mid-call tool by ID.

list_mid_call_tools

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

update_mid_call_tool

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

sip

create_sip_trunk

Provision a new SIP trunk (extension or DID number).

delete_sip_trunk

Delete a SIP trunk by phone-number ID.

get_sip_trunk

Get a SIP trunk by ID.

list_sip_trunks

List all SIP trunks on the account.

update_sip_trunk

Update a SIP trunk (partial).

campaign

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.

delete_campaign

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

get_campaign

Get a single campaign by ID. Same fields as list_campaigns.

update_campaign_status

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

disable

disable_assistant_conversation_ended_webhook

Disable conversation-ended (chat) webhook.

disable_assistant_inbound_webhook

Disable inbound-call webhook notifications.

disable_assistant_webhook

Disable the post-call webhook for an assistant.

disable_conversation_ai

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

document

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.

delete_document

Delete a document from a knowledge base.

get_document

Get a single document by ID.

update_document

Update a document name or description. Content cannot be changed.

knowledgebase

create_knowledgebase

Create a new knowledge base.

delete_knowledgebase

Delete a knowledge base permanently.

get_knowledgebase

Get a knowledge base by ID.

update_knowledgebase

Rename or describe an existing knowledge base.

send

send_message

Send a user message in an existing chat conversation and get the assistant reply.

send_sms

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

send_whatsapp_freeform

Send a freeform WhatsApp message. Requires an open 24h session (use get_whatsapp_session_status to check).

send_whatsapp_template

Send a WhatsApp template message (required when initiating or outside the 24h window).

assistant

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.

delete_assistant

Permanently delete an assistant. Cannot be undone.

update_assistant

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

enable

enable_assistant_conversation_ended_webhook

Enable conversation-ended (chat) webhook for an assistant.

enable_assistant_inbound_webhook

Enable inbound-call webhook notifications for an assistant.

enable_conversation_ai

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

folder

create_folder

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

delete_folder

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

update_folder

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

label

create_label

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

delete_label

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

update_label

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

lead

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.

delete_lead

Delete a lead.

update_lead

Update a lead. Variables are merged with existing ones.

phone

get_phone_numbers

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

search_phone_numbers

Search for purchasable phone numbers via the Famulor provider.

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.

get_whatsapp_senders

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

get_whatsapp_session_status

Check whether a 24h messaging window is open for a recipient.

get_whatsapp_templates

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

call

delete_call

Delete a call record. Cannot be undone.

get_call

Retrieve a single call by ID.

conversation

create_conversation

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

get_conversation

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

all

list_all_phone_numbers

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

assistants

get_assistants

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

calls

list_calls

List calls with pagination and optional assistant filter.

campaigns

list_campaigns

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

conversations

list_conversations

List conversations across your assistants with cursor pagination and filters.

documents

list_documents

List documents in a knowledge base.

folders

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.

generate

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).

get

get_me

Get the authenticated Famulor user profile, including total balance.

knowledgebases

list_knowledgebases

List all knowledge bases on the account.

labels

list_labels

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

languages

get_languages

List all supported assistant languages.

leads

list_leads

List leads with pagination.

make

make_call

Initiate an outbound AI phone call with a configured assistant.

models

get_models

List available LLM / multimodal / dualplex model IDs.

outbound

get_outbound_assistants

List all outbound-capable assistants.

purchase

purchase_phone_number

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

release

release_phone_number

Release (cancel) a purchased phone number.

synthesizer

get_synthesizer_providers

List custom TTS providers selectable on an assistant.

transcriber

get_transcriber_providers

List custom STT providers selectable on a pipeline assistant.

voices

get_voices

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

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.famulor.io/mcp	streamable-http	answering	177 ms	10 min ago

Famulor — questions

Answers built from our own checks of this server.

What can Famulor do?

It exposes 76 tools, read directly from the server on our last check. Among them: create_assistant, create_campaign, create_conversation, create_document, create_folder, create_knowledgebase and 70 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Famulor mostly used for?

Its tools cluster around mid, sip and send. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Famulor working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 225 ms. The bar chart above shows every period we have measured.

How do I connect Famulor?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Famulor need an API key?

No. Famulor completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 76 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Famulor?

It answers our handshake in 225 ms on average, which is faster than 57% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

How many people use Famulor?

The npm package famulor-mcp was installed 45 times in the last week. Week over week that is +18%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Famulor open source?

Yes — it is published under the NOASSERTION licence, written in TypeScript, 1 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.