OpenSIPS
OpenSIPS MCP Server
What is OpenSIPS?
OpenSIPS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to opensips mcp server
OpenSIPS MCP Server
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- OpenSIPS MCP Server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx opensipsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use OpenSIPS
The OpenSIPS MCP Server bridges AI assistants with the OpenSIPS VoIP platform, exposing over 236 tools that cover subscriber management, call routing, SBC sessions, dialplan configuration, security auditing, and real-time diagnostics — all accessible through natural language via Claude or any MCP-compatible client.
Prerequisites
- OpenSIPS 3.4 or 3.6 running with the Management Interface (MI) HTTP listener active on port 8888
- Python 3.10+ with pip available on the host running the MCP server
- Network connectivity from the MCP server host to the OpenSIPS MI endpoint
- Optional: MySQL or PostgreSQL client libraries if using a relational database backend
- Claude Desktop, Cursor, or another MCP-compatible AI client installed
Clone and install the server
Clone the OpenSIPS MCP Server repository and install it with pip. Use the optional extras for your database backend — mysql or postgres — if you need database-backed tools beyond the default SQLite.
git clone https://github.com/OpenSIPS/opensips-mcp-server.git
cd opensips-mcp-server
pip install -e .
# For MySQL support:
pip install -e ".[mysql]"
# For PostgreSQL support:
pip install -e ".[postgres]"Configure environment variables
Set the required environment variables to point the server at your OpenSIPS instance. At minimum you need OPENSIPS_MCP_MI_URL. Set OPENSIPS_MCP_ROLE to 'admin' only if you need write operations; otherwise 'readonly' is safer.
export OPENSIPS_MCP_MI_URL="http://your-opensips-host:8888/mi"
export OPENSIPS_MCP_DB_URL="mysql+asyncmy://opensips:opensipsrw@localhost/opensips"
export OPENSIPS_MCP_VERSION="3.6"
export OPENSIPS_MCP_ROLE="readonly"
export OPENSIPS_MCP_TRANSPORT="stdio"Test the server from the command line
Before connecting an AI client, verify the server can reach OpenSIPS by using the built-in CLI mode to list configuration scenarios and check health. No AI client is needed for this step.
# List available config scenarios
opensips-mcp cfg list-scenarios
# Lint an existing config file
opensips-mcp cfg lint /etc/opensips/opensips.cfg --fail-on warning
# Check live instance health
opensips-mcp health_checkAdd the server to Claude Desktop
Edit claude_desktop_config.json to register the opensips-mcp command. The server will launch via stdio each time Claude Desktop starts. Provide your real MI URL and database URL in the env block.
Optional: run with Docker Compose
The repository ships a Docker Compose file that starts OpenSIPS 3.6, MySQL 8.0, and the MCP server together, with the MCP server exposed on port 8080 over streamable-HTTP. This is the fastest way to get a complete demo environment running.
docker compose -f docker/docker-compose.yml up -dOpenSIPS Examples
Client configuration
Claude Desktop configuration connecting to a live OpenSIPS 3.6 instance via stdio transport. Replace the MI URL and DB URL with your actual values.
{
"mcpServers": {
"opensips": {
"command": "opensips-mcp",
"env": {
"OPENSIPS_MCP_MI_URL": "http://your-opensips-host:8888/mi",
"OPENSIPS_MCP_DB_URL": "mysql+asyncmy://opensips:opensipsrw@localhost/opensips",
"OPENSIPS_MCP_VERSION": "3.6",
"OPENSIPS_MCP_ROLE": "readonly"
}
}
}
}Prompts to try
Natural language prompts that exercise the OpenSIPS MCP tools across subscriber management, call control, and configuration tasks.
- "List all registered contacts for user [email protected]"
- "Show me all active dialogs on the SBC"
- "Audit my opensips.cfg for security issues"
- "Generate a residential PBX configuration with MySQL backend"
- "What are the current memory and CPU statistics for the OpenSIPS process?"
- "List all blocked IPs detected by the pike module"Troubleshooting OpenSIPS
Error: cannot connect to MI endpoint at http://127.0.0.1:8888/mi
Verify OpenSIPS is running and the httpd or mi_http module is loaded. Check `opensips -p` for the running process and confirm the mi_http listener is configured in opensips.cfg. Make sure no firewall blocks port 8888.
Tools return 'permission denied' or show no write operations
Set OPENSIPS_MCP_ROLE=admin and ensure OPENSIPS_MCP_READ_ONLY is not set to 'true'. Restart the MCP server after changing environment variables.
Database-backed tools fail with import errors for asyncmy or asyncpg
Reinstall with the correct extra: `pip install -e ".[mysql]"` for MySQL or `pip install -e ".[postgres]"` for PostgreSQL. These async drivers are not installed by default.
Frequently Asked Questions about OpenSIPS
What is OpenSIPS?
OpenSIPS is a Model Context Protocol (MCP) server that opensips mcp server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install OpenSIPS?
Follow the installation instructions on the OpenSIPS GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with OpenSIPS?
OpenSIPS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is OpenSIPS free to use?
Yes, OpenSIPS is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
OpenSIPS Alternatives — Similar Communication Servers
Looking for alternatives to OpenSIPS? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up OpenSIPS in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use OpenSIPS?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.