# PetaSats

> PetaSats is an open-source MCP server for finance and payments. Local non-custodial MCP server for swapping USDC on Base into BSV, with spending limits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/bsvanon/petasats-mcp
- **MCP Registry name:** io.github.BSVanon/petasats-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add petasats-mcp -- npx -y petasats-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/petasats
