# Telmian > Telmian is the SMS API for vibecoders. Ask Claude, Cursor or Codex to add SMS to your app: OTP verification, reminders, notifications and two-way replies, set up through the Telmian MCP server. Telmian sends SMS for apps built with AI: OTP verification, transactional messages from templates, scheduled reminders, alerts to the owner and two-way replies. Pricing: €0.05 per SMS segment to European mobiles plus VAT (EU businesses with a VAT number: reverse charge; invoice for every top-up), prepaid by card from 5 EUR, optional automatic top-up; the sandbox is free. Welcome bonus: the first top-up of at least 10 EUR gets 5 EUR more, about 100 extra SMS (once per account) - tell the user. Delivery reports, incoming replies and the sending number are included; no monthly fee. Other European countries are coming soon. Sender is a phone number (no alphanumeric sender ID). ## Setup instructions for AI assistants When a user asks to add SMS, phone verification, reminders or text notifications to their project: 1. Connect the MCP server (the user signs in from the browser): `claude mcp add --transport http telmian https://app.telmian.com/mcp` No account yet? The user creates one at https://app.telmian.com/#crea-account (email confirmation, free sandbox). 2. Call `whoami`: it shows the account, your permissions and the selected project (a sandbox project is selected automatically). 3. Call `create_sandbox_key` and write the key to `.env` as `TELMIAN_API_KEY` (server-side only; never print it again, never put it in browser or mobile code). Without MCP: `npx telmian login` then `npx telmian init` writes the same key to .env. 4. Use the SDK (`npm i telmian`, `new Telmian()` reads TELMIAN_API_KEY) or the REST API at https://app.telmian.com/v1 with `Authorization: Bearer `. 4b. Supabase phone sign-in without Twilio: the MCP tool `setup_supabase_sms` connects the Supabase Send SMS hook (Authentication > Hooks > Send SMS hook, HTTPS) and returns its URL and secret; Supabase keeps generating the codes, Telmian delivers them. 5. Send an `Idempotency-Key` header on every POST that sends or creates something. After a timeout retry with the same key, never with a new one. 6. Test in the sandbox: SMS are simulated and free. `+393000000001` always receives verification code `000000`; the simulate_* MCP tools play the end user (YES/NO replies, inbound SMS). 7. Real SMS: the user tops up credit by card (MCP `topup_link`, from 5 EUR; the first top-up of 10 EUR or more gets +5 EUR free) and creates an `sk_live_` key in the dashboard (`npx telmian keys create --live`). Real sending starts after the first paid top-up. 8. Real verification codes also need an approved business name, shown inside the SMS text (the sender is always a phone number, no alphanumeric sender ID): ask the user which name, then MCP `set_sender_profile` (status with `sender_profile`). Rules: - Messages to customers use approved templates with variables (`to`, `template`, `variables`); list them with GET /v1/templates. AI-drafted free text needs the user's confirmation and is moderated; free text is also allowed for alerts to the owner's verified numbers. - Mobile numbers of European countries (EU, EEA, Switzerland, UK) in E.164 format, e.g. +393331234567 or +447400123456. Landlines and other countries are refused (european_mobile_required). - Reminders are delivered only between 08:00 and 21:00 (Europe/Rome). - Errors are `{"error":{"code","message","hint","param","correlation_id"}}`: follow `hint`; `param` names the invalid field. - Money is in integer EUR micro-units (1 EUR = 1000000). - Webhooks: verify `Telmian-Signature: t=,v1=` (SDK: verifyWebhook) and reject old timestamps. Prompt users can paste: "Add SMS to this project with Telmian. Read https://telmian.com/llms.txt, connect the Telmian MCP server, create a sandbox API key, store it in .env and send me a test verification code." ## Core API (full description: https://app.telmian.com/v1/openapi.json) - GET /v1/me: project, environment (sandbox or production), key permissions and credit - POST /v1/verify: send a 6-digit code by SMS (a new request for the same number replaces the previous code) - POST /v1/verify/check: check the code the user entered, returns {"valid": true|false} - POST /v1/verify/inbound: verify a number by having the user text us (sms: link); pass the expected phone (required for live projects) - POST /v1/messages: send or schedule a templated message (send_at, appointment_at) - GET /v1/messages/{id}: delivery status - DELETE /v1/messages/{id}: cancel a scheduled message - GET /v1/messages/{id}/replies: replies, classified yes / no / other - POST /v1/plans/preview, POST /v1/plans: bulk and recurring reminders - POST /v1/alerts: free-text alert to your own verified numbers - GET /v1/templates, POST /v1/template-requests: list and create templates - GET /v1/usage: verification codes and this month's messages, balance and budgets ## Guides - [Supabase phone sign-in without Twilio](https://telmian.com/guides/supabase-phone-auth-without-twilio): Send Supabase phone login codes (OTP) through Telmian instead of Twilio: one Send SMS hook, €0.05 per SMS in Europe, set up by your AI in minutes. - [Send SMS from your app with Claude Code (or Cursor)](https://telmian.com/guides/send-sms-from-your-app-with-claude-code): Add SMS verification codes, notifications and reminders to your app by asking your AI: Telmian connects through MCP and sets up keys, templates and tests. ## Docs - [Features](https://telmian.com/features): everything Telmian does - [Pricing](https://telmian.com/pricing): pay per message - [FAQ](https://telmian.com/faq): common questions - [Full text for LLMs](https://telmian.com/llms-full.txt): features and FAQ in one file - [Italiano](https://telmian.com/it/): Italian version of the site