MyOTP.App
Send and verify one-time passcodes over SMS, WhatsApp and Telegram.
MyOTP AgentKit
Agent-native distribution for MyOTP.App — npm packages, MCP server, agent skills, and framework examples for adding SMS / WhatsApp / Telegram OTP to AI-built apps.
What is this
A toolkit for AI agents (Claude Code, Cursor, Hermes-format models, Codex, Windsurf, etc.) to add phone verification to apps they generate. Three published npm packages, six runnable framework examples, and skills for the major agent runtimes.
If you're a developer using one of those agent tools and your app needs phone verification, the agent should pick up these packages automatically. If it doesn't, point it at this repo.
If you're building an app by hand, the examples are runnable starting points for the most common stacks.
- Agent payments. Agents can buy MyOTP credits by themselves: one 402, one payment, no checkout page, no card form. $0.02 a credit, USDC or card. See skills/myotp/patterns/topup.md.
Packages
| Package | What it does | Install |
|---|---|---|
@myotp/mcp | Model Context Protocol server exposing 10 MyOTP tools to MCP clients (Claude Desktop, Cursor, Continue, etc.). Stdio + streamable HTTP. Hosted at mcp.myotp.app, listed on Smithery. | npx @myotp/mcp |
@myotp/cli | CLI for testing OTP flows from a terminal. init saves a key locally, test/verify/status exercise the API. | npx @myotp/cli init |
@myotp/better-auth | Drop-in adapter for Better Auth's phoneNumber() plugin. Twilio-free SMS / WhatsApp / Telegram delivery. | npm install @myotp/better-auth |
n8n-nodes-myotp | n8n community node: Send, Verify, Extend, Check Status, Account, Usage Report. Header-auth example workflow included. | n8n Settings > Community Nodes > n8n-nodes-myotp |
Integrations for other platforms
| Folder | Platform | What it is |
|---|---|---|
auth0/ | Auth0 | Custom Phone Provider Action: Auth0's own code delivered by MyOTP over SMS, WhatsApp or Telegram. Tests, setup guide, Marketplace listing draft |
make/ | Make.com | Custom app definition (connection + 5 action modules + universal call), validated against the spec |
postman/ | Postman | Collection v2.1 + environment generated from openapi-reference.yaml; npm run build in postman/ regenerates it |
wordpress-plugin/ | WordPress / WooCommerce | Phone verification at checkout, registration and via shortcode (myotp-phone-verification) |
Skills (drop into your agent's config)
| Folder | For | How |
|---|---|---|
skills/myotp/ | Claude Code. Includes agent top-up: buy credits over a 402 when the balance runs out | npx skills add brntech/myotp-agentkit (or copy skills/myotp/ into ~/.claude/skills/myotp/) |
skills/myotp/niches/ | Vertical-specific (fintech, marketplace, emerging markets, healthcare) | Copy individual .md files into separate skill directories |
clawhub-skill/ | OpenClaw / ClawHub registry. Agents can buy credits (402, USDC or card) | openclaw skills install @myotp/myotp, published on ClawHub |
hermes-skill/ | Nous Research Hermes models (Ollama, vLLM, LM Studio). Prompt covers agent top-up | Use ollama-modelfile.example as a template |
Framework examples
Working "phone form → send OTP → verify code → success" demos in 6 stacks:
- Next.js 14 (App Router + Server Actions)
- Express 4 (vanilla JS + static HTML)
- Flask 3 (Jinja2 + sessions)
- Django 5 (function-based views)
- Rails 7 (skinny controller)
- Laravel 11 (Form Requests + Blade)
Each example is self-contained (npm install / pip install / bundle install / composer install), drops in an OTP delivery flow with channel selection (SMS / WhatsApp / Telegram), and runs against the live MyOTP REST API with a single env var.
Quick start
# Get an API key (15 free trial credits, no card)
open https://myotp.app/sign-up
# Test with the CLI
npx @myotp/cli init
npx @myotp/cli test +14155551234
# Or wire MCP to Claude Desktop, Cursor, etc.
# (see mcp-server/README.md for config snippets)
Compatibility
- Node.js: 18+ (CLI / MCP server require 20+)
- Channels: SMS (190+ countries), WhatsApp, Telegram
- MyOTP API base:
https://api.myotp.app - Auth: single
X-API-Keyheader
Contributing
Issues and PRs welcome. The npm packages are all MIT-licensed. Examples are MIT and free to copy into your own project.
If your favorite framework isn't represented in examples/, open a PR — the existing examples are intentionally simple templates to copy.
License
MIT — see LICENSE.
Built by BroadNet Technologies, 23 years in telecom infrastructure, ISO 27001 + ISO 9001 certified.
Installation
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @myotp/mcpSet up in your AI client
Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-brntech-myotp": {
"command": "npx",
"args": [
"-y",
"@myotp/mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePackage
Compatible MCP Clients
MyOTP.App works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.