iletiMerkezi MCP Server

by iletimerkezi

Not rated
GitHub

Description

Send SMS, query delivery reports, manage senders / blacklists, register and check İYS (Turkish messaging consent registry) records through the iletiMerkezi BTK-licensed SMS API. 11 tools, runtime-fetched manifest stays in lock-step with the live API. Install: npx -y…

About

Send SMS, query delivery reports, manage senders / blacklists, register and check İYS (Turkish messaging consent registry) records through the iletiMerkezi BTK-licensed SMS API. 11 tools, runtime-fetched manifest stays in lock-step with the live API. Install: npx -y @iletimerkezi/mcp-server

Details

Author
iletimerkezi
Categories
Communication, Other, API, Security

Setup

Install iletiMerkezi MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/iletimerkezi/iletimerkezi-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

Model Context Protocol server for theiletiMerkeziSMS 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 canonicalAPI manifestthat is built from the official endpoint documentation, so this server stays in lock-step with the live API by design.

Five clients share the same JSONmcpServersschema; Claude Code and Codex CLI also expose a one-line CLI command. Pick your client below.

Shared JSON config (Claude Code, Cursor, Gemini CLI, VS Code+Cline, Claude Desktop)

Add this block to the relevant config file:

{ "mcpServers": { "iletimerkezi": { "command": "npx", "args": ["-y", "@iletimerkezi/mcp-server"], "env": { "ILETIMERKEZI_API_KEY": "your-api-key", "ILETIMERKEZI_API_HASH": "your-api-hash" } } } }

Fully quit and relaunch the client. The 11 tools appear under theiletimerkeziserver.

User-scope (available across all projects):

claude mcp add iletimerkezi -s user \ -e ILETIMERKEZI_API_KEY=your-api-key \ -e ILETIMERKEZI_API_HASH=your-api-hash \ -- npx -y @iletimerkezi/mcp-server

Close the current Claude Code session and start a new one. Tools appear asmcp__iletimerkezi__*. Remove withclaude mcp remove iletimerkezi -s user.

codex mcp add iletimerkezi \ --env ILETIMERKEZI_API_KEY=your-api-key \ --env ILETIMERKEZI_API_HASH=your-api-hash \ -- npx -y @iletimerkezi/mcp-server
[mcp_servers.iletimerkezi] command = "npx" args = ["-y", "@iletimerkezi/mcp-server"] [mcp_servers.iletimerkezi.env] ILETIMERKEZI_API_KEY = "your-api-key" ILETIMERKEZI_API_HASH = "your-api-hash"

On first use, tryget_balanceandget_sender— both are read-only, neither burns credits.

Hosted clients (ChatGPT Apps, Gemini App, Claude Web Connectors)

These clients requireremote MCP(HTTPS endpoints) and don't spawn localnpxcommands. This server ships in stdio (local) mode only today. Hosted support is on the roadmap.

Both values come frompanel.iletimerkezi.comSettings → Security → API Access. Copy them as-is — do not hash them yourself; the panel issues a precomputed hash.

You also need to enableAllow API accessunderSettings → Security → Access Permissions, otherwise every call returns401. This is the most common onboarding pitfall; the server's 401 error message points back to this toggle.

For the full authentication contract seehttps://www.iletimerkezi.com/docs/api/authentication.
- Local cacheat~/.cache/iletimerkezi-mcp/manifest.json, valid for 24 hours.
- Live fetchofhttps://www.iletimerkezi.com/api/manifest.json(5s timeout). On success, refreshes the cache atomically.
- Build-time fallback(dist/manifest.fallback.json) shipped with the npm package — the manifest snapshot at the moment ofnpm publish.

This means new endpoints or schema changes published to the manifest propagate to running clients within 24 hours, with nonpm updaterequired. There isno manually written tool schemaanywhere in this repo — the API documentation is the single source of truth.

You can override the manifest URL withILETIMERKEZI_MANIFEST_URLfor staging / preview environments.

Smoke-test the server against the live API with credentials in your shell:

ILETIMERKEZI_API_KEY=... ILETIMERKEZI_API_HASH=... node dist/index.js

This speaks MCP over stdio. Use an MCP client to interact, or pipe a JSON-RPC handshake manually for debugging.

- MCP setup guide:https://www.iletimerkezi.com/docs/mcp(TR) ·/en/docs/mcp(EN)
- Overview:
https://www.iletimerkezi.com/docs/api/overview
- Authentication:
https://www.iletimerkezi.com/docs/api/authentication
- Error codes:
https://www.iletimerkezi.com/docs/api/error-codes
- Manifest (machine-readable):
https://www.iletimerkezi.com/api/manifest.json
- Release notes:
CHANGELOG.md

Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.

Platfone - Receive SMS & Virtual Numbers MCP

Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle

Wavix is a global communications platform offering APIs for voice, SMS, 2FA, and phone numbers. Our MCP server brings these capabilities to AI agents and agentic workflows.

Self-hosted email and SMS platform for AI agents — each agent gets a real email address, phone number, inbox, and API key.

Send SMS messages using the Aligo SMS API.

A read-only MCP server for querying live Twilio data, powered by the CData JDBC Driver.

A public MCP server that gives AI agents access to real UK carrier phone numbers for SMS verification. Agents can rent disposable or rental numbers, pay Lightning invoices, and read incoming SMS, all through standard MCP tool calls with no authentication required.

Get virtual phone numbers for SMS verification, OTP receipt, and number management.

Make voice calls and send SMS messages using the Vonage API.

Make voice calls and send SMS messages using the Vonage API.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.