oitvoip

oitvoip is an MCP server that provides AI agents with programmatic access to the NetSapiens VoIP platform. It exposes a rich set of MCP tools for user management, phone number management, call center operations, analytics, domain administration, auto attendants, media handling, billing data, and real-time system insights. The server is implemented in TypeScript and ships with a built-in NetSapiens API client, enabling you to perform actions such as searching for users, retrieving user details and devices, listing phone numbers, managing call queues and agents, accessing CDRs and statistics, configuring domains and auto attendants, and more. The server is designed to be configured entirely through your MCP client, with environment variables supplied by the MCP client configuration rather than a separate .env file.

To use oitvoip, configure your MCP client to launch the MCP server using either the npm-installed package or a sourced build. You will provide NetSapiens API credentials and the API URL via environment variables in the MCP client configuration. Once configured, your MCP client can invoke the available MCP tools (commands) described in the server’s documentation, such as search_users, get_user, get_phone_numbers, get_domains, get_call_queues, and others. The server supports TypeScript typings, so you’ll get strong type safety while constructing MCP requests and interpreting responses.

Prerequisites:

• Node.js 18.0.0 or higher
• npm or yarn
• NetSapiens API credentials

Option A: Install from npm (recommended)

1. Install globally: npm install -g oitvoip-mcp-server
2. In your MCP client configuration, add the server with environment variables: { "mcpServers": { "oitvoip": { "command": "oitvoip-mcp-server", "env": { "NETSAPIENS_API_URL": "https://api.ucaasnetwork.com", "NETSAPIENS_API_TOKEN": "your_api_token_here" } } } }

Option B: Build from source

1. Clone the repository and install: git clone https://github.com/OITApps/oitvoip-mcp-server.git cd oitvoip-mcp-server npm install
2. Build the project: npm run build
3. In your MCP client configuration, run the server via node with the built entry: { "mcpServers": { "oitvoip": { "command": "node", "args": ["/path/to/oitvoip-mcp-server/build/index.js"], "env": { "NETSAPIENS_API_URL": "https://api.ucaasnetwork.com", "NETSAPIENS_API_TOKEN": "your_api_token_here" } } } }

Development mode (optional): to enable hot reloading during development, run: npm run dev

Configuration is handled entirely by your MCP client. No separate .env file is required. Ensure you replace placeholder tokens with your real NetSapiens API credentials. Optional environment variables:

• DEBUG: set to true to enable verbose logging
• NETSAPIENS_TIMEOUT: request timeout in milliseconds (default 30000) If you encounter connectivity issues, verify that NETSAPIENS_API_URL is reachable from your MCP client environment and that the API token has the necessary permissions for the operations you intend to perform. When upgrading, rebuild if you pull changes from source to ensure the latest TypeScript types and MCP tool definitions are in use.