Skip to content
MCP server

three.ws Agent Payments

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.5
Listing updated
2 days ago

About three.ws Agent Payments

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

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

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

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

{
  "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>"
      }
    }
  }
}

Configuration

  • THREE_WS_SESSIONYour three.ws session token (value of the `__Host-sid` cookie from a signed-in browser). Required for account management operations: create_payment_session, list_payment_sessions, check_payment_session, cancel_payment_session.
  • PAYMENT_SESSION_TOKENA payment session bearer token (starts with 'pss_') from create_payment_session. Used by the agent for pay_with_session calls when no inline token is passed. Treat like a spending card — it authorizes payments up to the session's budget.
  • THREE_WS_BASEBase URL of the three.ws API. Override only when self-hosting or targeting a preview deployment.
  • THREE_WS_TIMEOUT_MSPer-request HTTP timeout in milliseconds. x402 payments involve on-chain settlement so this should be generous (default: 30000).

Pricing

Open source

Prices change. Check three.ws before you buy.

three.ws Agent Payments 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 to three.ws Agent Payments

  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

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