# Delivered — SMS for Developers

Delivered is the SMS API for developers: send and receive texts, provision real
US/Canada phone numbers, and screen spam with one REST API.

Base URL: https://api.deliveredsms.com/v1
Auth: Authorization: Bearer ghost_sk_test_... (free sandbox keys, instant)
Console: https://deliveredsms.com/console

## Authentication
- **How to get and handle credentials (agents start here)** - https://deliveredsms.com/auth.md

## Markdown twins of site pages
- **Landing (Markdown)** - https://deliveredsms.com/index.md
- **Agents page (Markdown)** - https://deliveredsms.com/agents.md
- **Pricing (Markdown)** - https://deliveredsms.com/pricing.md
- **Per-tool pages** - append .md to any tool page, e.g. https://deliveredsms.com/claude-code.md
- Every page also supports `Accept: text/markdown` content negotiation.

## Documentation
- **Full documentation (single file)** - https://deliveredsms.com/docs/llms-full.txt
- **Quickstart** - https://deliveredsms.com/docs/quickstart.md — Send your first SMS in under five minutes.
- **Authentication** - https://deliveredsms.com/docs/authentication.md — API keys, test vs live mode, and key rotation.
- **Sandbox & test numbers** - https://deliveredsms.com/docs/sandbox.md — How test mode works, including magic numbers.
- **Messages** - https://deliveredsms.com/docs/messages.md — Send SMS, retrieve messages, and list history.
- **Verify** - https://deliveredsms.com/docs/verify.md — Phone verification (OTP) in two API calls.
- **Webhooks** - https://deliveredsms.com/docs/webhooks.md — Signed event delivery to your endpoint, with automatic retries.
- **Migrate from Twilio Verify** - https://deliveredsms.com/docs/migrate-from-twilio.md — Line-by-line mapping from Twilio Verify to Delivered Verify.
- **Numbers** - https://deliveredsms.com/docs/numbers.md — Search, purchase, and release phone numbers.
- **Lookup** - https://deliveredsms.com/docs/lookup.md — Carrier, line type, and spam intelligence for any number.
- **Errors** - https://deliveredsms.com/docs/errors.md — The error envelope and every error code.
- **Pricing** - https://deliveredsms.com/docs/pricing.md — What the Delivered costs, and what the free tier includes.
- **Changelog** - https://deliveredsms.com/docs/changelog.md — What changed in the Delivered.

## Command line tool
- **CLI** - npx deliveredsms — send, verify, numbers, lookup, events from the terminal; --json for scripts and agents; key via DELIVERED_API_KEY or `deliveredsms login`

## SDKs
- **Node.js / TypeScript** - npm install deliveredsms — zero dependencies, works on Node 18+, Bun, Deno, Workers and Edge; ships the CLI as its bin

## OpenAPI spec
- **OpenAPI spec (YAML)** - https://deliveredsms.com/openapi.yaml
- **OpenAPI spec (JSON)** - https://deliveredsms.com/openapi.json
- Also served from the API host at https://api.deliveredsms.com/v1/openapi.yaml and https://api.deliveredsms.com/v1/openapi.json

## MCP Server
- **Streamable HTTP MCP server** - https://deliveredsms.com/api/mcp — send/receive SMS, numbers, lookup, and events as MCP tools; authenticate with your API key
- **MCP Discovery** - https://deliveredsms.com/.well-known/mcp.json

## Skills
- **Install** - npx skills add sbier060/deliveredsms — works with Claude Code, Cursor, Codex, Devin, Copilot
- **Repository** - https://github.com/sbier060/deliveredsms
- **Skills Discovery** - https://deliveredsms.com/.well-known/agent-skills/index.json
- **delivered** - https://deliveredsms.com/skills/delivered/SKILL.md — send SMS, get numbers, screen spam
- **delivered-verify** - https://deliveredsms.com/skills/delivered-verify/SKILL.md — phone verification (OTP/2FA) in two calls
- **sms-best-practices** - https://deliveredsms.com/skills/sms-best-practices/SKILL.md — consent, opt-out, segments, 10DLC

## For AI agents
- **Agents overview** - https://deliveredsms.com/agents — phone numbers, SMS inboxes, and verification for agents
- **Use Delivered with Claude** - https://deliveredsms.com/claude
- **Use Delivered with Claude Code** - https://deliveredsms.com/claude-code
- **Use Delivered with Cursor** - https://deliveredsms.com/cursor
- **Use Delivered with Codex** - https://deliveredsms.com/codex
- **Use Delivered with Devin** - https://deliveredsms.com/devin
- **Use Delivered with GitHub Copilot** - https://deliveredsms.com/copilot

## Changelog
- **Changelog (Markdown)** - https://deliveredsms.com/docs/changelog.md
- **Changelog (HTML)** - https://deliveredsms.com/docs/changelog

## Legal
- **Terms of Service** - https://deliveredsms.com/terms — operated by Truelabel LLC
- **Privacy Policy** - https://deliveredsms.com/privacy

## Product
- **Landing page** - https://deliveredsms.com
- **Pricing (HTML)** - https://deliveredsms.com/pricing
- **Pricing (Markdown)** - https://deliveredsms.com/pricing.md