Campfire SMS

io.github.campfiresmsv0.1.0更新於 Oct 10, 2026

Hosted two-way SMS bridge: your coding agent texts you when it needs an answer; you reply by SMS.

已驗證Streamable HTTP可網頁執行Productivity & WorkflowCommunication & Collaboration

概覽

AI 產生的概覽

託管的雙向簡訊橋接服務，讓助理用簡訊向你詢問或回報，並讀取你的簡訊回覆。

功能
Campfire SMS 透過簡訊把代理連接到你已驗證的手機號碼。工具可開啟或重複使用橋接、傳簡訊給你、取回待處理的回覆、確認已處理的訊息 ID，以及關閉橋接。此服務負責手機號碼註冊、簡訊遞送、具驗證的訊息佇列與路由；代理仍以自己的模型、工具與權限繼續運作。
適用情境
適合長時間執行或無人看管的代理需要就某個決定聯絡你、或回報結果，而你偏好直接在平常的簡訊收件匣回覆，而不是盯著終端機。它的用途是把代理連接到執行它的人，而不是給代理一個讓其他人傳簡訊的號碼。
執行需求
遠端 streamable HTTP 端點 api.campfiresms.com，以及來自 campfiresms.com 帳號、依安裝發放的 bearer 憑證（需先註冊並驗證手機號碼），透過 Authorization 標頭傳送。使用帳號安裝指令進行本機設定需要 Node.js 18+（含 npx）與 Python 3.12+；僅取得憑證的選項只需 Node.js 18+。電腦必須保持喚醒、連線，並讓代理工作階段持續執行。
安裝前請注意
必須提供 Authorization bearer 憑證，且只應存放在用戶端的安全憑證設定中。簡訊並非端對端加密，請勿傳送密碼、憑證或付款資訊。簡訊回覆不會給代理新增權限，但可在其現有權限範圍內引導工作。每傳送或接收一則簡訊計為一則訊息，額度用完後訊息功能會暫停。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Campfire SMS，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "campfire-mcp": {
      "type": "http",
      "url": "https://api.campfiresms.com/mcp"
    }
  }
}

README

Campfire SMS MCP

[Listed on mcpservers.org]

Text your agent. Campfire SMS is a hosted two-way SMS bridge: your agent texts you when it needs an answer or has a result, and you reply by SMS from your normal text inbox.

Don't pip install this repo or use an npx package name without an installation code. Start at campfiresms.com.

How it works

  • Your agent opens a bridge and sends you a text when it needs input or finishes something.
  • You reply from your phone's normal text inbox. No phone app to install.
  • The agent retrieves your reply and keeps working with its own model, tools, and permissions. Campfire SMS handles phone enrollment, SMS delivery, the authenticated message queue, and routing.

Campfire SMS is not a service that gives an agent a phone number for other people to text. It connects your agent to you, the person running it.

Install (through campfiresms.com)

  1. Sign up at campfiresms.com.
  2. Verify your phone. You get 40 free messages, no card required.
  3. Copy the one-time install command from your account (Add computers → Add a computer or Bot → Create install command).

Full instructions: campfiresms.com/install.html

Local agents

For Codex, Claude Code, Grok Build, OpenCode, or another compatible MCP host on your computer. Run the command your account shows:

text
npx -y @campfiresms/setup YOUR_INSTALLATION_CODE
  • YOUR_INSTALLATION_CODE comes from your account. The command is single use and expires after 10 minutes; if it expires, create a new one.
  • Requires Node.js 18+ (with npx) and Python 3.12+.
  • Setup stores the installation credential locally and registers detected Codex and Grok Build CLIs. For other hosts, add a local MCP server named campfire using the command setup prints.
  • On Linux or a VM, run setup as the same non-root user as the agent, inside a Python virtual environment. Don't use sudo pip, system pip, or --break-system-packages. See the Linux/VM instructions.
  • Keep the computer awake and online with the agent session running. Campfire SMS does not wake a stopped local session.

To refresh a saved local connection: npx -y @campfiresms/setup update

Hosted MCP

Streamable HTTP endpoint:

text
https://api.campfiresms.com/mcp

It requires a per-installation bearer credential from your account, sent as Authorization: Bearer <credential>. It does not work without that credential: adding the URL alone (for example, through a directory's one-click install) gets HTTP 401.

To get the credential, run your account's install command with --credential-only (needs Node.js 18+, no Python or pip). Put the credential only in your client's secure credential settings.

Example for Grok Bot cloud routines: connect the hosted MCP with the credential, then set up an active webhook routine and save its URL and key under Grok Bot 24/7 wake in your account. An incoming text can then start the routine while your PC is off. See the Grok Bot walkthrough.

Tools

ToolPurpose
campfire_open_bridgeOpen (or reuse) an SMS bridge to your verified phone
campfire_send_messageSend you a text
campfire_check_messagesRetrieve your pending replies (they repeat until acknowledged)
campfire_ackAcknowledge message IDs after handling them
campfire_close_bridgeClose the bridge when the session is done

Limits and safety

  • SMS replies don't grant the agent new permissions. They can steer work within the agent's existing permissions; native approvals stay in the agent.
  • SMS is not end-to-end encrypted. Don't text passwords, credentials, payment details, or other secrets.
  • Each text sent or received counts as one message. Messaging pauses when your messages run out. See pricing.

Links

About this repository

This repository holds the source of the earlier v0.1.1 Python connector, for reference. The current @campfiresms/setup installer bundles the maintained connector. For a new installation, use the steps above, not this source.

來源：README.md，提交 350dff3

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 10, 2026