Pi coding agent skill and MCP setup

Give the Pi coding agent real non-VoIP numbers to test SMS flows and mobile IPs by country to run your code from. Add the VoidMob MCP server with one pi mcp add line, or install the Agent Skill.

US numbersNumbers
$0.15/code
Dedicated numbersDedicated
$16.99/mo
Mobile proxiesProxies
$3.99/GB
Pi coding agentYour terminal
Terminal
$ pi mcp add voidmob --env VOIDMOB_API_KEY='${VOIDMOB_API_KEY}' -- npx -y @voidmob/mcp$ pi mcp list

Then ask Pi coding agent

What's my VoidMob balance?

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

The single quotes keep ${VOIDMOB_API_KEY} as a reference, so Pi reads the key from your shell each time it starts the server. The server lands in ~/.pi/agent/mcp.json; run /reload in an open session.

Set up VoidMob in Pi coding agent

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 (it is shown once) and top up with crypto. A small balance is plenty for test runs.

  2. Export the key

    Add export VOIDMOB_API_KEY=vmk_live_... to your shell profile, or read it from a password manager with Pi's !command form.

  3. Add the server or the skill

    Run the pi mcp add line for MCP, or the npx skills line for the skill. Try the sandbox line first to watch the tools work before funding anything.

  4. Check it

    pi mcp list shows the server and its connection. Then ask Pi for your VoidMob balance: a number back means the key reached the server.

  5. Keep purchases deliberate

    Pi does not ask before a tool call. Add --env VOIDMOB_MAX_ORDER_CENTS=2500 --env VOIDMOB_BUDGET_CENTS=5000 to pi mcp add to cap each order and the session.

A first task to try

Paste this to Pi coding agent. The panel plays what the setup above makes happen.

Buy the smallest shared mobile proxy plan after showing me the price, make a proxy list for Germany, and run curl through it to tell me the exit IP and carrier.
Pi coding agentvoidmob MCP server
Buy the smallest shared mobile proxy plan after showing me the price, make a proxy list for Germany, and run curl through it to tell me the exit IP and carrier.
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: "de-test", country: "DE"
Created list list_de4k2.
Proxy list · de-testGermany · 4G/5G · HTTP and SOCKS5
user-de-test:••••••@proxy.voidmob.com:10000

Ready. Requests through that login leave from mobile carriers in Germany.

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

A shared plan is billed per GB, so a few test requests use very little of it. The same list login drops into Python, Node or any client that takes an HTTP or SOCKS5 proxy.

Checks before every charge

Two checks always run at VoidMob: the price you approved and your balance. Two more run when you set them: a per-order limit and a session budget in a local MCP server, or optional spending limits on a key or a connected app, which VoidMob enforces itself. 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 Pi coding agent 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 local MCP server, when set

    VOIDMOB_MAX_ORDER_CENTS=2500

    $6.99 is under the $25.00 limit (passed)

  2. Session budgetIn your local 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 Pi coding agent and VoidMob disagree

  • pi mcp list shows the server failing to connect

    Node is older than version 22, or the shell that started Pi never exported the API key.

    Fix

    Check node -v and echo the variable in the same shell, fix whichever is missing, update Pi to a release with MCP support, then /reload or restart it.

  • Your test never receives the code your app sent

    A one-time verification number only takes SMS for the listed service it was rented for.

    Fix

    For your own app, use a dedicated monthly number, which receives SMS from any sender, and point the test account at it.

  • curl through the proxy returns 407

    A brand new proxy list can take a few minutes to become usable, or the list login was copied wrong.

    Fix

    Wait a minute and retry, then copy the connection string again from the create_proxy_list result or the dashboard's Proxy Lists rather than retyping it.

  • A page comes back empty through curl

    Pi has no browser of its own, and curl does not run a page's scripts.

    Fix

    Install agent-browser with npm install -g agent-browser, run agent-browser install, then have Pi start it with --proxy http://<login>:<password>@proxy.voidmob.com:10000. Pass the proxy on the command, not as HTTPS_PROXY, which would also route Pi's model traffic.

Give Pi coding agent 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 Pi coding agent.

How do I add an MCP server to Pi?
Pi has MCP built in. Run pi mcp add voidmob --env VOIDMOB_API_KEY='${VOIDMOB_API_KEY}' -- npx -y @voidmob/mcp, then pi mcp list to check the connection. Servers are user-level by default, in ~/.pi/agent/mcp.json; add -l to write the project's .pi/mcp.json instead.
Can Pi test my app's SMS verification?
Yes, with a dedicated monthly number: it receives SMS from any sender, so Pi can sign up a test account on your staging app and read the code your app sent. One-time numbers only cover the services listed in the VoidMob catalog.
Does Pi ask before buying?
Pi does not prompt before tool calls on its own. VoidMob's server and skill tell it to quote and wait for your answer, and each buy carries that price. For hard limits, start the MCP server with VOIDMOB_MAX_ORDER_CENTS and VOIDMOB_BUDGET_CENTS; a permission extension that reads MCP annotations, if you install one, can also stop spending tools.
Skill or MCP server for Pi?
The MCP server gives Pi the VoidMob tools directly and a play-money sandbox; the skill needs no extra process and teaches Pi the REST API through curl. Both read the key from your shell. One of the two is enough.

Based on Pi coding agent's own docs: MCP · Skills · GitHub repository. Last checked .