Verify Your Users.
One API. Multichannel

otp-integration Copy Copied

Integrate otp.com OTP verification into this project.

API docs: https://otp.com/docs
Base URL: https://api.otp.com/api/v1
Auth: Bearer token in the Authorization header

## Step 1: Send a code
POST /otp/send
Body: { "recipient": "+14155552671", "locale": "en", "client_ip": "<end user's IP>" }
→ Returns { "otp_id": "9f3c1b2a-…", "status": "pending", "channel": "sms" }

## Step 2: Verify the code the user entered
POST /otp/verify
Body: { "otp_id": "9f3c1b2a-…", "code": "123456" }
→ Returns { "otp_id": "9f3c1b2a-…", "status": "approved", "matched": true }

Notes:
- recipient is a phone number (E.164) or an email; do not send a "channel", your account routing picks it.
- client_ip is the END USER's IP from the request context (e.g. req.ip), never the server's own; requests without it share a much tighter rate limit.
- The code is never returned by the API.
Sandbox test keys (otp_test_…) accept the fixed code 123456; $3 free credits.

Integrate otp.com using the official Node.js SDK.

Install:
npm install @otp.com/sdk-node

Initialize:
import { Configuration, OTPApi } from "@otp.com/sdk-node"
const api = new OTPApi(new Configuration({ accessToken: process.env.OTP_API_KEY }))

## Step 1: Send a code
// clientIp = the END USER's IP from the request context (e.g. req.ip), not the server's.
const sent = await api.sendOtp({ sendOtpRequest: { recipient: "+14155552671", locale: "en", clientIp: "81.2.69.142" } })

## Step 2: Verify the code
const result = await api.verifyOtp({ verifyOtpRequest: { otpId: sent.otpId, code: "123456" } })
// result.matched === true

Official SDKs: Node.js, Python, Go, PHP.
Sandbox test keys (otp_test_…) accept the fixed code 123456; $3 free credits.

Connect otp.com to your AI agent via MCP.

Add to your MCP config (claude_desktop_config.json):
{
  "mcpServers": {
    "otp": {
      "command": "npx",
      "args": ["-y", "@otp.com/mcp"],
      "env": { "OTP_API_KEY": "otp_test_•••" }
    }
  }
}

Exposed tools:
- send_otp        → send a code (channel chosen by your account routing)
- verify_otp      → check the code the user entered (otp_id, code)
- resend_otp      → resend on the next channel (otp_id)
- get_otp_status  → look up an OTP by otp_id

Your agent sends and verifies users in a single prompt.
Sandbox test keys (otp_test_…) accept the fixed code 123456; $3 free credits.