Didlogic MCP Server

1# Didlogic MCP Server
2 
3[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/UserAd/didlogic_mcp)](https://archestra.ai/mcp-catalog/userad__didlogic_mcp)
4A 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.
5 
6## Features
7 
8- Full access to Didlogic API through MCP tools
9- Specialized prompts for common operations
10- Balance management tools
11- SIP account (sipfriends) management
12- IP restriction management
13- Purchases management
14- Call hisory access
15- Transaction history access
16 
17## Installation
18 
19### Using uv (recommended)
20 
21When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
22use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *didlogic_mcp*.
23 
24### Using PIP
25 
26Alternatively you can install `didlogic_mcp` via pip:
27 
28```bash
29pip install didlogic_mcp
30```
31 
32After installation, you can run it as a script using:
33 
34```bash
35DIDLOGIC_API_KEY=YOUR_DIDLOGIC_KEY python -m didlogic_mcp
36```
37 
38## Transport Modes
39 
40The server supports three transport modes:
41 
42### STDIO Mode (Default)
43 
44For local integration with Claude Desktop or similar tools. Uses the `DIDLOGIC_API_KEY` environment variable for authentication.
45 
46```bash
47# Using uvx (recommended)
48DIDLOGIC_API_KEY=your_key uvx didlogic_mcp
49 
50# Using uv run
51DIDLOGIC_API_KEY=your_key uv run didlogic_mcp
52 
53# As Python module
54DIDLOGIC_API_KEY=your_key python -m didlogic_mcp --transport stdio
55```
56 
57### HTTP Mode
58 
59For remote access and web clients. Requires Bearer token in `Authorization` header for each request.
60 
61```bash
62# Using default port (8000)
63python -m didlogic_mcp --transport http
64 
65# Custom port via environment variable
66PORT=9000 python -m didlogic_mcp --transport http
67 
68# Custom host and port
69python -m didlogic_mcp --transport http --host 0.0.0.0 --port 9000
70 
71# With debug logging
72python -m didlogic_mcp --transport http --log-level DEBUG
73```
74 
75**Environment Variables:**
76- `PORT` - Server port (default: 8000)
77- `DIDLOGIC_API_URL` - Didlogic API base URL (default: https://app.didlogic.com/api)
78 
79**Note:** In HTTP mode, clients must provide their API key as a Bearer token in the `Authorization` header.
80 
81### SSE Mode (Server-Sent Events)
82 
83For streaming communication with persistent connections. Ideal for real-time updates and streaming scenarios. Requires Bearer token in `Authorization` header for each request.
84 
85```bash
86# Using default port (8000)
87python -m didlogic_mcp --transport sse
88 
89# Custom port via environment variable
90PORT=9000 python -m didlogic_mcp --transport sse
91 
92# Custom host and port
93python -m didlogic_mcp --transport sse --host 0.0.0.0 --port 9000
94 
95# With debug logging
96python -m didlogic_mcp --transport sse --log-level DEBUG
97```
98 
99**Environment Variables:**
100- `PORT` - Server port (default: 8000)
101- `DIDLOGIC_API_URL` - Didlogic API base URL (default: https://app.didlogic.com/api)
102 
103**Note:** In SSE mode, clients must provide their API key as a Bearer token in the `Authorization` header for persistent streaming connections.
104 
105## Configuration
106 
107### Configure for Claude.app
108 
109Add to your Claude settings:
110 
111#### Using uvx
112 
113```json
114"mcpServers": {
115  "didlogic": {
116    "command": "uvx",
117    "args": ["didlogic_mcp"],
118    "env": {
119      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
120    }
121  }
122}
123```
124 
125#### Using pip installation
126 
127```json
128"mcpServers": {
129  "didlogic": {
130    "command": "python",
131    "args": ["-m", "didlogic_mcp"],
132    "env": {
133      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
134    }
135  }
136}
137```
138 
139### Configure for Claude Code
140 
141For Claude Code, you can connect to a running SSE server instance:
142 
143```bash
144claude mcp add didlogic --transport sse http://localhost:8000/sse --header "Authorization: Bearer YOUR_DIDLOGIC_API_KEY"
145```
146 
147**Prerequisites:**
1481. Start the server in SSE mode: `python -m didlogic_mcp --transport sse`
1492. Run the above command, replacing `YOUR_DIDLOGIC_API_KEY` with your actual API key
1503. The server must be running and accessible at the specified URL
151 
152**Custom configuration:**
153- To use a different port: Change `http://localhost:8000/sse` to match your server's PORT setting
154- To connect to a remote server: Replace `localhost` with the server's hostname or IP address
155 
156## License
157 
158MIT
159