# Bitpal

> Bitpal is an MCP server for finance and payments. Lets coding agents search BitPal docs, API spec and webhooks and test stablecoin payments. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** Web, API, CLI
- **Website:** https://bitpal.io/docs/
- **MCP Registry name:** io.github.superlabs-x/bitpal
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

BitPal is a non-custodial stablecoin checkout: each order gets its own deposit address, the buyer sends funds from any wallet or exchange with no wallet connection, and money settles straight to the merchant's registered payout wallet. This MCP server brings that documentation into the coding agent. The registry entry says it searches the docs, API spec, webhook events and error codes and can run test payments, over stdio from npm or a hosted Streamable HTTP endpoint.

The docs it draws on cover three integration routes. An SDK creates hosted checkout sessions, payment links need no code, and x402 charges per API call. Accepted assets are USDC on Base, Arbitrum, Optimism, BNB Chain, Polygon and Solana, USDT on BNB Chain, Polygon and Solana with Tron listed as coming soon, and JPYC on Polygon and Kaia, always same-chain and same-token. Sessions need a payout wallet registered in the console, test and live modes are separate, and the minimum session total is 1.00.

It is most useful while wiring up the first test payment, which the quickstart puts at about ten minutes on a testnet.

## Features

- **Docs and API search:** Searches BitPal documentation and API specification from inside the editor.
- **Webhooks and errors:** Looks up webhook events such as checkout.session.paid and documented error codes.
- **Test payments:** Supports testing payments against test-mode keys and testnets.
- **Two transports:** Runs locally over stdio from npm or as a hosted Streamable HTTP endpoint.
- **Non-custodial design:** The documented checkout settles to your own wallet with no escrow or custody.

## Good for

- Look up the right session parameters while integrating checkout
- Debug a failing webhook signature or error code
- Check supported chains and tokens before configuring a payout wallet
- Walk through a testnet payment from session creation to the paid webhook
- Choose between SDK checkout, payment links and x402

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bitpal https://mcp.bitpal.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.bitpal.io/mcp
```

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

```json
{
  "mcpServers": {
    "bitpal": {
      "url": "https://mcp.bitpal.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "bitpal": {
      "type": "http",
      "url": "https://mcp.bitpal.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bitpal": {
      "serverUrl": "https://mcp.bitpal.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.bitpal.io/mcp
```

Enter a Name (for example "Bitpal"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "bitpal": {
      "type": "http",
      "url": "https://mcp.bitpal.io/mcp"
    }
  }
}
```

## FAQ

### Is BitPal custodial?

No. The docs say payments settle straight to the merchant's own wallet, with no escrow or custody.

### Which stablecoins and networks are supported?

USDC on Base, Arbitrum, Optimism, BNB Chain, Polygon and Solana, USDT on BNB Chain, Polygon and Solana, and JPYC on Polygon and Kaia.

### How can I run the MCP server?

Install the @bitpal/mcp package over stdio, or use the hosted endpoint at mcp.bitpal.io.

### Can I test without real funds?

Yes. The quickstart uses a test-mode console account, a bp_test_ key and a testnet wallet.

### Does it need an API key?

The registry lists no required environment variables for the MCP package. Creating real sessions needs a BitPal API key.

### How do I add Bitpal to Claude Code?

Run this command in your terminal: claude mcp add --transport http bitpal https://mcp.bitpal.io/mcp

### What are the best alternatives to Bitpal?

The closest alternatives to Bitpal are PayRam, XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP, Bilbop x402, StablecoinX and PayAPI Market.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [PayRam](https://ai-powered.com/mcp/payram): PayRam is an open-source MCP server for finance and payments.
- [XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP](https://ai-powered.com/mcp/xpayr-non-custodial-crypto-gateway-and-ai-agent-commerce-mcp): XPayr Non-Custodial Crypto Gateway & AI Agent Commerce MCP is a paid MCP server for finance and payments.
- [Bilbop x402](https://ai-powered.com/mcp/bilbop-x402): Bilbop x402 is a paid MCP server for finance and payments.
- [StablecoinX](https://ai-powered.com/mcp/stablecoinx): StablecoinX is an MCP server for finance and payments.
- [PayAPI Market](https://ai-powered.com/mcp/payapi-market): PayAPI Market is a free MCP server for developer tools.
- [SelfPaidPal — Autonomous DeFi Payments](https://ai-powered.com/mcp/selfpaidpal-autonomous-defi-payments): SelfPaidPal — Autonomous DeFi Payments is an open-source MCP server for finance and payments.
- [Minia2a MCP Remote](https://ai-powered.com/mcp/minia2a-mcp-remote): Minia2a MCP Remote is an MCP server for finance and payments.
- [x402 Doctor](https://ai-powered.com/mcp/x402-doctor-2): x402 Doctor is a freemium MCP server for developer tools.

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