Skip to content
MCP server

PetaSats

Local non-custodial MCP server for swapping USDC on Base into BSV, with spending limits

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.19
Listing updated
2 days ago

About PetaSats

PetaSats is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

This server runs on your machine and handles one narrow job: buying BSV with USDC on Base. Keys are generated and kept locally in a folder under the home directory, and the README warns that the keys file is the only copy and must be backed up. The wallet needs USDC plus a little ETH for gas.

A swap locks USDC in a contract on Base, the market maker locks BSV, and the kit checks that lock against a merkle proof and block headers before it claims the BSV. BSV heights and headers are read from three independent sources and two must agree. Swaps are roughly $5 to $100, each buyer is limited to three swaps and $200 a day, and a fast mode that skips the confirmation wait is capped at $25 and carries a double-spend risk the README spells out.

You can restrict an AI with a private limits file listing allowed BSV and Base destinations and a daily swap cap, and a stop_spending tool halts new swaps at once. These limits guard against an AI confined to the tools, not one that can edit files as you.

Install

Run in a terminal

claude mcp add petasats-mcp -- npx -y petasats-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "petasats-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "petasats-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "petasats-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "petasats-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "petasats-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "petasats-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "petasats-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "petasats-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "petasats-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "petasats-mcp"
      ]
    }
  }
}

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

get_quote
Show the swap rate and comparison with market mid.
swap_asset_to_bsv
Start a USDC-to-BSV swap.
wait_for_swap
Wait for a swap to finish.
swap_status
Check the state of a swap.
wallet_info
Show the Base address and wallet details.
stop_spending
Stop new swaps and withdrawals immediately.
withdraw_bsv
Withdraw BSV to an address.
withdraw_base
Withdraw assets on Base to an address.
fund_wallet
Plan a USDC-to-BSV swap and return a quote.
list_liquidity
List available liquidity.

What it does

Non-custodial keys
Keys are created and stored on your machine under a folder you can relocate.
Verified before reveal
The kit checks the BSV lock against a merkle proof and block headers before claiming.
Limits file
Restrict destination addresses, a daily USD swap cap and fast settlement.
Emergency stop
stop_spending halts new swaps and withdrawals; only you can resume.
Recovery commands
Status, recover and withdrawal commands handle interrupted swaps.
Multi-source chain data
BSV heights and headers come from three sources, two of which must agree.

Good for

  • Buy a set amount of BSV with USDC from an AI chat
  • Get a quote and compare the rate with market mid
  • Cap how much an AI can swap per day
  • Withdraw BSV or Base assets to an approved address
  • Resume a swap after the server was interrupted

Pricing

Open source

Swap costs are Base gas, a BSV claim fee and protocol fees shown in get_quote

PetaSats FAQ

What swaps are supported?

Only USDC on Base to BSV.

What are the swap limits?

Swaps are about $5 to $100, with three swaps and $200 a day per buyer and a shared daily total.

Who holds the keys?

You do. They are created locally and the README says to back up keys.json.

What is fast mode?

A buyer-chosen option for swaps of $25 or less that reveals the secret against an unconfirmed BSV lock, with a risk of losing the amount if the lock is double-spent.

What does it need to run?

Node.js 22 or newer.

Is PetaSats free?

Yes. PetaSats is open source, so you can use and self-host it for free.

How do I add PetaSats to Claude Code?

Run this command in your terminal: claude mcp add petasats-mcp -- npx -y petasats-mcp

What are the best alternatives to PetaSats?

The closest alternatives to PetaSats are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to PetaSats

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government