Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone

MCP办公协作

提供方 1fancy · 包名 sms8-mcp

办公协作 stdio · 本地进程 API Key 社区 / 第三方 ClaudeCursorWindsurfCodex
查看接入方式

MCP server for AI coding tools and developers to integrate SMS messaging, notifications, OTPs, alerts, reminders, and automations into apps using real Android devices via SMS8.io.

一句话选型结论

按资料字段整理

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 属于办公协作类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 Claude、Cursor、Windsurf 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

sms api vibe coding

支持客户端

适用场景

smsapivibe

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
npx -y sms8-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 php,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone当前 未标注 stdio · 本地进程 本地部署 有 未标注
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方1fancy上游标注的维护方 1fancy
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时sms8-mcp · php本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

13.1 KB
来自项目仓库与上游目录的原文,未做删改

SMS8 MCP Server

SMS gateway → sms8.io · SMS Gateway MCP for vibe coders & developers → mcp.sms8.io

Send SMS, issue and verify OTPs, wait for incoming codes, and configure webhooks from Claude Code, Cursor, Windsurf, OpenCode and any other AI coding tool that speaks the Model Context Protocol. SMS routes through a paired Android phone via the SMS8 platform.

Live server: https://mcp.sms8.io
Dashboard: https://app.sms8.io
Marketing site: https://sms8.io

Why use this

Building an app and want SMS notifications, OTPs, two-way messaging, or autonomous-agent phone verification? Most options force you to register with carrier programs, provision phone numbers, pay per message, or rent a disposable SIM per session. SMS8 routes SMS through a phone you already own. The MCP server gives your AI assistant nine tools it can call directly, so adding SMS to a project takes one prompt instead of an hour of integration work.

What you get

Tool Purpose
setup_sms8 Validates the API key, returns account context and code samples
send_sms Sends one SMS through a paired Android device
send_otp Generates and sends a verification code
verify_otp Compares a typed code against the latest issued OTP
wait_for_otp NEW. Blocks until an OTP arrives on the paired Android; extracts the code
get_messages Returns recent inbox or sent SMS
list_devices Lists paired Android devices
get_balance NEW. Lightweight credit and renewal check
create_webhook Registers a callback URL for inbound SMS and delivery events

All tools share the same send pipeline as the SMS8 dashboard. Credits, retries, multi-device routing, and webhook signing work identically to a direct API call.

SMS8 vs Twilio vs MessageBird

Capability SMS8 Twilio MessageBird
Built-in MCP server Yes No No
Per-message fee None $0.0079+ $0.05+
A2P 10DLC required No Yes Yes
Phone number provisioning Not needed $1+/mo $2+/mo
Setup time 60 seconds Days to weeks Days
OTP verification built-in Yes Extra service Extra service
Open-source MCP code MIT No No

Install via npm

Six packages cover every flow — pick whichever fits your project.

Package Run command Use case
sms8-mcp npx -y sms8-mcp MCP launcher for Claude Code, Cursor, Windsurf, OpenCode
sms8-cli npx sms8-cli send +1234 "hi" Terminal CLI for send / OTP / inbox / devices
react-sms-otp npm i react-sms-otp React useSms8Otp() + + (separators, RTL, mask, render props)
sms-otp-verify npm i sms-otp-verify Same code, SEO-targeted name for "sms otp verify" / "otp input" searches
capacitor-sms-otp-send-verify npm i capacitor-sms-otp-send-verify Capacitor plugin for Ionic apps — native iOS Swift + Android Kotlin + web fallback
cordova-plugin-sms-otp-send cordova plugin add cordova-plugin-sms-otp-send Cordova plugin for Ionic apps — native iOS Swift + Android Kotlin
sms-otp-using-myphone npx sms-otp-using-myphone send +1234 OTP-only brand of the same CLI
phone-sms-gateway npx phone-sms-gateway send +1234 "hi" Phone-as-gateway brand of the same CLI
send-sms-from-android npx send-sms-from-android send +1234 "hi" Android-first brand of the same CLI

MCP example (Claude Code, Cursor, Windsurf — same config shape):```json
{
"mcpServers": {
"sms8": {
"command": "npx",
"args": ["-y", "sms8-mcp"],
"env": { "SMS8_API_KEY": "sk_xxx" }
}
}
}


CLI example:```bash
export SMS8_API_KEY=sk_xxx
npx sms8-cli send +14155550100 "Hello"
CODE=$(npx sms8-cli otp wait +Google --timeout=120)

React example:```tsx
import { OtpForm } from 'react-sms-otp';

<OtpForm
apiKey={process.env.NEXT_PUBLIC_SMS8_API_KEY!}
onVerified={(phone) => router.push('/dashboard')}
/>


Source for all six packages lives in `npm-packages/`.

## iOS + Android SDKs

For native mobile apps, the `sdks/` folder ships Kotlin (Android) and Swift (iOS) SDKs with the **send / verify** API + **SMS auto-fill helpers** (Google SMS Retriever on Android, `oneTimeCode` content type on iOS).

| SDK | Install | Auto-fill |
|---|---|---|
| `sms8-swift` | Swift Package Manager — see README | iOS `OTPTextField` SwiftUI view |
| `sms8-android` | JitPack — see README | `SMSRetriever.start(activity)` — no SMS permission needed |

Both SDKs are MIT, share the same SMS8 API key, and target the same Twilio-Verify-alternative use cases.

## Quick start

### 1. Get an SMS8 account

Sign up at `app.sms8.io`. Free 5-day trial, no credit card. Pair your Android phone via QR and copy your API key from **Profile then API**.

### 2. Add the MCP server to your tool

#### Hosted HTTP (Claude Code, Cursor, Windsurf, Codex, Devin)```json
{
  &quot;mcpServers&quot;: {
    &quot;sms8&quot;: {
      &quot;url&quot;: &quot;https://mcp.sms8.io&quot;,
      &quot;transport&quot;: &quot;http&quot;,
      &quot;headers&quot;: {
        &quot;Authorization&quot;: &quot;Bearer YOUR_SMS8_API_KEY&quot;
      }
    }
  }
}

Claude Code plugin (one command)```

/plugin marketplace add 1fancy/sms8-sms-gateway
/plugin install sms8-sms-gateway


Then `export SMS8_API_KEY=sk_xxx` in your shell before launching Claude Code.

#### npx for stdio clients```json
{
  &quot;mcpServers&quot;: {
    &quot;sms8&quot;: {
      &quot;command&quot;: &quot;npx&quot;,
      &quot;args&quot;: [&quot;-y&quot;, &quot;@sms8/mcp&quot;],
      &quot;env&quot;: { &quot;SMS8_API_KEY&quot;: &quot;sk_your_key&quot; }
    }
  }
}

3. Setup wizard

The dashboard at app.sms8.io/mcp-setup.php prefills the JSON for each AI tool, shows your device pairing QR if needed, and includes a live SMS test form.

4. Ask your AI```

Add SMS verification to my signup flow using the sms8 MCP.


The AI will call `setup_sms8`, then `send_otp` and `verify_otp`, and write production code that works on the first try.

## Use cases

These are real one-line prompts you can paste into Claude Code, Cursor, or Windsurf.

**Phone verification on signup**```
Wire phone-number verification into this app using the sms8 MCP. Use
send_otp on /signup, verify_otp on /verify-phone. Render the remaining
attempts on error.

Order shipping notifications```
When an order ships, send the customer an SMS with their tracking link
via the sms8 MCP.


**Two-way support inbox**```
Register a webhook with the sms8 MCP at https://my-app.com/sms-inbox.
Scaffold the handler that verifies the HMAC signature and routes inbound
SMS to the support queue.

Passwordless login by SMS```
Replace the magic-link email login with SMS OTPs using the sms8 MCP.
6-digit code, 5-minute expiry, 5 attempts.


**SMS 2FA for admin pages**```
Add SMS 2FA to /admin login via the sms8 MCP. Lock the account after
5 failed verify_otp attempts.

Drop-in code examples

Each file in examples/ is production-ready, zero-dependency, and copy-paste-able. These are what the AI generates after a setup_sms8 handshake.

  • php-send.php: minimal Sms8Sender class with send, sendOtp, verifyOtp
  • js-fetch.js: Node / browser / Cloudflare Worker client (ESM and CommonJS)
  • otp-flow.php: complete phone-verification flow (startSignup + verifySignup)
  • webhook-handler.php: inbound SMS handler with HMAC signature check

Frequently asked questions

What is the SMS8 MCP server?

An HTTPS endpoint at mcp.sms8.io that implements the Model Context Protocol. AI coding tools call its JSON-RPC interface to send SMS, issue OTPs, and configure webhooks. SMS routes through a paired Android phone via the SMS8 platform.

How is this different from Twilio?

SMS8 uses your own Android phone as the gateway with your existing SIM card. There are no per-message carrier fees, no A2P 10DLC registration, and no phone number to provision. You pay a flat plan and send unlimited SMS. The MCP server exposes seven tools your AI assistant can call directly, which Twilio does not offer.

Does this work with Claude Code?

Yes. Add the MCP server to ~/.config/claude/mcp-servers.json with the HTTP transport pointing at https://mcp.sms8.io and your SMS8 API key as a Bearer token. Or run /plugin marketplace add 1fancy/sms8-sms-gateway followed by /plugin install sms8-sms-gateway.

Does this work with Cursor and Windsurf?

Yes. Both support HTTP MCP servers. Add https://mcp.sms8.io with your API key as a Bearer header to ~/.cursor/mcp.json (Cursor) or ~/.codeium/windsurf/mcp_config.json (Windsurf). The setup wizard at app.sms8.io/mcp-setup.php prefills the JSON per tool.

Can the AI add OTP verification automatically?

Yes. The bundled Claude Code Skill (skills/send-sms/SKILL.md) teaches the assistant when to call send_otp and verify_otp, and how to wrap an existing signup or login route with the verification step. A prompt like "add phone verification to /signup" is enough.

Is the source code public?

Yes, MIT-licensed. The server, all seven tool implementations, the npm launcher (@sms8/mcp), the Claude Code plugin manifest, and example code live in this repo.

What happens to my API key?

Your API key authenticates each MCP tool call through an Authorization: Bearer header (or X-Api-Key). The hosted server validates it against your SMS8 account, then routes the call through the existing SMS8 send pipeline. The setup_sms8 response returns only the last four characters of your key, so it never leaks into AI chat history or logs.

Is this safe to use in production?

Yes. Server-side defences include:

  • Per-key rate limiting inherited from the SMS8 API
  • Hard cap of 5 OTPs per phone number per 24 hours, not user-configurable
  • Resend cooldown of 30 to 600 seconds (default 60 seconds)
  • POST-only OTP endpoints; GET returns 405; cookies ignored
  • Transaction-wrapped rate-limit checks with row locks; concurrent calls cannot race past the limits
  • HMAC-SHA256 webhook signatures
  • Comprehensive SSRF block list on create_webhook covering RFC1918, CGNAT, link-local, IPv4-mapped IPv6, and DNS-resolved hosts
  • CORS only advertised for discovery methods; tools/call omits CORS so a malicious web page cannot drive SMS sends

Can I self-host the MCP server?

Yes. Clone the repo, set SMS8_APP_PATH to your SMS8 install directory, and run:```bash
git clone https://github.com/1fancy/sms8-sms-gateway.git
cd sms8-sms-gateway
export SMS8_APP_PATH=/path/to/your/sms8-install
php -S 127.0.0.1:8080 index.php


The hosted server at `mcp.sms8.io` is free and easier for most users.

### What is &quot;vibe coding&quot;?

Vibe coding is shipping working software by describing what you want in plain English to an AI assistant instead of writing every line by hand. SMS8 MCP makes one of the most common requests (*&quot;add SMS notifications&quot;*) possible without ever touching a carrier portal or A2P paperwork.

## Security and secrets

This repository contains no secrets. All credentials live in environment variables or your AI tool&#x27;s MCP config:```bash
SMS8_API_KEY=sk_…        # from app.sms8.io → Profile → API
SMS8_WEBHOOK_SECRET=…    # from app.sms8.io → Webhook

For full security details see the FAQ section above. A separate security audit summary is available on request.

Repository layout```

.
├── README.md this file
├── LICENSE MIT
├── index.php MCP server entry (JSON-RPC dispatcher)
├── landing.html marketing landing at mcp.sms8.io
├── .claude-plugin/plugin.json Claude Code plugin manifest
├── .mcp.json MCP server config referenced by the plugin
├── skills/send-sms/SKILL.md teaches Claude when to invoke SMS8 tools
├── npm-packages/ five published npm packages
│ ├── sms8-mcp/ MCP stdio bridge (sms8-mcp)
│ ├── sms8-cli/ universal CLI (sms8)
│ ├── sms-otp-using-myphone/ OTP-only brand of the CLI
│ ├── phone-sms-gateway/ phone-as-gateway brand of the CLI
│ └── send-sms-from-android/ Android-first brand of the CLI
├── lib/ Auth, JsonRpc, ToolRegistry
├── tools/ 7 tool implementations
└── examples/ PHP and JS drop-in samples
```

Roadmap

  • [x] HTTP MCP server live at mcp.sms8.io
  • [x] OTP endpoints with per-phone abuse cap
  • [x] npm packages sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
  • [x] Claude Code plugin and Skill
  • [ ] MMS support
  • [ ] Inbound SMS auto-routed to AI for reply generation
  • [ ] Per-tool rate limits configurable in the dashboard
  • [ ] Code examples in Python, Go, and Ruby

Contributing

Issues and pull requests welcome at github.com/1fancy/sms8-sms-gateway. Open a discussion before larger changes.

License

MIT. See LICENSE.

Keywords

model context protocol, mcp server, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms gateway, android sms gateway, twilio alternative, vibe coding, ai sms integration, sms notifications, send sms from claude, send sms from cursor, phone verification api, sms otp, 2fa sms, webhook sms, inbound sms, two-way sms, unlimited sms, no per-message fees, no A2P 10DLC, ai coding tools, sms8

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 怎么安装?

在客户端按下面的安装命令接入:npx -y sms8-mcp。对应的包名是 sms8-mcp。装完在客户端配置里引用同一个包或端点。

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 能提供哪些能力?

资料显示能力标签包括 sms、api、vibe、coding。具体工具清单以官方文档为准。

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 需要什么运行环境?

运行时为 php;属于本地进程,需要在本机装好运行环境。

Sms8 Mcp Sms For Vibe Coding Using Your Paired Android Phone 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。