Skip to content
MCP server

PayRam

Agent-driven install and operation of a self-hosted PayRam crypto payment gateway

Install
Pricing
Open source
Platforms
self-hosted, API, CLI
Runs
Remotely
Version
1.2.0
Listing updated
2 days ago

About PayRam

PayRam is an open-source MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

The server is aimed at the person or agent setting PayRam up rather than at the shopper paying. Its lead tool builds a personalised install plan and marks every step that needs a human. Others check a running PayRam server by URL without credentials, diagnose pasted errors with known causes and fixes, and walk through admin tasks such as domain, SSL, firewall, upgrades, backups, chains and Shopify or WooCommerce setup. Code generators produce payment routes, status endpoints and webhook handlers for frameworks including Express, Next.js, FastAPI, Laravel, Go and Spring Boot.

The README is explicit that the hosted endpoint never holds merchant credentials. Day-2 operations run through payram_ops_playbook, where the agent calls your own PayRam API with credentials that stay on its machine. Tools that search payments, create payment links or restart workers exist only when you run the MCP server yourself in local mode.

PayRam itself is described as a self-hosted gateway with no signup or KYC to run it, deposit keys kept off the server, and smart contracts audited by QuillAudits in July 2025. It takes USDT and USDC on Ethereum, Base, Polygon and Tron, Bitcoin, and other chains through a Smart Bridge, plus optional card-to-crypto checkout. Operators remain responsible for their own compliance.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.payram.com/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.payram.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.payram.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.payram.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.payram.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.payram.com/mcp"
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

payram_setup_plan
Builds a personalised install plan with every human hand-off marked.
payram_doctor
Runs a public, credential-free check of a PayRam server by URL.
payram_troubleshoot
Takes a described problem or pasted error and returns known causes, how to confirm, the fix and the next tool.
payram_runbook
Covers admin tasks such as Site URL, domain, SSL, firewall, upgrade, backup, chains and Smart Bridge.
payram_ops_playbook
Gives day-2 API recipes the agent runs itself with its own credentials.
assess_payram_project
Assesses a codebase for PayRam integration; local mode only.

What it does

Personalised install plan
payram_setup_plan produces a setup plan with every human hand-off marked.
Credential-free health check
payram_doctor inspects a PayRam server by URL without credentials.
Error troubleshooting
payram_troubleshoot maps a described problem to causes, a fix and the next tool.
Admin runbooks
payram_runbook covers domain, SSL, firewall, upgrade, backup, chains and store plugins.
Framework code generation
Generates payment routes, status checks and webhook handlers for common stacks.
Local mode
Running the server yourself adds payment search, payment links and worker restart.

Good for

  • Have an agent plan and install a self-hosted crypto payment gateway
  • Diagnose a failing PayRam deployment from an error message
  • Generate webhook handlers for an existing web app
  • Run backups or upgrades following a runbook
  • Connect a Shopify or WooCommerce store to PayRam

Pricing

Open source

Self-hosted; hosted MCP endpoint at mcp.payram.com; no price listed

Prices change. Check mcp.payram.com before you buy.

PayRam FAQ

Does the hosted server hold my keys?

No. The README says the hosted server never holds merchant credentials; day-2 calls go from the agent to your own PayRam API.

Which tools only work locally?

Payment search, payment links, node sync, worker restart and assess_payram_project exist only in local mode.

Which coins and chains are supported?

The README lists BTC, ETH, USDT, USDC and TRX across Bitcoin, Ethereum, Base, Polygon and Tron, with Solana and BNB Chain through Smart Bridge rails.

Is KYC needed to run it?

The site says there is no signup or KYC to run PayRam, and that compliance for your own operation is your responsibility.

Is PayRam free?

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

How do I add PayRam to Claude Code?

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

What are the best alternatives to PayRam?

The closest alternatives to PayRam are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to PayRam

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools