# three.ws Agent Payments

> three.ws Agent Payments is an open-source MCP server for finance and payments. Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Website:** https://three.ws
- **Repository:** https://github.com/nirholas/three.ws/tree/HEAD/packages/agentcore-payments-mcp
- **MCP Registry name:** io.github.nirholas/agentcore-payments-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-16

## About

Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.

## Install

### Claude Code (Terminal)

```sh
claude mcp add agentcore-payments-mcp --env THREE_WS_SESSION='<THREE_WS_SESSION>' --env PAYMENT_SESSION_TOKEN='<PAYMENT_SESSION_TOKEN>' -- npx -y @three-ws/agentcore-payments-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agentcore-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/agentcore-payments-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<THREE_WS_SESSION>",
        "PAYMENT_SESSION_TOKEN": "<PAYMENT_SESSION_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentcore-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/agentcore-payments-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<THREE_WS_SESSION>",
        "PAYMENT_SESSION_TOKEN": "<PAYMENT_SESSION_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "agentcore-payments-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/agentcore-payments-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<THREE_WS_SESSION>",
        "PAYMENT_SESSION_TOKEN": "<PAYMENT_SESSION_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentcore-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/agentcore-payments-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<THREE_WS_SESSION>",
        "PAYMENT_SESSION_TOKEN": "<PAYMENT_SESSION_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agentcore-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/agentcore-payments-mcp"
      ],
      "env": {
        "THREE_WS_SESSION": "<THREE_WS_SESSION>",
        "PAYMENT_SESSION_TOKEN": "<PAYMENT_SESSION_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is three.ws Agent Payments free?

Yes. three.ws Agent Payments is open source, so you can use and self-host it for free.

### How do I add three.ws Agent Payments to Claude Code?

Run this command in your terminal: claude mcp add agentcore-payments-mcp --env THREE_WS_SESSION='<THREE_WS_SESSION>' --env PAYMENT_SESSION_TOKEN='<PAYMENT_SESSION_TOKEN>' -- npx -y @three-ws/agentcore-payments-mcp

### What are the best alternatives to three.ws Agent Payments?

The closest alternatives to three.ws Agent Payments 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/three-ws-agent-payments
