# PayRam

> PayRam is an open-source MCP server for finance and payments. Agent-driven install and operation of a self-hosted PayRam crypto payment gateway. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, API, CLI
- **Website:** https://mcp.payram.com
- **Repository:** https://github.com/payram/payram-mcp
- **MCP Registry name:** com.payram/mcp
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

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

```sh
https://mcp.payram.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.payram.com/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

- `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.

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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