selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

payram-mcp logo

Self-host payram-mcp

v1.1.0

MCP server for self-hosted crypto payments with AI agents

ReleaseOpen Source
Updated8 months ago
LanguageTypescript
Setup difficultyModerate
Stars
158
CPU
2 CPU
RAM
4 GB RAM
Storage
50 GB SSD
Port
3333 (MCP HTTP server (local mode))
Requires
Node.js
Install with Linux
payram-mcp screenshot 1payram-mcp screenshot 2

What is payram-mcp?

PayRam MCP Server is a TypeScript-based Model Context Protocol server that enables AI agents to autonomously set up and operate a self-hosted crypto payment gateway. The server exposes tools for installation planning, diagnostics, admin tasks, and daily operations. It connects to a PayRam gateway deployed on your own VPS which accepts stablecoins and crypto across multiple chains. Key differentiators include no signup or KYC requirements, deposit keys never stored on the server (smart contracts enforce cold wallet sweeps), signed webhooks, and card-to-crypto checkout. The MCP server runs locally on port 3333 and can also be used via a hosted endpoint. Requires Node.js 22+ and yarn.

Should you self-host payram-mcp?

payram-mcp scores 47/100 on selfhost.directory (how scoring works) and ranks #123 of 209 in AI Agents. It has 158 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is written mostly in Typescript.

Its closest alternative on selfhost.directory is xcash (46/100, 189 stars). payram-mcp scores higher overall. See payram-mcp vs xcash side by side.

Features

  • Admin runbooks
  • Agent-first design
  • App scaffolding
  • Code Generation
  • Diagnostics
  • MCP Server
  • Operations playbook
  • Project assessment

payram-mcp README

How to install payram-mcp

Install payram-mcp with Linux

bash <(curl -fsSL https://payram.com/setup_payram_agents.sh) --testnet

Installs the PayRam payment gateway on Ubuntu 22.04+ VPS (interactive once, then headless)

How to configure payram-mcp

  • HOSTNon-loopback bind address (e.g. 0.0.0.0)

    Non-loopback bind address (e.g. 0.0.0.0)

  • MCP_ALLOWED_HOSTSComma-separated hostnames accepted in the Host header

    Comma-separated hostnames accepted in the Host header

  • MCP_SERVER_TOKENchange-meBearer token clients must send for non-loopback binds

    Bearer token clients must send for non-loopback binds

  • PAYRAM_ACCESS_TOKENDashboard login access token (POST /api/v1/signin)

    Dashboard login access token (POST /api/v1/signin)

  • PAYRAM_API_KEYreplace_mePayram API key (see dashboard)

    Payram API key (see dashboard)

  • PAYRAM_BASE_URLhttps://pay.example.comYour PayRam URL: same origin as the dashboard (no :8080)

    Your PayRam URL: same origin as the dashboard (no :8080)

  • PAYRAM_EXTERNAL_PLATFORM_IDDefault external platform ID (optional, can override per tool call)

    Default external platform ID (optional, can override per tool call)

  • PAYRAM_MCP_MODElocalWhere this MCP runs. local (default off Vercel) binds 127.0.0.1

    Where this MCP runs. local (default off Vercel) binds 127.0.0.1

    values: local, hosted

  • PAYRAM_REFRESH_TOKENDashboard login refresh token

    Dashboard login refresh token

  • PORT3333Port for the MCP HTTP server

    Port for the MCP HTTP server

More in AI Agents

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…