Didlogic MCP Server

A Model Context Protocol (MCP) server implementation for the Didlogic API. This server allows Large Language Models (LLMs) to interact with Didlogic services through a standardized interface.

Features

• Full access to Didlogic API through MCP tools
• Specialized prompts for common operations
• Balance management tools
• SIP account (sipfriends) management
• IP restriction management
• Purchases management
• Call hisory access
• Transaction history access

Transport Modes

The server supports three transport modes:

STDIO Mode (Default)

For local integration with Claude Desktop or similar tools. Uses the DIDLOGIC_API_KEY environment variable for authentication.

# Using uvx (recommended)
DIDLOGIC_API_KEY=your_key uvx didlogic_mcp

# Using uv run
DIDLOGIC_API_KEY=your_key uv run didlogic_mcp

# As Python module
DIDLOGIC_API_KEY=your_key python -m didlogic_mcp --transport stdio

HTTP Mode

For remote access and web clients. Requires Bearer token in Authorization header for each request.

# Using default port (8000)
python -m didlogic_mcp --transport http

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport http

# Custom host and port
python -m didlogic_mcp --transport http --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport http --log-level DEBUG

Environment Variables:

• PORT - Server port (default: 8000)
• DIDLOGIC_API_URL - Didlogic API base URL (default: https://app.didlogic.com/api)

Note: In HTTP mode, clients must provide their API key as a Bearer token in the Authorization header.

SSE Mode (Server-Sent Events)

For streaming communication with persistent connections. Ideal for real-time updates and streaming scenarios. Requires Bearer token in Authorization header for each request.

# Using default port (8000)
python -m didlogic_mcp --transport sse

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport sse

# Custom host and port
python -m didlogic_mcp --transport sse --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport sse --log-level DEBUG

Environment Variables:

• PORT - Server port (default: 8000)
• DIDLOGIC_API_URL - Didlogic API base URL (default: https://app.didlogic.com/api)

Note: In SSE mode, clients must provide their API key as a Bearer token in the Authorization header for persistent streaming connections.

Installation

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run didlogic_mcp.

Using PIP

Alternatively you can install didlogic_mcp via pip:

pip install didlogic_mcp

After installation, you can run it as a script using:

DIDLOGIC_API_KEY=YOUR_DIDLOGIC_KEY python -m didlogic_mcp

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx

"mcpServers": {
  "didlogic": {
    "command": "uvx",
    "args": ["didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

Using pip installation

"mcpServers": {
  "didlogic": {
    "command": "python",
    "args": ["-m", "didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

Configure for Claude Code

For Claude Code, you can connect to a running SSE server instance:

claude mcp add didlogic --transport sse http://localhost:8000/sse --header "Authorization: Bearer YOUR_DIDLOGIC_API_KEY"

Prerequisites:

1. Start the server in SSE mode: python -m didlogic_mcp --transport sse
2. Run the above command, replacing YOUR_DIDLOGIC_API_KEY with your actual API key
3. The server must be running and accessible at the specified URL

Custom configuration:

• To use a different port: Change http://localhost:8000/sse to match your server's PORT setting
• To connect to a remote server: Replace localhost with the server's hostname or IP address

License

MIT