iletimerkezi/iletimerkezi-mcp-server

Model Context Protocol server for the iletiMerkezi SMS API. Lets MCP-aware LLM clients (Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code+Cline, Claude Desktop, …) send SMS, query delivery reports, and manage senders / blacklists through tool calls.
iletiMerkezi is a Turkish, BTK-licensed bulk SMS / OTP / A2P platform. Tool shapes (input schemas, descriptions, doc links) are derived from a canonical API manifest that is built from the official endpoint documentation, so this server stays in lock-step with the live API by design.
Tools
| Tool | API endpoint | Notes |
|---|---|---|
| send_sms | POST /v1/send-sms/json | Send SMS to one or many numbers (transactional 100/sec, bulk 50,000/request) |
| cancel_order | POST /v1/cancel-order/json | Cancel a future-scheduled order before dispatch |
| get_report | POST /v1/get-report/json | Single-order delivery report (summary + per-recipient) |
| get_reports | POST /v1/get-reports/json | Order summary list within a date range (max 10 days) |
| get_balance | POST /v1/get-balance/json | Account balance (TL + SMS credits) |
| get_sender | POST /v1/get-sender/json | Approved sender (header) list |
| get_blacklist | POST /v1/get-blacklist/json | Blocked numbers (paginated) |
| add_blacklist | POST /v1/add-blacklist/json | Block a number (idempotent) |
| delete_blacklist | POST /v1/delete-blacklist/json | Unblock a number |
| iys_register | POST /v1/consent/create/json | Register İYS consent records (batch, max 5000) |
| iys_check | POST /v1/consent/show/json | Look up İYS consent status for a recipient |
Installation
Five clients share the same JSON mcpServers schema; Claude Code and Codex CLI also expose a one-line CLI command. Pick your client below.
Client → config file
| Client | Config file | Format |
|---|---|---|
| **Claude Code** | claude mcp add ... (CLI) · .mcp.json (project) · ~/.claude.json (user) | JSON mcpServers |
| **Cursor** | ~/.cursor/mcp.json (global) · .cursor/mcp.json (project) | JSON mcpServers |
| **Gemini CLI** | ~/.gemini/settings.json (global) · .gemini/settings.json (project) | JSON mcpServers |
| **VS Code + Cline** | cline_mcp_settings.json (Cline → MCP Servers → Configure) | JSON mcpServers |
| **Claude Desktop** | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) | JSON mcpServers |
| **Codex CLI** | codex mcp add ... (CLI) · ~/.codex/config.toml | TOML [mcp_servers.X] |
Shared JSON config (Claude Code, Cursor, Gemini CLI, VS Code+Cline, Claude Desktop)
Add this block to the relevant config file:
Fully quit and relaunch the client. The 11 tools appear under the iletimerkezi server.
Claude Code — single command
User-scope (available across all projects):
Close the current Claude Code session and start a new one. Tools appear as mcp__iletimerkezi__*. Remove with claude mcp remove iletimerkezi -s user.
Codex CLI — TOML format
Via the CLI:
Or edit ~/.codex/config.toml directly:
Verifying
On first use, try get_balance and get_sender — both are read-only, neither burns credits.
Hosted clients (ChatGPT Apps, Gemini App, Claude Web Connectors)