# Probarion

> Probarion is an open-source MCP server for finance and payments. Let an AI agent pay USDC on NEAR only within owner-signed mandates, with a signed ledger. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://probarion.xyz
- **Repository:** https://github.com/probarion/probarion/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.probarion/probarion
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-14

## About

The core idea is to take the spending rule out of the prompt. The owner signs a mandate naming the payee and setting per-payment and total caps, a use count and an expiry. The agent's key can call only one contract method, spend, which has no recipient argument, so a hijacked invoice cannot redirect funds. A NEAR contract refuses anything outside the mandate.

The tools let the agent list its mandates, dry-run a payment against the contract's check_spend view, pay under a mandate and read a payment's status. Every decision, including refusals, goes into a signed ledger that a verifier can check and the owner can publish. Without keys the server is read-only.

The project is described as an unaudited beta, testnet first, with small amounts advised, and non-custodial since Probarion holds no owner key. The code is MIT licensed, and a live demo page asks the testnet contract directly.

## Features

- **Mandate-bound spending:** Payments only go to the payee and limits the owner signed.
- **No recipient argument:** spend takes no address, so prompts cannot redirect money.
- **Dry-run checks:** check_spend asks the contract whether a payment would pass.
- **Signed ledger:** Every decision, including refusals, is recorded for verification.
- **Read-only fallback:** With no keys the server only reads.
- **Testnet demo:** A live page queries the testnet vault.

## Good for

- Let an agent pay supplier invoices within fixed caps
- Prove after the fact what an agent paid and what it was refused
- Test agent payments on NEAR testnet with test USDC

## Install

### Claude Code (Terminal)

```sh
claude mcp add probarion --env PROBARION_VAULT_ID='<PROBARION_VAULT_ID>' --env PROBARION_AGENT_KEY='<PROBARION_AGENT_KEY>' --env PROBARION_LEDGER_KEY='<PROBARION_LEDGER_KEY>' -- npx -y @probarion/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "probarion": {
      "command": "npx",
      "args": [
        "-y",
        "@probarion/mcp"
      ],
      "env": {
        "PROBARION_VAULT_ID": "<PROBARION_VAULT_ID>",
        "PROBARION_AGENT_KEY": "<PROBARION_AGENT_KEY>",
        "PROBARION_LEDGER_KEY": "<PROBARION_LEDGER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "probarion": {
      "command": "npx",
      "args": [
        "-y",
        "@probarion/mcp"
      ],
      "env": {
        "PROBARION_VAULT_ID": "<PROBARION_VAULT_ID>",
        "PROBARION_AGENT_KEY": "<PROBARION_AGENT_KEY>",
        "PROBARION_LEDGER_KEY": "<PROBARION_LEDGER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "probarion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@probarion/mcp"
      ],
      "env": {
        "PROBARION_VAULT_ID": "<PROBARION_VAULT_ID>",
        "PROBARION_AGENT_KEY": "<PROBARION_AGENT_KEY>",
        "PROBARION_LEDGER_KEY": "<PROBARION_LEDGER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "probarion": {
      "command": "npx",
      "args": [
        "-y",
        "@probarion/mcp"
      ],
      "env": {
        "PROBARION_VAULT_ID": "<PROBARION_VAULT_ID>",
        "PROBARION_AGENT_KEY": "<PROBARION_AGENT_KEY>",
        "PROBARION_LEDGER_KEY": "<PROBARION_LEDGER_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "probarion": {
      "command": "npx",
      "args": [
        "-y",
        "@probarion/mcp"
      ],
      "env": {
        "PROBARION_VAULT_ID": "<PROBARION_VAULT_ID>",
        "PROBARION_AGENT_KEY": "<PROBARION_AGENT_KEY>",
        "PROBARION_LEDGER_KEY": "<PROBARION_LEDGER_KEY>"
      }
    }
  }
}
```

## Tools

- `list_mandates`: Lists the mandates available to the agent's key.
- `check_spend`: Asks the vault contract whether a payment would be allowed; nothing is signed or paid.
- `spend`: Pays under a mandate to its signed payee.
- `get_spend_status`: Reads the status of a payment.

## FAQ

### Is it production ready?

No. It is labelled an unaudited beta with testnet first and small amounts advised.

### Does Probarion hold my keys?

No, it is non-custodial and holds no owner key.

### Can the agent choose the recipient?

No. The payee comes from the mandate.

### Which network?

NEAR mainnet or testnet, chosen by the vault account name.

### Is Probarion free?

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

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

Run this command in your terminal: claude mcp add probarion --env PROBARION_VAULT_ID='<PROBARION_VAULT_ID>' --env PROBARION_AGENT_KEY='<PROBARION_AGENT_KEY>' --env PROBARION_LEDGER_KEY='<PROBARION_LEDGER_KEY>' -- npx -y @probarion/mcp

### What are the best alternatives to Probarion?

The closest alternatives to Probarion are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

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