sipgateio-mcp

Sipgate API MCP Server

Disclaimer: This is an unofficial integration and is not affiliated with, officially maintained, or endorsed by sipgate GmbH. This is a community project that uses the public sipgate API.

MCP server that provides access to the sipgate API, enabling AI assistants to interact with sipgate services including SMS, calls, and account management.

Prerequisites

1. A sipgate account (https://www.sipgate.de/)
2. Personal Access Token credentials from sipgate:
   • Log in to your sipgate account
   • Navigate to "Settings" > "Personal Access Tokens"
   • Create a new token
   • Note down the Token ID and Token

Installation

Claude

Add to your claude_desktop_config.json file:

{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

To find the claude_desktop_config.json file, open the Claude app and go to Settings > Advanced > Open config file.

VS Code

Install the Sipgate API MCP server in VS Code using:

# For VS Code
code --add-mcp '{"name":"sipgate-api","command":"npx","args":["-y","sipgateio-mcp"],"env":{"SIPGATE_TOKEN_ID":"your-token-id","SIPGATE_TOKEN":"your-token"}}'

# For VS Code Insiders
code-insiders --add-mcp '{"name":"sipgate-api","command":"npx","args":["-y","sipgateio-mcp"],"env":{"SIPGATE_TOKEN_ID":"your-token-id","SIPGATE_TOKEN":"your-token"}}'

Cursor

To add this server to Cursor IDE:

1. Navigate to Cursor Settings > MCP
2. Click + Add new Global MCP Server
3. Add the following to your global .cursor/mcp.json file:

{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

Cline

Add to your cline_mcp_settings.json via the Cline MCP Server settings:

{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

Roo Code

Access MCP settings via "Edit MCP Settings" in Roo Code settings:

{
  "mcpServers": {
    "sipgate-api": {
      "command": "npx",
      "args": [
        "-y",
        "sipgateio-mcp"
      ],
      "env": {
        "SIPGATE_TOKEN_ID": "your-token-id",
        "SIPGATE_TOKEN": "your-token"
      }
    }
  }
}

Available Tools

Account Management

• get_account_info: Get information about your sipgate account
• get_user_info: Get information about the authenticated user

Communication

• send_sms: Send SMS messages
• initiate_call: Start phone calls

Phone System

• get_phone_numbers: List associated phone numbers
• get_devices: List associated devices
• get_call_history: Access call history

For detailed tool documentation and parameters, use your AI assistant's help command.

Available Resources

• sipgate://account - Account information
• sipgate://numbers - Phone numbers
• sipgate://history - Call history
• sipgate://devices - Devices

Example Usage

<use_mcp_tool>
<server_name>sipgate-api</server_name>
<tool_name>get_phone_numbers</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

Troubleshooting

Common issues:

1. Authentication Errors:

   • Verify your Token ID and Token are correct
   • Check if the token has the required permissions

2. Installation Issues:

   • Ensure Node.js is installed
   • Try running npx clear-npx-cache before installation

3. Server Connection:

   • Check your internet connection
   • Verify the server is enabled in your MCP settings

For more help, open an issue on GitHub with:

• Your platform and environment details
• Error messages
• Steps to reproduce

Development

Contributions welcome!

License

MIT