iletimerkezi-mcp-server 是 iletiMerkezi 官方提供的 Model Context Protocol（MCP）服务器，用于将 iletiMerkezi 短信 API 接入支持 MCP 的 LLM 客户端。iletiMerkezi 是土耳其的 BTK 许可批量短信 / OTP / A2P 平台。
用途：面向希望在 AI 客户端内直接操作 iletiMerkezi 短信能力的用户，便于通过工具调用完成发送短信、查询送达报告、管理发送者与黑名单，以及注册和检查 İYS（土耳其同意登记系统）记录。
主要能力：该服务器在 MCP 客户端中提供 11 个工具，覆盖发送短信、查询送达报告、管理发送者与黑名单、注册和检查 İYS 记录等。工具形态（输入 schema、描述、文档链接）来自一个依据官方端点文档构建的规范 API 清单，因此服务器设计上会与线上 API 保持同步。
使用方式：支持与该 JSON mcpServers schema 兼容的五种客户端（Claude Code、Cursor、Gemini CLI、VS Code+Cline、Claude Desktop），它们共用同一份 JSON 配置；Claude Code 与 Codex CLI 还提供单行 CLI 命令。配置后需完全退出并重新启动客户端，11 个工具会出现在 iletimerkezi 服务器下。Claude Code 的用户级命令安装后，工具以 mcp__iletimerkezi__* 形式出现，可用 claude mcp remove iletimerkezi -s user 移除；Codex CLI 使用 TOML 格式配置，或直接编辑 ~/.codex/config.toml。首次使用可尝试 get_balance 与 get_sender，两者均为只读、不消耗额度。认证信息来自 panel.iletimerkezi.com → Settings → Security → API Access，需原样复制面板提供的预计算哈希，不要自行哈希；同时需在 Settings → Security → Access Permissions 中启用 Allow API access，否则每次调用都会返回 401。
工具形态更新机制：服务器启动时依次尝试使用本地缓存（~/.cache/iletimerkezi-mcp/manifest.json，有效期 24 小时）；实时拉取 https://www.iletimerkezi.com/api/manifest.json（5 秒超时），成功后原子刷新缓存；最后回退到 npm 包内置的构建期快照（dist/manifest.fallback.json）。因此清单中发布的新端点或 schema 变更可在 24 小时内传播到运行中的客户端，无需 npm 更新。仓库中没有手写工具 schema，API 文档是唯一事实来源。可通过 ILETIMERKEZI_MANIFEST_URL 覆盖清单 URL，用于预发布 / 预览环境。
适用场景：适合需要在其 MCP 客户端内集成土耳其短信发送、送达报告查询、发送者与黑名单管理及 İYS 记录操作的开发者与团队。
限制：目前仅提供 stdio（本地）模式，不支持要求远程 MCP（HTTPS 端点）的托管客户端（如 ChatGPT Apps、Gemini App、Claude Web Connectors），托管支持在路线图中。认证需面板 API Access 与 Allow API access 双项配置，否则返回 401。
许可：MIT，详见 LICENSE。
