Asterisk S2S MCP Server

🌟 Asterisk S2S MCP Server

Node.js TypeScript MCP License NPM

🚀 MCP Server for automated conversational phone calls using Asterisk with Speech-to-Speech

Make phone conversations as easy as a prompt! 📞✨

🏗️ System Architecture

📞 Phone Call Flow

🛠️ MCP Components

🚀 Installation & Usage

🎯 Option 1: NPX (Recommended)

# One command and you're ready! 🚀
npx @grec0/mcp-s2s-asterisk@latest

🔧 Option 2: Global Installation

npm install -g @grec0/mcp-s2s-asterisk
mcp-s2s-asterisk

⚙️ Step-by-Step Configuration

🔐 Environment Variables

# 🌐 Asterisk API URL
export PHONE_API_URL="http://192.168.4.44:8000"

# 🔑 Authentication key
export PHONE_API_KEY="api-key"

# 🔄 Callback URL for results
export MCP_CALLBACK_URL="http://localhost:3000"

📱 MCP Client Configuration

{
  "mcpServers": {
    "asterisk-s2s": {
      "command": "npx",
      "args": ["@grec0/mcp-s2s-asterisk@latest"],
      "env": {
        "PHONE_API_URL": "http://192.168.4.44:8000",
        "PHONE_API_KEY": "api-key",
        "MCP_CALLBACK_URL": "http://localhost:3000"
      }
    }
  }
}

🧰 Available Tools

📞 Calls

🔥 phone_make_call - Make phone calls
📊 phone_get_status - Get call status
❌ phone_cancel_call - Cancel calls
📱 phone_get_active_calls - Active calls

📈 Monitoring

❤️ phone_health_check - System health
📊 phone_get_metrics - Advanced metrics
📝 phone_get_logs - Detailed logs
🗂️ phone_get_conversation_history - History

💡 Use Cases

🔄 Call States

📖 Complete Usage Example

🎬 Scenario: Medical Appointment Confirmation

// 1️⃣ User tells Claude:
"Call María González at 555-0123 to confirm her appointment tomorrow at 3pm"

// 2️⃣ Claude automatically uses:
phone_make_call({
  usuario: "María González",
  telefono: "555-0123", 
  proposito: "Confirm medical appointment for tomorrow 3pm",
  timeout: 60
})

// 3️⃣ Automatic result:
"✅ Call completed. María confirmed her appointment for tomorrow at 3pm. 
She also asked to change the time to 2:30pm if possible."

🚦 Monitoring Dashboard

🔧 Local Development

📋 Requirements

🟢 Node.js >= 18.0.0
📦 npm or pnpm
🔧 TypeScript

🛠️ Quick Setup

# 📥 Clone repository
git clone <repository-url>
cd mcp-s2s-asterisk

# 📦 Install dependencies  
npm install

# 🔨 Build project
npm run build

# 🚀 Run server
npm run start

📋 Available Scripts

Script	Description	Command
🔨	Compile TypeScript	`npm run build`
👀	Development mode	`npm run dev`
🧪	Run tests	`npm run test`
🔍	MCP Inspector	`npm run inspector`
📦	Release patch	`npm run release:patch`

📊 Performance Metrics

🔒 Security & Compliance

🔐 Authentication: Mandatory API Key
🛡️ Encryption: TLS/SSL in transit
📝 Logs: Complete call auditing
🔒 Privacy: Locally processed data
✅ GDPR: Privacy compliance

🤝 Contributing

Do you like the project? We'd love your contribution!

📄 License

MIT License - Use it, modify it, distribute it freely

🌟 Give it a star if you like the project! ⭐

Made with ❤️ by @grec0

Transforming phone communication with conversational AI

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

Tools

View all tools

MCP Server for automated conversational phone calls using Asterisk with Speech-to-Speech capabilities, allowing users to make phone conversations as easily as writing a prompt.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP-Communicator-Telegram
qpd-v
-
security
F
license
-
quality
An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.
Last updated -
1
16
JavaScript
MCP Server
agentico-dev
-
security
A
license
-
quality
MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
13
2
TypeScript
MIT License
Voyp MCP Server
paulotaylor
A
security
A
license
A
quality
The Voyp MCP Server enables AI systems to integrate with VOYP's calling capabilities, allowing for secure telephony actions such as making calls, scheduling appointments, and tracking call statuses through the Model Context Protocol.
Last updated -
7
11
4
JavaScript
MIT License
Fonoster MCP Serverofficial
fonoster
-
security
A
license
-
quality
MCP server that lists applications and phone numbers, and initiates outbound calls via Fonoster.
Last updated -
108
6,652
TypeScript
MIT License

View all related MCP servers

Asterisk S2S MCP Server