smsportal.app SMS

app.smsportal由 smsportal.app 發布官方發布者v1.0.0更新於 Oct 30, 2026

Send and read SMS from your own Android phone and number. No per-message fees from smsportal.

已驗證Streamable HTTP可網頁執行效率與工作流溝通與協作

概覽

AI 產生的概覽

把已配對的 Android 手機變成簡訊閘道：讓助理以本機號碼發送簡訊並讀取收到的簡訊。

可以做什麼
  • 列出帳號中已配對的手機及其心跳與 SIM 狀態，查看發送、接收與裝置總數
  • 依文字、號碼、手機、狀態與時間搜尋已發送及已接收簡訊
  • 讀取手機已同步的接收簡訊
  • 從自己的手機向最多 50 個 E.164 號碼發送指定內容
  • 查詢某次批次發送中每位收件人的發送狀態
適用情境
適合希望助理透過自己的 Android 號碼與 SIM 卡收發簡訊、而非使用大量簡訊服務商的情境，例如發送通知、回覆或查看收到的訊息。
執行需求
使用 smsportal.app/mcp 的遠端 Streamable HTTP 端點，或自行建置 Node.js 套件以 stdio 在本機執行。需要 smsportal.app 帳號、已配對的 Android 手機與 API 金鑰，透過 Authorization bearer 標頭傳入（stdio 模式用 SMSPORTAL_API_KEY）。無法自訂標頭的用戶端需 Node.js 18+ 的 mcp-remote。
安裝前請注意
API 金鑰是可存取你簡訊帳號的憑證，請勿放入共用設定。發送工具會以你的手機與號碼發出真實簡訊，即使 smsportal 不按則收費，電信業者仍可能計費。API 接受不等於送達，發送後應檢查狀態。設定 SMSPORTAL_READ_ONLY=true 可隱藏發送工具。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 smsportal.app SMS，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/app.smsportal%2Fsms/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "smsportal-app-sms": {
      "type": "http",
      "url": "https://smsportal.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

SMS Portal|app MCP server

Send and read SMS from your own Android phone through AI agents such as Claude, Cursor or any other Model Context Protocol client.

smsportal.app turns an Android phone into an SMS gateway: messages go out from your own number and SIM, and incoming SMS are available through the API. This server exposes that account to AI agents. It is not affiliated with SMSPortal (Pty) Ltd of South Africa.

Use the hosted server (recommended)

  1. Create an account at smsportal.app, pair your Android phone and create an API key in the dashboard.
  2. Add the server to your client.

Claude Code

sh
claude mcp add --transport http smsportal https://smsportal.app/mcp \  --header "Authorization: Bearer $SMSPORTAL_API_KEY"

Claude Desktop and other clients without custom headers (via mcp-remote, Node.js 18+)

json
{  "mcpServers": {    "smsportal": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://smsportal.app/mcp", "--header", "Authorization:${AUTH_HEADER}"],      "env": { "AUTH_HEADER": "Bearer YOUR_SMSPORTAL_API_KEY" }    }  }}

Step-by-step guide: smsportal.app/en/integrations/mcp.

Tools

ToolWhat it does
smsportal_list_devicesPhones paired with the account and their last heartbeat and SIM state
smsportal_get_statsSent, received and device totals
smsportal_list_messagesSearch sent and received SMS by text, number, phone, status and time
smsportal_read_received_smsIncoming SMS already synchronised by the phone
smsportal_get_send_statusPer-recipient status of a batch returned by smsportal_send_sms
smsportal_send_smsSend an exact message to up to 50 E.164 numbers from your phone

API acceptance is not proof of delivery; check the send status afterwards. Set SMSPORTAL_READ_ONLY=true to remove the sending tool.

Run it yourself

sh
git clone https://github.com/aleksanderem/smsportal-mcp && cd smsportal-mcpnpm ci && npm run build

Local (stdio) client entry:

json
{  "mcpServers": {    "smsportal": {      "command": "node",      "args": ["/path/to/smsportal-mcp/dist/index.js"],      "env": { "SMSPORTAL_API_KEY": "YOUR_SMSPORTAL_API_KEY" }    }  }}
VariableDefaultMeaning
SMSPORTAL_API_KEY—API key (stdio mode)
SMSPORTAL_API_URLhttps://smsportal.app/api/v1API base URL
SMSPORTAL_READ_ONLYfalsetrue hides the sending tool
SMSPORTAL_PUBLIC_ORIGINhttp://localhost:18080HTTP mode: the only browser origin allowed
SMSPORTAL_TRUST_PROXYfalseHTTP mode: trust one reverse-proxy hop for the caller address
HOST, PORT127.0.0.1, 3002HTTP mode listener

HTTP mode (node dist/index.js --http, or the Dockerfile) serves Streamable HTTP at /mcp, takes the API key from Authorization: Bearer (or an x-api-key header, for hosts that cannot add the Bearer prefix), validates it before every request and rate-limits per caller network.

Development

sh
npm ci && npm test

Security reports: see SECURITY.md. License: MIT.

來源：README.md，提交 66451ba

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v1.0.0最新Oct 30, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分