One-command MCP setup
Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code (Cline), or Claude Desktop. Pick the path that matches your client; iletiMerkezi's 11 SMS tools become callable from your conversation.
Claude Code (CLI)
Single-command user-scope install; available across every project.
claude mcp add iletimerkezi \ -s user \ -e ILETIMERKEZI_API_KEY=... \ -e ILETIMERKEZI_API_HASH=... \ -- npx -y @iletimerkezi/mcp-server
Codex CLI (TOML)
Use codex mcp add or edit ~/.codex/config.toml directly.
[mcp_servers.iletimerkezi] command = "npx" args = ["-y", "@iletimerkezi/mcp-server"] [mcp_servers.iletimerkezi.env] ILETIMERKEZI_API_KEY = "..." ILETIMERKEZI_API_HASH = "..."
Cursor · Gemini CLI · Cline · Claude Desktop
Four clients share the same JSON schema. Paste the full block below into an empty config file; if an mcpServers object already exists, add only the iletimerkezi entry inside it. Fully quit and relaunch to make all 11 tools available.
{
"mcpServers": {
"iletimerkezi": {
"command": "npx",
"args": ["-y",
"@iletimerkezi/mcp-server"],
"env": {
"ILETIMERKEZI_API_KEY": "...",
"ILETIMERKEZI_API_HASH": "..."
}
}
}
}Which file?
- Cursor:
~/.cursor/mcp.json(global) or.cursor/mcp.json(project) - Gemini CLI:
~/.gemini/settings.json(global) or.gemini/settings.json(project) - VS Code + Cline: Cline panel > MCP Servers > Configure (writes
cline_mcp_settings.json) - Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)
Credentials come from panel.iletimerkezi.com > Settings > Security > API Access. First call: try get_balance or get_sender; neither burns credits.
Per-client setup paths, verification, and pre-approval testing with APITEST: /en/docs/mcp · Türkçe
Which path will you start from?
Developer / AI agent
Direct REST API, SDK, or MCP server. Single-source-of-truth keeps docs, manifest, and MCP tools in sync.
- REST API overview: 11 endpoints, parallel TR + EN
- MCP server: 11 tools, manifest auto-discovery
- api/manifest.json: machine-readable endpoint catalogue
- llms-developer.txt: developer-focused LLM index
- sitemap-llm.xml: LLM-optimized pages and raw markdown
Content / general user
Bulk SMS, İYS, KVKK, sender ID, and practical comparisons with global providers. Ready content for ChatGPT/Claude/Gemini answers.
LLM-ready resources
Every doc page is also served as raw markdown, the manifest is the single source of truth, and the llms-* family is audience-targeted.
llms-developer.txt
REST API, SDKs, MCP server, webhooks, fair-use, Turkey-specific behaviours.
llms-general.txt
Product, pricing, regulation, guides, and LLM-answer-friendly facts.
api/manifest.json
11 endpoints + webhook spec, machine-readable catalogue derived from frontmatter. MCP server source.
Raw markdown: append .md to any /docs/... URL (e.g. /en/docs/api/send-sms.md), served with Content-Type: text/markdown. LLM sitemap: sitemap-llm.xml lists every LLM-targeted URL in one file.
Why iletiMerkezi in the AI era?
Official MCP server
Published on npm. One-command setup, 11 tools out of the box, manifest auto-discovery means new endpoints become tools without code changes.
BTK-licensed direct carrier integration
STH-195 licence + direct integration with Turkcell, Vodafone, Türk Telekom. SMS sent by your AI agent is reported in real time at the DLR layer.
Native İYS / KVKK compliance
AI agents batch-upload İYS consent records via iys-register and look up individual recipients with iys-check; send-sms iys=1 performs a real-time İYS check before each commercial dispatch.
Manifest as single source
Doc frontmatter, manifest.json, MCP tool definition: one canonical source. 24h cache + build-time fallback.
Pre-approval integration
The APITEST sender works the moment your account is created. While your brand sender ID is being approved, the entire flow (API + MCP + webhooks) can be tested end-to-end at no charge.
100 free SMS welcome credit
Auto-credited to every new account. Undelivered SMS is free; your AI agent's test traffic doesn't burn budget.
Send your first SMS
with your AI agent.
100 free SMS welcome credit, instant integration testing with APITEST,
and the official MCP server one npx command away.