PayRam
Agent-driven install and operation of a self-hosted PayRam crypto payment gateway
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.payram.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.payram.com/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools