Famulor

NPM · FAMULOR-MCP · 2 COMPONENTS · SCANNED AUG 3

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

Available components

remote · mcp.famulor.io 79 npm · famulor-mcp 67

+24 this week 67 67 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (122 of 124), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (122 of 124), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 51 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 5252 tokens (~70/item across 75 items; 75 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage79

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
25% of tool parameters carry a description.Partial
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · famulor-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add io-famulor-famulor-mcp -- npx -y famulor-mcp

# add to Codex CLI

codex mcp add io-famulor-famulor-mcp -- npx -y famulor-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-famulor-famulor-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "famulor-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add io-famulor-famulor-mcp --command npx --arg -y --arg famulor-mcp

# ~/.hermes/config.yaml

mcp_servers:
  io-famulor-famulor-mcp:
    command: "npx"
    args: ["-y", "famulor-mcp"]

// mcp.json

{
  "mcpServers": {
    "io-famulor-famulor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "famulor-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +22
- Install scripts: pass → unverified ▼ security
- Provenance: fail → unverified ▼ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- License: pass → unverified ▼ functional
- Maintenance: pass → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
31 Jul 26 −36
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 +52
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Security disclosure: unverified → fail ▼ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Licence: MIT functional
29 Jul 26 +1
- Security disclosure: fail → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
28 Jul 26 −19
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
27 Jul 26 43

First indexed and scored.

Show 4 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 122 packages

122 packages in the resolved dependency tree · 122 deprecated · 35 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 75 exposed · ~4,746 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

create_assistant ~713

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.

Input Output Examples

Name	Type	Req	Description
allow_interruptions	boolean	—	—
ambient_sound	string	—	—
ambient_sound_volume	number	—	—
chat_llm_fallback_id	integer	—	—
conversation_ended_retrigger	boolean	—	—
conversation_ended_webhook_url	string	—	—
conversation_inactivity_timeout	integer	—	—
enable_noise_cancellation	boolean	—	—
end_call_on_voicemail	boolean	—	—
endpoint_sensitivity	number	—	—
endpoint_type	string	—	—
filler_config	object	—	—
fillers	boolean	—	—
folder_id	integer\|null	—	Folder to place the assistant in (one folder per assistant). See list_folders. Send null to remove.
include_recording_in_webhook	boolean	—	—
initial_message	string	yes	First message spoken at call start (max 200 chars)
interrupt_sensitivity	number	—	—
is_webhook_active	boolean	—	—
knowledgebase_id	integer	—	—
knowledgebase_mode	string	—	—
label_ids	array	—	Label IDs to tag the assistant with (an assistant can carry multiple labels). See list_labels.
language_id	integer	yes	Primary language ID from get_languages
llm_model_id	integer	—	Required for mode=pipeline
llm_temperature	number	—	—
max_duration	integer	—	—
max_initial_silence_duration	integer	—	—
max_silence_duration	integer	—	—
min_interrupt_words	integer	—	—
mode	string	yes	—
multimodal_model_id	integer	—	Required for mode=multimodal/dualplex
name	string	yes	Display name of the assistant (max 255 chars)
phone_number_id	integer\|null	—	—
post_call_evaluation	boolean	—	—
post_call_schema	array	—	—
record	boolean	—	—
reengagement_interval	integer	—	—
reengagement_prompt	string	—	—
ringing_time	integer	—	—
secondary_language_ids	array	—	Additional language IDs the assistant can speak
send_webhook_only_on_completed	boolean	—	—
speech_speed	number	—	—
synthesizer_provider_id	integer	—	—
system_prompt	string	yes	System prompt defining behavior
timezone	string	yes	IANA timezone, e.g. "Europe/Berlin"
tool_ids	array	—	—
tools	array	—	—
transcriber_provider_id	integer	—	—
tts_emotion_enabled	boolean	—	—
turn_detection_threshold	number	—	—
type	string	yes	Assistant call direction
variables	object	—	—
voice_id	integer	yes	Voice ID from get_voices
voice_mail_message	string	—	—
voice_similarity	number	—	—
voice_stability	number	—	—
wait_for_customer	boolean	—	—
webhook_url	string\|null	—	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_campaign ~167

Create a new outbound campaign tied to an outbound-capable assistant.

Input Output Examples

Name	Type	Req	Description
allowed_days	array	—	—
allowed_hours_end_time	string	—	H:i, e.g. "17:00"
allowed_hours_start_time	string	—	H:i, e.g. "09:00"
assistant_id	integer	yes	—
goal_completion_variable	string	—	—
mark_complete_when_no_leads	boolean	—	—
max_calls_in_parallel	integer	—	—
max_retries	integer	—	—
name	string	yes	Campaign name (max 255 chars)
retry_interval	integer	—	—
retry_on_goal_incomplete	boolean	—	—
retry_on_voicemail	boolean	—	—
timezone	string	—	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_conversation ~48

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

Input Output Examples

Name	Type	Req	Description
assistant_id	string	yes	—
type	string	—	—
variables	object	—	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_document ~127

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.

Input Output Examples

Name	Type	Req	Description
description	string	—	Optional, max 255 chars
knowledgebase_id	integer	yes	—
links	array	—	—
name	string	yes	Max 255 chars
relative_links_limit	integer	—	—
type	string	yes	Only website is supported via MCP
url	string	—	Main URL to scrape (required if links is not set)

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_folder ~58

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

Input Output Examples

Name	Type	Req	Description
color	string	—	Badge color
name	string	yes	Folder name (max 255 chars, unique per account)

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_knowledgebase ~40

Create a new knowledge base.

Input Output Examples

Name	Type	Req	Description
description	string	—	Optional, max 255 chars
name	string	yes	Max 255 chars

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_label ~68

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

Input Output Examples

Name	Type	Req	Description
color	string	—	Badge color
name	string	yes	Label name (max 255 chars, unique per account)

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_lead ~108

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.

Input Output Examples

Name	Type	Req	Description
allow_dupplicate	boolean	—	—
campaign_id	integer	yes	—
phone_number	string	yes	E.164 format, e.g. +491234567890
secondary_contacts	array	—	—
variables	—	—	Either an object (key/value pairs matching assistant variables) or an array of such objects.

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_mid_call_tool ~100

Create a new mid-call HTTP tool.

Input Output Examples

Name	Type	Req	Description
description	string	yes	When the AI should use it (max 255 chars)
endpoint	string	yes	HTTPS URL to call
headers	array	—	—
method	string	yes	—
name	string	yes	Tool identifier: lowercase letters and underscores, starts with a letter
schema	array	—	—
timeout	integer	—	Seconds, 1-30

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

create_sip_trunk ~150

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

Input Output Examples

Name	Type	Req	Description
allowed_inbound_ips	array	—	—
country_code	string	yes	ISO 3166-2, e.g. US/GB/DE
inbound_authorization_type	string	yes	—
outbound_proxy	boolean	—	—
phone_number	string	yes	Extension (1-15 chars) or E.164 number
sip_address	string	yes	SIP server without port
sip_calling_format	string	yes	—
sip_password	string	yes	Min 3 chars
sip_trunk_type	string	yes	—
sip_username	string	yes	3-128 chars

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_assistant ~26

Permanently delete an assistant. Cannot be undone.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_call ~25

Delete a call record. Cannot be undone.

Input Output Examples

Name	Type	Req	Description
call_id	string	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_campaign ~23

Delete a campaign. Cannot be undone.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_document ~33

Delete a document from a knowledge base.

Input Output Examples

Name	Type	Req	Description
document_id	integer	yes	—
knowledgebase_id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_folder ~33

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

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_knowledgebase ~23

Delete a knowledge base permanently.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_label ~37

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

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_lead ~20

Delete a lead.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_mid_call_tool ~23

Delete a mid-call tool.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

delete_sip_trunk ~27

Delete a SIP trunk by phone-number ID.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

disable_assistant_conversation_ended_webhook ~31

Disable conversation-ended (chat) webhook.

Input Output Examples

Name	Type	Req	Description
assistant_id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

disable_assistant_inbound_webhook ~27

Disable inbound-call webhook notifications.

Input Output Examples

Name	Type	Req	Description
assistant_id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

disable_assistant_webhook ~28

Disable the post-call webhook for an assistant.

Input Output Examples

Name	Type	Req	Description
assistant_id	integer	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

disable_conversation_ai ~30

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

Input Output Examples

Name	Type	Req	Description
uuid	string	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

enable_assistant_conversation_ended_webhook ~42

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

Input Output Examples

Name	Type	Req	Description
assistant_id	integer	yes	—
webhook_url	string	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

enable_assistant_inbound_webhook ~45

Enable inbound-call webhook notifications for an assistant.

Input Output Examples

Name	Type	Req	Description
assistant_id	integer	yes	—
webhook_url	string	yes	HTTPS URL that receives the webhook payload

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

enable_conversation_ai ~29

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

Input Output Examples

Name	Type	Req	Description
uuid	string	yes	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

generate_ai_reply ~79

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

Input Output Examples

Name	Type	Req	Description
assistant_id	integer	yes	—
customer_identifier	string	yes	Stable per-customer ID; max 255 chars
message	string	yes	—
variables	object	—	—

Name	Type	Req	Description
data	object\|array\|null	—	—
message	string	—	—

No examples provided.

get_assistants ~49

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

Input Output Examples

Name	Type	Req	Description
page	integer	—	—
per_page	integer	—	—

Name	Type	Req	Description
current_page	number	—	—
data	array	—	—
from	number\|null	—	—
last_page	number	—	—
next_page_url	string\|null	—	—
per_page	number	—	—
prev_page_url	string\|null	—	—
to	number\|null	—	—
total	number	—	—

No examples provided.

get_call ~23

Retrieve a single call by ID.

Input Output Examples

Name	Type	Req	Description
call_id	string	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

get_conversation ~28

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

Input Output Examples

Name	Type	Req	Description
uuid	string	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

get_document ~32

Get a single document by ID.

Input Output Examples

Name	Type	Req	Description
document_id	integer	yes	—
knowledgebase_id	integer	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

get_knowledgebase ~24

Get a knowledge base by ID.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

get_languages ~14

List all supported assistant languages.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	array	yes	—

No examples provided.

get_me ~21

Get the authenticated Famulor user profile, including total balance.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
email	string	—	—
name	string	—	—
total_balance	number	—	—

No examples provided.

get_mid_call_tool ~26

Get a single mid-call tool by ID.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

get_models ~28

List available LLM / multimodal / dualplex model IDs.

Input Output Examples

Name	Type	Req	Description
type	string	—	—

Name	Type	Req	Description
result	array	yes	—

No examples provided.

get_outbound_assistants ~19

List all outbound-capable assistants.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	array	yes	—

No examples provided.

get_phone_numbers ~33

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

Input Output Examples

Name	Type	Req	Description
type	string	—	—

Name	Type	Req	Description
result	array	yes	—

No examples provided.

get_sip_trunk ~25

Get a SIP trunk by ID.

Input Output Examples

Name	Type	Req	Description
id	integer	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

get_synthesizer_providers ~23

List custom TTS providers selectable on an assistant.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	array	yes	—

No examples provided.

get_transcriber_providers ~22

List custom STT providers selectable on a pipeline assistant.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	array	yes	—

No examples provided.

get_voices ~36

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

Input Output Examples

Name	Type	Req	Description
language_id	integer	—	—
mode	string	—	—

Name	Type	Req	Description
result	array	yes	—

No examples provided.

get_whatsapp_senders ~40

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

Input Output Examples

Name	Type	Req	Description
status	string	—	—

Name	Type	Req	Description
data	array	yes	—

No examples provided.

get_whatsapp_session_status ~41

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

Input Output Examples

Name	Type	Req	Description
recipient_phone	string	yes	—
sender_id	integer	yes	—

Structured output declared, but exposes no named fields.

No examples provided.

get_whatsapp_templates ~40

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

Input Output Examples

Name	Type	Req	Description
sender_id	integer	yes	—
status	string	—	—

Name	Type	Req	Description
data	array	yes	—

No examples provided.

list_all_phone_numbers ~26

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

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
data	array	yes	—

No examples provided.

list_calls ~40

List calls with pagination and optional assistant filter.

Input Output Examples

Name	Type	Req	Description
assistant_id	string	—	—
page	integer	—	—
per_page	integer	—	—

Name	Type	Req	Description
current_page	number	—	—
data	array	—	—
from	number\|null	—	—
last_page	number	—	—
next_page_url	string\|null	—	—
per_page	number	—	—
prev_page_url	string\|null	—	—
to	number\|null	—	—
total	number	—	—

No examples provided.

list_campaigns ~15

List all outbound calling campaigns.

Input Output Examples

Input schema present but exposes no named parameters.

Name	Type	Req	Description
result	array	yes	—

No examples provided.

list_conversations ~75

List conversations across your assistants with cursor pagination and filters.

Input Output Examples

Name	Type	Req	Description
assistant_id	integer	—	—
cursor	string	—	—
customer_phone	string	—	—
external_identifier	string	—	—
per_page	integer	—	—
type	string	—	—
whatsapp_sender_phone	string	—	—

Name	Type	Req	Description
current_page	number	—	—
data	array	—	—
from	number\|null	—	—
last_page	number	—	—
next_page_url	string\|null	—	—
per_page	number	—	—
prev_page_url	string\|null	—	—
to	number\|null	—	—
total	number	—	—

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug

Day	Score
27 Jul	43
28 Jul	24
29 Jul	25
30 Jul	77
31 Jul	41
1 Aug	41
2 Aug	63
3 Aug	67