SMS8 - SMS GATEWAY using your phone

SMS8 MCPサーバー

SMSゲートウェイ → sms8.io  ·  バイブコーダー＆開発者向けSMSゲートウェイMCP → mcp.sms8.io

Claude Code、Cursor、Windsurf、OpenCode、その他Model Context Protocolに対応するあらゆるAIコーディングツールから、SMSの送信、OTPの発行と検証、受信コードの待機、Webhookの設定が可能です。SMSはSMS8プラットフォームを介して、ペアリングされたAndroidスマートフォンを通じてルーティングされます。

ライブサーバー: https://mcp.sms8.io ダッシュボード: https://app.sms8.io マーケティングサイト: https://sms8.io

使用する理由

アプリを構築していて、SMS通知、OTP、双方向メッセージング、または自律エージェントによる電話番号認証が必要ですか？ほとんどの選択肢では、キャリアプログラムへの登録、電話番号のプロビジョニング、メッセージごとの支払い、またはセッションごとの使い捨てSIMのレンタルが必要です。SMS8は、既にお持ちのスマートフォンを介してSMSをルーティングします。MCPサーバーは、AIアシスタントが直接呼び出せる9つのツールを提供するため、SMSをプロジェクトに追加するには、1時間の統合作業ではなく、1つのプロンプトで済みます。

得られるもの

ツール	目的
setup_sms8	APIキーを検証し、アカウントコンテキストとコードサンプルを返します
send_sms	ペアリングされたAndroidデバイスを介して1件のSMSを送信します
send_otp	確認コードを生成して送信します
verify_otp	入力されたコードを、最後に発行されたOTPと比較します
wait_for_otp	新機能 ペアリングされたAndroidでOTPが到着するまでブロックし、コードを抽出します
get_messages	最近の受信トレイまたは送信済みSMSを返します
list_devices	ペアリングされたAndroidデバイスを一覧表示します
get_balance	新機能 軽量なクレジットと更新の確認
create_webhook	受信SMSおよび配信イベント用のコールバックURLを登録します

すべてのツールは、SMS8ダッシュボードと同じ送信パイプラインを共有します。クレジット、リトライ、マルチデバイスルーティング、Webhook署名は、直接API呼び出しと同様に機能します。

SMS8 vs Twilio vs MessageBird

機能	SMS8	Twilio	MessageBird
組み込みMCPサーバー	あり	なし	なし
メッセージごとの料金	なし	$0.0079～	$0.05～
A2P 10DLC必須	いいえ	はい	はい
電話番号のプロビジョニング	不要	$1～/月	$2～/月
セットアップ時間	60秒	数日～数週間	数日
OTP検証の組み込み	あり	追加サービス	追加サービス
オープンソースMCPコード	MIT	なし	なし

npm経由でのインストール

6つのパッケージがすべてのフローをカバーします。プロジェクトに合ったものを選択してください。

パッケージ	実行コマンド	ユースケース
sms8-mcp	npx -y sms8-mcp	Claude Code、Cursor、Windsurf、OpenCode用MCPランチャー
sms8-cli	npx sms8-cli send +1234 "hi"	送信/OTP/受信トレイ/デバイス用ターミナルCLI
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (セパレーター、RTL、マスク、レンダープロップ)
sms-otp-verify	npm i sms-otp-verify	同じコード、「sms otp verify」/「otp input」検索向けSEO対応名
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Ionicアプリ用Capacitorプラグイン — ネイティブiOS Swift + Android Kotlin + Webフォールバック
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Ionicアプリ用Cordovaプラグイン — ネイティブiOS Swift + Android Kotlin
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	同じCLIのOTP専用ブランド
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	同じCLIのスマートフォンゲートウェイブランド
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	同じCLIのAndroidファーストブランド

MCPの例 (Claude Code、Cursor、Windsurf — 同じ設定形式):

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "sms8-mcp"],
      "env": { "SMS8_API_KEY": "sk_xxx" }
    }
  }
}

CLIの例:

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

Reactの例:

import { OtpForm } from 'react-sms-otp';

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

6つのパッケージすべてのソースは npm-packages/ にあります。

iOS + Android SDK

ネイティブモバイルアプリ向けに、sdks/ フォルダには、送信/検証 API + SMS自動入力ヘルパー (AndroidではGoogle SMS Retriever、iOSではoneTimeCodeコンテンツタイプ) を備えたKotlin (Android) およびSwift (iOS) SDKが同梱されています。

SDK	インストール	自動入力
sms8-swift	Swift Package Manager — README を参照	iOS OTPTextField SwiftUIビュー
sms8-android	JitPack — README を参照	SMSRetriever.start(activity) — SMS権限不要

両方のSDKはMITライセンスで、同じSMS8 APIキーを共有し、同じTwilio Verify代替ユースケースを対象としています。

クイックスタート

1. SMS8アカウントを取得する

app.sms8.io でサインアップします。5日間の無料トライアル、クレジットカード不要。QRコードでAndroidスマートフォンをペアリングし、プロフィール > API からAPIキーをコピーします。

2. ツールにMCPサーバーを追加する

ホスト型HTTP (Claude Code、Cursor、Windsurf、Codex、Devin)

{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

Claude Codeプラグイン (1コマンド)

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

次に、Claude Codeを起動する前にシェルで export SMS8_API_KEY=sk_xxx を実行します。

stdioクライアント向けnpx

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "@sms8/mcp"],
      "env": { "SMS8_API_KEY": "sk_your_key" }
    }
  }
}

3. セットアップウィザード

app.sms8.io/mcp-setup.php のダッシュボードでは、各AIツールのJSONが事前入力され、必要に応じてデバイスペアリングQRが表示され、ライブSMSテストフォームも含まれています。

4. AIに依頼する

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

AIは setup_sms8 を呼び出し、次に send_otp と verify_otp を呼び出して、最初の試行で動作する本番コードを記述します。

ユースケース

これらは、Claude Code、Cursor、またはWindsurfに貼り付けられる実際の1行プロンプトです。

サインアップ時の電話番号認証

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.

注文の発送通知

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

双方向サポート受信トレイ

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.

SMSによるパスワードレスログイン

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

管理者ページ向けSMS 2FA

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

ドロップインコード例

examples/ 内の各ファイルは、本番環境対応、依存関係ゼロ、コピー＆ペースト可能です。これらは、AIが setup_sms8 ハンドシェイク後に生成するものです。

• php-send.php: send、sendOtp、verifyOtp を備えた最小限の Sms8Sender クラス
• js-fetch.js: Node / ブラウザ / Cloudflare Workerクライアント (ESMおよびCommonJS)
• otp-flow.php: 完全な電話番号認証フロー (startSignup + verifySignup)
• webhook-handler.php: HMAC署名チェック付き受信SMSハンドラー

よくある質問

SMS8 MCPサーバーとは何ですか？

mcp.sms8.io にある、Model Context Protocolを実装するHTTPSエンドポイントです。AIコーディングツールは、そのJSON-RPCインターフェースを呼び出して、SMSの送信、OTPの発行、Webhookの設定を行います。SMSはSMS8プラットフォームを介して、ペアリングされたAndroidスマートフォンを通じてルーティングされます。

Twilioとどう違うのですか？

SMS8は、既存のSIMカードを搭載したご自身のAndroidスマートフォンをゲートウェイとして使用します。メッセージごとのキャリア料金、A2P 10DLC登録、プロビジョニングする電話番号はありません。定額プランを支払い、無制限にSMSを送信できます。MCPサーバーは、AIアシスタントが直接呼び出せる7つのツールを公開しますが、これはTwilioには提供されていません。

Claude Codeで動作しますか？

はい。HTTPトランスポートで https://mcp.sms8.io を指し、SMS8 APIキーをBearerトークンとして、MCPサーバーを ~/.config/claude/mcp-servers.json に追加します。または、/plugin marketplace add 1fancy/sms8-sms-gateway を実行し、次に /plugin install sms8-sms-gateway を実行します。

CursorとWindsurfで動作しますか？

はい。どちらもHTTP MCPサーバーをサポートしています。APIキーをBearerヘッダーとして https://mcp.sms8.io を ~/.cursor/mcp.json (Cursor) または ~/.codeium/windsurf/mcp_config.json (Windsurf) に追加します。app.sms8.io/mcp-setup.php のセットアップウィザードでは、ツールごとにJSONが事前入力されます。

AIはOTP検証を自動的に追加できますか？

はい。バンドルされているClaude Codeスキル (skills/send-sms/SKILL.md) は、アシスタントに send_otp と verify_otp をいつ呼び出すか、そして既存のサインアップまたはログインルートを検証ステップでラップする方法を教えます。「/signupに電話番号認証を追加して」 のようなプロンプトで十分です。

ソースコードは公開されていますか？

はい、MITライセンスです。サーバー、7つのツール実装すべて、npmランチャー (@sms8/mcp)、Claude Codeプラグインマニフェスト、およびサンプルコードは このリポジトリ にあります。

APIキーはどうなりますか？

APIキーは、Authorization: Bearer ヘッダー (または X-Api-Key) を介して各MCPツール呼び出しを認証します。ホストされたサーバーは、SMS8アカウントに対してそれを検証し、既存のSMS8送信パイプラインを通じて呼び出しをルーティングします。setup_sms8 レスポンスは、キーの最後の4文字のみを返すため、AIチャット履歴やログに漏洩することはありません。

本番環境で使用しても安全ですか？

はい。サーバー側の防御策は次のとおりです。

• SMS8 APIから継承されたキーごとのレート制限
• 電話番号ごとに24時間あたり最大5 OTPのハードキャップ (ユーザー設定不可)
• 30～600秒の再送クールダウン (デフォルト60秒)
• POSTのみのOTPエンドポイント。GETは405を返し、Cookieは無視されます
• 行ロック付きのトランザクションラップされたレート制限チェック。同時呼び出しが制限を超えることはありません
• HMAC-SHA256 Webhook署名
• RFC1918、CGNAT、リンクローカル、IPv4マップIPv6、およびDNS解決ホストをカバーする、create_webhook の包括的なSSRFブロックリスト
• CORSは検出メソッドに対してのみアドバタイズされます。tools/call はCORSを省略するため、悪意のあるWebページがSMS送信を駆動することはできません

MCPサーバーをセルフホストできますか？

はい。リポジトリをクローンし、SMS8_APP_PATH をSMS8インストールディレクトリに設定して、次を実行します。

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

mcp.sms8.io のホスト型サーバーは無料で、ほとんどのユーザーにとってより簡単です。

「バイブコーディング」とは何ですか？

バイブコーディングとは、すべての行を手作業で書く代わりに、平易な英語で望むものをAIアシスタントに説明することで、動作するソフトウェアを出荷することです。SMS8 MCPは、最も一般的なリクエストの1つ (「SMS通知を追加」) を、キャリアポータルやA2P書類に一切触れることなく可能にします。

セキュリティとシークレット

このリポジトリにはシークレットは含まれていません。すべての認証情報は、環境変数またはAIツールのMCP設定に存在します。

SMS8_API_KEY=sk_…        # from app.sms8.io → Profile → API
SMS8_WEBHOOK_SECRET=…    # from app.sms8.io → Webhook

セキュリティの詳細については、上記のFAQセクションを参照してください。個別のセキュリティ監査サマリーはリクエストに応じて入手可能です。

リポジトリレイアウト

.
├── 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

ロードマップ

• mcp.sms8.io で稼働中のHTTP MCPサーバー
• 電話番号ごとの不正使用キャップ付きOTPエンドポイント
• npmパッケージ sms8-mcp、sms8-cli、sms-otp-using-myphone、phone-sms-gateway、send-sms-from-android
• Claude Codeプラグインとスキル
• MMSサポート
• AIによる返信生成のための受信SMS自動ルーティング
• ダッシュボードで設定可能なツールごとのレート制限
• Python、Go、Rubyでのコード例

貢献

Issueとプルリクエストは github.com/1fancy/sms8-sms-gateway で歓迎します。大規模な変更の前にディスカッションを開いてください。

ライセンス

MIT。LICENSE を参照してください。

キーワード

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