All servers / Web3 / Petasats MCP server
Petasats MCP server
Buy BSV with USDC on Base from your AI app. A local MCP server: keys stay on your machine; settlement is a cross-chain atomic swap.
Tested by ConnectATDScore 86 out of 100. Tested 2026-11-19 on package version 0.2.21. Package: petasats-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 8 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (2.8 seconds including download)
- Tools offered: 10
- Last published: 2026-11-19
- Weekly downloads (npm): 665
- License: SEE LICENSE IN LICENSE · Direct dependencies: 0
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
get_quote3 of 3 parameters describedGet a live quote for buying BSV with USDC on Base. Read-only: nothing is locked or spent. Call it before swap_asset_to_bsv and show the quote to the person directing you; it lasts about 60 seconds, and passing its quote_id to swap_asset_to_bsv uses these terms. Returns quote_id, expires_at, usdc_in, bsv_out, est_bsv_received_sats (after the BSV claim fee), rate_usd_per_bsv, market_mid_usd_per_bsv, price_vs_mid_percent, costs and limits. If the counterparty declines (busy or over a limit), the error carries code, retry_after_s and retry_hint. To send the BSV to another wallet, use fund_wallet: the same quote plus the exact swap call.
swap_asset_to_bsv7 of 7 parameters describedBuy BSV with this kit's USDC on Base through a non-custodial atomic swap with the counterparty. This moves funds: it locks USDC on Base, so get a quote with get_quote first and confirm it with the person directing you. Pass quote_id (or the quote object) to use that quote's terms, or min_bsv_out as a floor; if the quote has expired, the kit gets a new one and goes ahead only if it pays at least min_bsv_out, or 99% of the old quote. Returns at once with swap_id, stage, expected_minutes and the settlement mode; then call wait_for_swap until done is true. Refused while another swap is in progress or spending is stopped. If a swap cannot finish, the USDC comes back to the kit. speed is the buyer’s explicit choice; standard is the default. Fast mode makes the kit reveal its secret against an unconfirmed BSV lock. If the counterparty double-spends that lock, you can lose the swap amount. It is available only when both sides agree and the amount is at most $25; otherwise the swap waits for one BSV confirmation.
wait_for_swap2 of 2 parameters describedWait until a swap's stage changes or it finishes, then return its status. Read-only: it watches this kit's local swap record while the swap runs in the background. After swap_asset_to_bsv, call it repeatedly until swap.done is true; a swap usually finishes within about an hour. Returns changed (false when the wait ended with no change, which is normal: call again), waited_seconds, and swap, the same view swap_status gives: stage, stage_label, step and steps_total, done, outcome (delivered, settled, refunded or failed), eta_minutes and txids with explorer links. Sends progress notifications when the client supplies a progress token. Use swap_status for an instant read.
swap_status1 of 1 parameter describedShow the status of one swap, or of every swap this kit has made. Read-only and instant: it reads the kit's local swap records and changes nothing. Returns swaps, a list (empty when swap_id is unknown). Each entry has swap_id, stage and stage_label, step and steps_total, done, outcome (delivered, settled, refunded or failed), usdc_in, bsv_quoted, bsv_received once settled, deliver_to, eta_minutes, deadlines, txids with explorer links, needs_attention and what_to_do. To wait for the next change, use wait_for_swap rather than calling this in a loop.
wallet_infono parametersShow this kit's own wallets: the Base address that pays for swaps, the BSV address that receives them, their balances, and whether spending is stopped. Read-only; never returns key material. Call it first: if the kit has no USDC, or no ETH for Base gas, tell the user to send them to baseAddress. Returns baseAddress, bsvAddress, usdc and eth balances in atomic units, claimedBsvSats, capUsdPerSwap, spending_stopped (with stopped_at and stop_reason), the limits from limits.json, door_identity, and a backup_note when the wallet is new.
stop_spending1 of 1 parameter describedEmergency stop: block new swaps and withdrawals from this kit until the user runs `npx petasats-mcp resume` in a terminal; no tool can resume it. Use it when the user asks, or when something looks wrong. A swap already started still completes or refunds. Idempotent: calling it again keeps the first stop. Returns stopped: true, at (milliseconds since 1970) and reason, plus already_stopped: true when a stop was already in place.
withdraw_bsv1 of 1 parameter describedSend all of this kit's confirmed BSV to one BSV address. This moves funds and cannot be undone: use only an address the user gave you, and confirm it with them first. It always sends the whole confirmed balance, and the network fee comes out of it; there is no partial amount. Refused while a swap or a BSV delivery is in progress, while spending is stopped, or when limits.json does not allow the address. Returns txid and sats sent, or sats 0 with a reason when there is no confirmed BSV. Use withdraw_base for USDC or ETH; to send a new swap's BSV straight to an address, pass deliver_to to swap_asset_to_bsv.
withdraw_base3 of 3 parameters describedSend USDC or ETH from this kit's Base wallet to another Base address. This moves funds and cannot be undone: use only an address the user gave you, and confirm it with them first. The kit pays the gas in ETH, so withdraw USDC before ETH. Refused while a swap is in progress, while spending is stopped, or when limits.json does not allow the address. Returns asset, amount (atomic and display), to, txid, status and a BaseScan url. Use withdraw_bsv for BSV.
fund_wallet3 of 3 parameters describedPlan sending BSV to a specific BSV address, paid with this kit's USDC on Base. Read-only: it returns a live quote and the exact swap_asset_to_bsv call (with deliver_to set), but moves nothing. Use it when the BSV should land in another wallet; use get_quote when it can stay in this kit. Fails if the kit could not start that swap now (spending stopped, address refused by limits.json, or over the daily limit). Returns plan, quote (the get_quote fields; valid about 60 seconds), swap_call and non_custodial.
list_liquidity1 of 1 parameter describedList the trading pairs this kit supports and how each one settles. Read-only and offline: a fixed list with no prices or balances; use get_quote for a live price and wallet_info for balances. Today there is one pair, USDC on Base to BSV, settled by an on-chain atomic swap with the counterparty; PetaSats never holds funds. Returns pairs (each with pair, route and note), count, non_custodial and settlement.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.