Boat skill and MCP setup

Give the agents in your Boat sandboxes a 4G/5G mobile IP in the country you pick, real US numbers for codes and a dedicated number for your app's SMS tests. Keep the key in your Boat environment and set it up once.

US numbersNumbers
$0.15/code
Dedicated numbersDedicated
$16.99/mo
Mobile proxiesProxies
$3.99/GB
BoatBoat cloud sandboxes in the EU
Your terminal, then a shell inside the sandbox
# your terminal$ boat env set-var base VOIDMOB_API_KEY=vmk_live_...$ boat new$ boat ssh# inside the sandbox$ npx skills add voidmobcom/voidmob-mcp --skill voidmob -g -a claude-code -a codex -a pi -y

Then ask Boat

What's my VoidMob balance?

A number back means the key and the install both work.

One line puts the skill in the skills folders of Claude Code, Codex and Pi, so whichever agent boat prompt hands the task to can use it. The skill calls the VoidMob API with curl and reads the key from the sandbox environment.

Set up VoidMob in Boat

One step is yours whichever path you take: create an API key in the dashboard and top up the balance with crypto.

  1. Create a key and fund the balance

    Create a key under Developers, API Keys in the VoidMob dashboard (it is shown once) and top up with crypto. Agents can spend the balance and nothing beyond it.

  2. Save the key in your Boat environment

    Run boat env set-var base VOIDMOB_API_KEY=... or add it on the Environment tab of the Boat dashboard. Sandboxes started after that get it as an environment variable.

  3. Start a sandbox and install

    Run boat new, open a shell with boat ssh and paste the skill or MCP line. Try the sandbox line of the MCP server first to watch the tools work on play money.

  4. Ask for your balance

    Back in your terminal, run boat prompt "What is my VoidMob balance?". A number in the reply means the key reached the agent.

  5. Save it as a snapshot

    Run boat snapshot <id> voidmob once. Every boat new --from voidmob after that starts with VoidMob installed and takes the key from your default environment.

A first task to try

Paste this to Boat. The panel plays what the setup above makes happen.

This sandbox is in Europe. Quote me the smallest shared mobile proxy plan and stop. After my yes, buy it, make a US proxy list and fetch our pricing page through it to show me the US prices.
Boatvoidmob MCP server
This sandbox is in Europe. Quote me the smallest shared mobile proxy plan and stop. After my yes, buy it, make a US proxy list and fetch our pricing page through it to show me the US prices.
search_proxiestype: "shared"
1 GB · 30 days $3.99 10 GB · 30 days $35.00

The smallest shared plan is 1 GB for 30 days at $3.99. Country, city and carrier are set per proxy list after you buy. Go ahead?

Go.
purchase_proxyplan_id: "plan_sh1g30", max_price_cents: 399spends $3.99
Proxy prx_9d2h4 is active ($3.99). Call get_proxy_status for its credentials.
create_proxy_listproxy_id: "prx_9d2h4", name: "us-test", country: "US"
Created list list_de4k2.
Proxy list · us-testUnited States · 4G/5G · HTTP and SOCKS5
user-us-test:••••••@proxy.voidmob.com:10000

Ready. Requests through that login leave from mobile carriers in United States.

Prices from today's catalog. The IDs and login are examples.

Boat keeps the conversation between prompts, so the yes can come minutes later from another terminal. A shared plan is billed per GB, and fetching a few pages uses very little of it.

Checks before every charge

Two checks always run at VoidMob: the price you approved and your balance. Two more run inside your MCP server when you set them. A refusal at any of them charges nothing.

No SMS, no charge

A verification number stays open 15 minutes. If no SMS arrives, the price returns to the balance automatically, except on services marked non-refundable.

Keys you can pull

Give Boat its own key and revoke it on the API Keys page whenever you like. It stops working at once.

See every scenario on the MCP page
purchase_esimmax_price_cents: 699Japan · 5 GB · 15 days · $6.99
  1. Per-order limitIn your MCP server, when set

    VOIDMOB_MAX_ORDER_CENTS=2500

    $6.99 is under the $25.00 limit (passed)

  2. Session budgetIn your MCP server, when set

    VOIDMOB_BUDGET_CENTS=5000

    $6.99 of $50.00 left (passed)

  3. Price you approvedAt VoidMob, always

    max_price_cents

    Live $6.99, approved $6.99 (passed)

  4. Your balanceAt VoidMob, always

    prepaid, topped up by you

    $42.10 covers it (passed)

Item price from today's catalog. Limits are the README's $25 per order and $50 per session; the balance is an example.Charged $6.99, the price you approved

When Boat and VoidMob disagree

  • The agent reports that VOIDMOB_API_KEY is not set

    The sandbox started before you saved the variable, and a sandbox keeps the environment version it started with.

    Fix

    Run boat env upgrade base to move running sandboxes to the latest version, or start a new sandbox, then prompt again.

  • Codex or Pi turns cannot see the VoidMob tools

    claude mcp add registers the server for Claude Code only. Each agent on the sandbox reads its own MCP list.

    Fix

    Install the skill, which the npx skills line puts in every agent's skills folder at once, or add the server to that agent with its own command, codex mcp add for Codex.

  • Model calls slow down or fail once a proxy is set

    HTTPS_PROXY in the Boat environment sends every process through the proxy, the agents' own model traffic included.

    Fix

    Keep proxy variables out of the environment. Give the list login only to the script that needs it, such as curl -x, a requests session or Playwright's launch options.

  • Chrome on the sandbox desktop still shows the sandbox address

    Chrome takes a proxy only as a launch flag, and that flag has no place for the list's username and password.

    Fix

    Drive the browser with Playwright instead and pass the list's server, username and password in its proxy launch option.

Give Boat a balance to draw on

Create an API key, top it up with crypto, and paste it where the setup above says. Prefer to look first? The MCP server runs on play money with no key.

Frequently Asked Questions

Common questions about VoidMob in Boat.

Based on Boat's own docs: Integrated agents · Environments · CLI reference · Snapshots and copies · FAQ: regions · Claude Code MCP · Agent Skills CLI. Last checked .