Famulor

🤖 Famulor MCP Server

An MCP (Model Context Protocol) server for the Famulor Voice Agent Platform that enables AI-powered phone calls, assistant management, and call data retrieval through ChatGPT and other MCP-compatible clients.

Demo Video

https://www.youtube.com/watch?v=OMQeTiBNW3Q

Overview

This MCP server provides access to the Famulor Voice Agent Platform, allowing users to make AI-powered phone calls, manage voice assistants, and retrieve call transcripts and recordings - all directly from any MCP-compatible client like ChatGPT Desktop, Claude Desktop, or other MCP-compatible applications.

🌐 Online MCP Server

You can use the hosted MCP server without local installation:

• Server URL: https://mcp.famulor.io
• SSE Endpoint: https://mcp.famulor.io/sse
• Health Check: https://mcp.famulor.io/health

The server is ready to use! For online usage instructions, see the Online Deployment Guide.

Features

• 📞 Make Calls - Initiate AI-powered phone conversations
• 🤖 Manage Assistants - Get and manage your AI assistants
• 📊 Retrieve Call Data - Get transcripts, recordings, and metadata
• 🔒 Secure Authentication - API key-based authentication per user

Prerequisites

• An MCP-compatible client such as:
  • ChatGPT Desktop App (Download)
  • Claude Desktop App (Download)
  • Cursor IDE
  • Any other MCP-compatible client
• A Famulor API key (Get one here)

Note: If you want to run your own local server (Option 2), you'll also need:

• Node.js >= 20.0.0 (Download)

Quick Start

Option 1: Use Online MCP Server (Recommended - No Installation Required)

The easiest way to get started! Use our hosted MCP server at https://mcp.famulor.io.

1. Get Your API Key

1. Go to Famulor API Keys
2. Sign in or create an account
3. Create a new API key
4. Copy the API key (you'll need it in the next step)

2. Configure MCP in Your Client

See the Client-Specific Installation section below for detailed instructions for your MCP client (Cursor, Claude Desktop, ChatGPT Desktop, etc.).

Quick Example Configuration:

{
  "mcpServers": {
    "famulor": {
      "url": "https://mcp.famulor.io/sse",
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Restart Your MCP Client

1. Close your MCP client completely
2. Restart it
3. The MCP server should be automatically connected

4. Test It!

In your MCP client (ChatGPT, Claude, etc.), try asking:

• "Show me my Famulor assistants"
• "List my recent calls"
• "Make a call with assistant [ID] to [phone number]"

---

Option 2: Use Your Own Local Server

If you prefer to run the server locally:

1. Clone the Repository

git clone https://github.com/bekservice/Famulor-MCP.git
cd Famulor-MCP

2. Install Dependencies

npm install

3. Build the Server

npm run build

4. Get Your API Key

1. Go to Famulor API Keys
2. Sign in or create an account
3. Create a new API key
4. Copy the API key (you'll need it in the next step)

5. Configure MCP in Your Client

Create or edit the MCP configuration file for your platform and client. See the Client-Specific Installation section below for detailed instructions.

Example Configuration:

{
  "mcpServers": {
    "famulor": {
      "command": "node",
      "args": [
        "/absolute/path/to/Famulor-MCP/dist/index.js"
      ],
      "env": {
        "FAMULOR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Important:

• Replace /absolute/path/to/Famulor-MCP with the actual absolute path to your cloned repository
• Replace your-api-key-here with your actual Famulor API key
• On Windows, use forward slashes or escaped backslashes in the path

Example paths:

• macOS: /Users/username/Famulor-MCP/dist/index.js
• Windows: C:/Users/username/Famulor-MCP/dist/index.js or C:\\Users\\username\\Famulor-MCP\\dist\\index.js
• Linux: /home/username/Famulor-MCP/dist/index.js

6. Restart Your MCP Client

1. Close your MCP client (ChatGPT Desktop, Claude Desktop, etc.) completely
2. Restart it
3. The MCP server should be automatically connected

7. Test It!

In your MCP client (ChatGPT, Claude, etc.), try asking:

• "Show me my Famulor assistants"
• "List my recent calls"
• "Make a call with assistant [ID] to [phone number]"

Client-Specific Installation

Choose your MCP client below for specific installation instructions:

For Claude Desktop

Important: Claude Desktop currently only supports local command-based MCP server configurations. HTTP/URL-based configurations are not supported, even in the latest version.

Setup Instructions

1. Find your configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the MCP server configuration:

   Open the configuration file and add the following to the mcpServers section:

   {
     "mcpServers": {
       "famulor": {
         "command": "node",
         "args": [
           "/absolute/path/to/Famulor-MCP/dist/index.js"
         ],
         "env": {
           "FAMULOR_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

   Important:

   • Replace /absolute/path/to/Famulor-MCP with your actual absolute path to the repository
   • Replace your-api-key-here with your actual Famulor API key
   • You can get your API key at Famulor API Keys
   • Make sure you've built the server: npm run build
   • The path must be absolute (not relative)

3. Restart Claude Desktop completely for the changes to take effect.

For Cursor

Option 1: Use Online MCP Server (Recommended - No Installation Required)

Global Installation (Recommended):

1. Go to Cursor Settings > Tools & Integrations

2. Click "New MCP Server"

3. This will open ~/.cursor/mcp.json

4. Add the following configuration:

   {
     "mcpServers": {
       "famulor": {
         "type": "http",
         "url": "https://mcp.famulor.io/sse",
         "headers": {
           "Authorization": "Bearer your-api-key-here"
         }
       }
     }
   }
   

   Important:

   • Replace your-api-key-here with your actual Famulor API key
   • The API key must be prefixed with Bearer in the Authorization header
   • You can get your API key at Famulor API Keys

5. Go back to Settings > MCP and click the refresh button

6. The Cursor agent will now be able to use the Famulor MCP tools

Project-Specific Installation:

1. Create or edit .cursor/mcp.json in your project root
2. Add the same configuration as above
3. Restart Cursor or refresh MCP settings

Option 2: Use Your Own Local Server

Global Installation (Recommended):

1. Go to Cursor Settings > Tools & Integrations

2. Click "New MCP Server"

3. This will open ~/.cursor/mcp.json

4. Add the following configuration:

   {
     "mcpServers": {
       "famulor": {
         "command": "node",
         "args": [
           "/absolute/path/to/Famulor-MCP/dist/index.js"
         ],
         "env": {
           "FAMULOR_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

5. Go back to Settings > MCP and click the refresh button

6. The Cursor agent will now be able to use the Famulor MCP tools

Project-Specific Installation:

1. Create or edit .cursor/mcp.json in your project root
2. Add the same configuration as above
3. Restart Cursor or refresh MCP settings

For Claude Code

Option 1: Use Online MCP Server (Recommended - No Installation Required)

To add the online MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "famulor" '{"type":"http","url":"https://mcp.famulor.io/sse","headers":{"Authorization":"Bearer your-api-key-here"}}'

Note:

• Replace your-api-key-here with your actual Famulor API key
• The API key must be prefixed with Bearer in the Authorization header
• You can get your API key at Famulor API Keys

Option 2: Use Your Own Local Server

To add your local MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "famulor" '{"command":"node","args":["/absolute/path/to/Famulor-MCP/dist/index.js"],"env":{"FAMULOR_API_KEY":"your-api-key-here"}}'

Note: Replace /absolute/path/to/Famulor-MCP/dist/index.js with your actual path and your-api-key-here with your actual API key.

See the official Claude Code MCP documentation for more details.

For ChatGPT Desktop App

Option 1: Use Online MCP Server (Recommended - No Installation Required)

1. Find your configuration file:
   • macOS: ~/Library/Application Support/ChatGPT/mcp.json
   • Windows: %APPDATA%\ChatGPT\mcp.json or C:\Users\YourUsername\AppData\Roaming\ChatGPT\mcp.json
   • Linux: `~/.config/ChatGPT/

---

README truncated. View full README on GitHub.