Otipi
Provides ready-to-paste integration code for adding Otipi OTP, SMS, and email endpoints to Express applications, available in TypeScript or JavaScript.
Provides ready-to-paste integration code for adding Otipi OTP, SMS, and email flows to Next.js applications, available in TypeScript or JavaScript.
Provides ready-to-paste integration code for using Otipi OTP, SMS, and email capabilities with Supabase, available in TypeScript or JavaScript.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Otipi send a test OTP to my phone at +972501234567"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
otipi-mcp
MCP server for Otipi, an SMS, email and OTP API for Israel. It lets AI agents (Claude Code, Cursor, Claude Desktop, VS Code) send and verify one-time codes in test mode, check delivery, and generate ready-to-paste integration code for Next.js, Supabase and Express.
Zero runtime dependencies. Plain Node.js (>= 18), stdio transport.
Remote server, nothing to install
The same tools run at https://otipi.co.il/mcp (Streamable HTTP).
Claude.ai, ChatGPT and other apps with connectors: add a custom connector with that address. You sign in to Otipi and allow it (OAuth); the app gets a test key of its own that you can revoke in the dashboard.
Claude Code:
claude mcp add --transport http otipi https://otipi.co.il/mcp --header "Authorization: Bearer sk_test_..."Cursor (
.cursor/mcp.json):{ "mcpServers": { "otipi": { "url": "https://otipi.co.il/mcp", "headers": { "Authorization": "Bearer sk_test_..." } } } }VS Code:
{ "name": "otipi", "type": "http", "url": "https://otipi.co.il/mcp", "headers": { "Authorization": "Bearer sk_test_..." } }
A free test key comes in one click after sign-up at https://otipi.co.il/signup. This npm package is the local alternative for clients that only run stdio servers.
Related MCP server: SandMail — Disposable Email API for AI Agents
Get a key
Sign up at https://otipi.co.il/signup to get a free test key (sk_test_...). Live keys (sk_live_...) send real messages and need a subscription.
The key is read only from the OTIPI_KEY environment variable (OTIPI_API_KEY is accepted as a fallback). OTIPI_BASE_URL is optional and defaults to https://otipi.co.il.
Install
Claude Code
claude mcp add otipi --env OTIPI_KEY=sk_test_... -- npx -y otipi-mcpCursor
.cursor/mcp.json:
{
"mcpServers": {
"otipi": {
"command": "npx",
"args": ["-y", "otipi-mcp"],
"env": { "OTIPI_KEY": "sk_test_..." }
}
}
}Claude Desktop
claude_desktop_config.json:
{
"mcpServers": {
"otipi": {
"command": "npx",
"args": ["-y", "otipi-mcp"],
"env": { "OTIPI_KEY": "sk_test_..." }
}
}
}VS Code
.vscode/mcp.json:
{
"servers": {
"otipi": {
"type": "stdio",
"command": "npx",
"args": ["-y", "otipi-mcp"],
"env": { "OTIPI_KEY": "sk_test_..." }
}
}
}On Windows, if npx is not found by your client, use "command": "cmd", "args": ["/c", "npx", "-y", "otipi-mcp"].
Test-mode flow
With a test key, messages to anyone are only kept in the Otipi log (sandbox). Messages to your own numbers or emails really arrive once you confirm them with a code. Each account gets 5 free test SMS for life.
add_test_recipientwith your number (+9725XXXXXXXX). A 6-digit code is sent to it.The human reads the code on the device.
confirm_test_recipientwith the number and the code.send_test_otpnow really delivers. The result states whether delivery was real or sandbox.verify_otpwith the code the human received (or thetest_codereturned in test mode).
Tools
Tool | What it does |
| Send an OTP (sms or email). Reports real vs sandbox delivery and includes |
| Check a code for a recipient. |
| Start confirming a number or email as a test recipient. |
| Finish confirmation with the 6-digit code. |
| List recipients and the free test SMS left. |
| Look up a message and its event timeline. |
| Offline, no key needed. Code for |
Tool failures are returned as normal results with isError: true and a plain explanation of what to do next.
Security notes
The API key lives in the environment only. It is never printed, logged or returned by any tool.
Use free
sk_test_keys for development. Do not putsk_live_keys into shared config files or repositories.Requests use a 15 second timeout, no redirects, and
Authorization: Bearerover HTTPS.stdout carries only JSON-RPC messages; diagnostics go to stderr.
Development
npm testThe tests spawn the server and drive it over stdio against a local fake Otipi API. No network access is needed.
Publishing (for maintainers)
Not automated. Dmitry runs these by hand.
The GitHub owner is set to planetebatel-cloud in package.json (mcpName, repository) and server.json (name, repository). The mcpName must start with io.github.<github-username>/ for GitHub login, so adjust all of these together if the repository lives under a different owner.
npm publish --access public
mcp-publisher login github
mcp-publisher publishKeep version in package.json and server.json (both the top level and the package entry) identical on every release. node scripts/validate-server-json.mjs <schema.json> checks server.json against the schema from https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json.
License
MIT
Available Tools
7 toolsadd_test_recipientAInspect
Start confirming a phone number or email as a test recipient. A 6-digit code is sent to it. Once confirmed, test messages to that recipient really arrive (otherwise test mode only logs them in a sandbox). Only add numbers or emails that belong to the account owner. Test key (sk_test_) only. After calling this, ask the human for the 6-digit code they received and call confirm_test_recipient.
Inputs: to (required).
check_delivery_statusAInspect
Look up a sent message by message_id (returned by send_test_otp) and report its status (queued, sent, delivered, opened, failed, bounced), whether test delivery was real or sandbox, and the event timeline.
Inputs: message_id (required).
confirm_test_recipientAInspect
Finish confirming a test recipient with the 6-digit code the human received after add_test_recipient. On success, send_test_otp to this recipient is really delivered.
Inputs: to (required), code (required).
get_integration_snippetAInspect
Return ready-to-paste code for adding Otipi phone/OTP login to a project: Next.js App Router (API routes plus a client component), Supabase Auth (Send SMS hook setup plus client code) or Express. Works offline and does not need an API key. Use it when the user wants to integrate SMS verification or 2FA for Israeli numbers.
Inputs: framework (required), language.
list_test_recipientsAInspect
List the confirmed and pending test recipients of this account and how many of the 5 free test SMS are left. Call it before send_test_otp to know whether a number will really receive messages.
Inputs: no named parameters.
send_test_otpAInspect
Send a one-time verification code (OTP) by SMS or email to a phone number in Israel using Otipi, in test mode. Use this to try the login/2FA flow end to end. With a test key the message really arrives ONLY if the recipient was confirmed with add_test_recipient + confirm_test_recipient; otherwise it is kept in the sandbox log and nothing is delivered. The result says which case happened and includes test_code when available, so you can verify it with verify_otp. Each account has 5 free test SMS for life.
Inputs: to (required), app (required), channel, language.
verify_otpAInspect
Check a one-time code that was sent with send_test_otp (or the live API) for a phone number or email. Returns valid true/false and, when false, the reason (wrong_code, expired_or_missing, too_many_attempts).
Inputs: to (required), code (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a distinct role: sending vs verifying OTPs, recipient onboarding (add/confirm/list), delivery lookup, and code snippet retrieval. The only mild friction is that verify_otp and confirm_test_recipient both 'check a code', but the descriptions clearly separate end-user OTP verification from test-recipient confirmation.
All names are snake_case and verb-first (verify_, send_, add_, confirm_, list_, check_, get_) with clear object nouns. The multi-word object forms (test_otp, test_recipient, delivery_status, integration_snippet) are used consistently.
Seven tools is well-scoped for a test-mode OTP/integration workflow, with each tool earning its place across recipient setup, sending, verifying, status, and code snippets. No redundant or filler tools.
The surface covers the full test flow: recipient creation/confirmation/listing, OTP send and verify, delivery status, and integration snippets. Minor gaps exist — no way to remove or revoke a test recipient and no live-mode send tool — but agents can work around these.
Maintenance
Related MCP Connectors
Send SMS, verify phone numbers with one-time codes (OTP) and manage contacts in Israel.
Build and run AI voice agents for phone calls: agents, numbers, campaigns, calls. Hebrew, English.
Scoped Android SMS access for AI agents, with Hebrew invoices, OTP, and tracking.
Canadian SMS and email API for AI agents: send SMS and email, verify phones, handle CASL consent.
Related MCP Servers
- AlicenseAqualityBmaintenanceVirtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle.662 npm4MIT
- AlicenseAqualityDmaintenanceCreate disposable email inboxes, extract OTP codes in 15 languages, and receive webhooks — all from your AI agent. One call: create inbox → wait for email → get the verification code. Supports 7 domains, email forwarding, and HMAC-signed webhooks with OTP included in payload. Free tier available.86 npmMIT

SendAPI MCP Serverofficial
AlicenseAqualityDmaintenanceEnables any MCP-compatible AI agent to send WhatsApp messages, SMS, OTP codes, and email through a single REST API.18MIT
ChatPush MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI agents to send WhatsApp, Telegram, SMS, VK/OK, and MAX messages, files, and bulk mailings, and to manage delivery status, webhooks, and sub-accounts.19336 npm18MIT