MyOTP.App README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the MyOTP.App listing page.
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
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.