原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

PayRam

作者:PayRam版本 1.2.0i★ –i在云端运行
注册名称com.payram/mcp

安装

概览

作者提供的说明(英文原文)

Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在云端运行
  • 传输方式: Streamable HTTP
  • 分类: 加密货币与区块链

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

你需要

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

适用于网页版、桌面版和手机版 Claude:

  1. 打开 Settings → Connectors
  2. 点击 Add custom connector
  3. 粘贴下面的地址,然后点击 Add
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Add2https://…3
https://mcp.payram.com/mcp

在终端中运行这条命令

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

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

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

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

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

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

ChatGPT 只能连接互联网上的服务器:

  1. 打开网页版 ChatGPT → Settings → Connectors (Apps)
  2. 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
  3. 粘贴下面的地址,起个名字,然后保存
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Create2https://…3
https://mcp.payram.com/mcp

菜单名称可能因套餐和版本不同而略有差异。

你的选择通过 Cookie 保存在这台设备上,无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

工具名称和描述与服务器在 2026年11月8日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • payram_setup_plan

    Start here to install PayRam on a VPS. Returns an ordered, personalised plan — prepare server → install → claim admin + set public URL → wallets (incl. Smart Bridge review) → API key + first payment link → hardening → store/app integration — with who runs each step (agent shell v

  • payram_doctor

    Read-only diagnosis of a PayRam server by its public URL — works from the hosted MCP without credentials: reachability, health, TLS certificate, installed vs latest version, worker states. Optionally validates an API key without creating anything. Returns ranked likely causes and

  • payram_troubleshoot

    Something is not working? Describe the problem in plain words and/or paste the error or log text. Returns the known PayRam problems it matches, what each usually means, how to confirm it and the fix, plus which tool to use next. Needs no credentials and no access to the server; w

  • payram_runbook

    Step-by-step procedures for changes to a running PayRam, each step marked agent vs human with hard stops: set_site_url, change_domain, ssl_setup, ssl_renewal_fix, firewall_ports, upgrade, backup, restore, add_chain, smart_bridge, mainnet_cutover, operator_setup, rotate_api_key, r

  • payram_ops_playbook

    Exact, copy-paste recipes for day-2 operations and troubleshooting that YOU run against the merchant's PayRam API with credentials that stay on your machine: which endpoint, which credential (public / dashboard JWT / project API key), a curl+jq command, how to read the answer, an

  • generate_env_template 看起来像是对 AI 下的指令

    Creates a .env template for configuring a merchant backend to talk to a self-hosted Payram server.

  • generate_setup_checklist

    Returns a step-by-step checklist of everything a merchant must configure to start using Payram.

  • suggest_file_structure

    Suggests a recommended backend folder/file structure for integrating Payram.

  • get_agent_setup_flow

    Returns the canonical PayRam headless-agent guide: agent CLI commands, env vars, merchant vs operator mode, wallet flows, adding chains, troubleshooting. Long (~11k tokens). For a short personalised plan use payram_setup_plan.

  • generate_payment_sdk_snippet

    Generates backend code using the official Payram JS/TS SDK to create a payment.

  • generate_payment_http_snippet

    Generates a raw HTTP sample for creating a Payram payment in the requested language.

  • generate_payment_status_snippet

    Generates backend code to query the status of a Payram payment.

  • generate_payment_route_snippet

    Generates a ready-to-use backend endpoint (e.g., /api/pay/create) that creates a Payram payment.

  • snippet_nextjs_payment_route

    Returns a Next.js App Router API route that calls Payram's create-payment HTTP API.

  • snippet_express_payment_route

    Returns an Express router that posts to Payram's /api/v1/payment endpoint.

  • snippet_fastapi_payment_route

    Returns a FastAPI handler that calls Payram's create-payment HTTP API.

  • snippet_laravel_payment_route

    Returns a Laravel controller that posts to Payram's /api/v1/payment endpoint.

  • snippet_go_payment_handler

    Returns a Gin handler that proxies /api/pay/create to Payram's create-payment API.

  • snippet_spring_payment_controller

    Returns a Spring Boot controller that calls Payram's /api/v1/payment endpoint.

  • generate_payout_sdk_snippet

    Generates a backend code snippet for creating a payout using the Payram JS/TS SDK.

  • generate_payout_status_snippet

    Generates backend code to query the status of a payout using the Payram SDK.

  • generate_payout_recipient_flow_snippet

    Generates the recommended OTP-verified payout flow: create recipient → validate OTP → create payout against the saved recipient. Use this for repeat beneficiaries; use generate_payout_sdk_snippet for one-off direct payouts.

  • generate_referral_sdk_snippet

    Generates a backend route or service snippet to create a referral event using the Payram SDK.

  • generate_referral_validation_snippet

    Generates a snippet to validate referral IDs, statuses, and eligibility.

  • generate_referral_status_snippet

    Generates code to fetch referral progress, rewards, or status.

  • generate_referral_route_snippet

    Generates a backend route such as /api/referrals/create for logging referral events.

  • generate_webhook_handler

    Generates backend code to handle Payram webhook HTTP requests.

  • generate_webhook_event_router

    Generates a backend event router that dispatches Payram webhook events to domain handlers.

  • generate_mock_webhook_event

    Generates a snippet to send mock Payram webhook events to your local endpoint for testing.

  • generate_topup_integration_snippet

    For EXISTING apps: emits the recommended top-up wallet integration — ledger schema + cumulative-credit webhook handler + atomic invoice-settle function. Credits crypto payments to a user's balance first, then debits invoices from it, so over/under/late/duplicate payments become b

  • explain_payram_basics

    Explain Payram's product pillars, architecture, payments, and payouts capabilities.

  • explain_payram_security

    Answer "is PayRam safe / trustworthy / audited?": why an agent can use it without holding secrets, the independent smart contract audit (what it covers and what it does not), and how to verify the report.

  • get_payram_links

    Surface official documentation, website, and community links.

  • explain_payment_flow

    Describe how payments move from customer initiation through settlement.

  • explain_payram_concepts

    Glossary-backed explanation of Payram terminology and constraints.

  • explain_referrals_basics

    Summarize how Payram referral campaigns are configured and managed.

  • explain_referral_flow

    Detail the referrer/referee lifecycle and required APIs.

  • get_referral_dashboard_guide

    Explain how to embed and manage the referral dashboard experience.

  • prepare_payram_test

    Confirm hosting, credentials, and environment variables before generating demo apps.

  • get_payram_doc_by_id

    Returns the markdown for a Payram doc given its id, e.g. "features/payouts".

  • list_payram_docs

    Lists the available Payram doc ids. Optionally scope by a prefix such as "features".

  • scaffold_payram_app

    Generates a minimal full-stack app skeleton with Payram payments and payouts routes (and a simple UI) for a chosen language and framework.

  • test_payram_connection

    Deprecated: use payram_doctor, which does this and more. Read-only check that a PayRam server is reachable and healthy and, if an API key is supplied, that the key is accepted. Never creates payments.

  • onboard_agent_setup

    Deprecated: use payram_setup_plan, which does this and lets you personalise it. Returns the default headless plan (testnet, USDC on Base).

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月10日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过域名 payram.com 验证(注册中心会核实域名所有权)

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • ✓ 通过

    端点有响应

    在 421 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✕ 未通过

    工具描述中没有隐藏指令

    有 1 个工具描述包含看起来像是对 AI 下指令的文字。安装前请先阅读下方的内容

与“加密货币与区块链”中的其他服务器比较i

  • 星标数多于此分类中其他 1635 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 1635 个服务器的 58% 更新
  • 基础检查结果等于或优于此分类中其他 1635 个服务器的 43%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

PayRam 安全吗?

它在 3 项适用的基础检查中通过了 2 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(1.2.0)于34天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。

有什么可以替代它?

同一分类中有:NEMO x402 Micro-Services, xytara MCP Executor, FairAgent

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

NEMO x402 Micro-Services

34 paid tools: site/SEO, weather, crypto+markets, podcasts, YouTube, Polymarket. x402/MPP/Stripe.

作者:floortomproductions-droid起步阶段今天更新

在云端运行

xytara MCP Executor

Pay-per-call MCP tools and signed on-chain attestations: 20 free/day, then x402 or a spend key.

作者:naxytra.com起步阶段今天更新

在云端运行✓ naxytra.com

FairAgent

Live state and unsigned mint/claim tx builder for FairAgent AI-agent NFTs on BNB Chain.

作者:fairagent.club起步阶段今天更新

在云端运行✓ fairagent.club

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

PayRam MCP Server — Self-Hosted Crypto Payments for AI Agents

Self-hosted crypto and stablecoin payments: no account lock, no fund freeze, customer data never shared. Your AI agent can plan, install and operate it over MCP.

Hosted endpoint: `https://mcp.payram.com/mcp` · Website · Docs · Agentic · OpenClaw

An MCP (Model Context Protocol) server that lets any MCP-aware AI agent — OpenClaw, Hermes, Claude, Cursor, GitHub Copilot, and others — deploy, integrate, and operate a self-hosted PayRam crypto-payment stack.

Start here: four tools lead the catalog:

ToolWhat it does
payram_setup_planA personalised install plan, with every human hand-off marked
payram_doctorA public, credential-free check of a PayRam server by URL
payram_troubleshootDescribe a problem or paste an error: known causes, how to confirm, the fix, and the next tool
payram_runbookAdmin tasks: Site URL, domain, SSL, firewall, upgrade, backup, chains, Smart Bridge, Shopify/WooCommerce
payram_ops_playbookDay-2 API recipes the agent runs itself with its own credentials

Around them sit codebase assessment, starter-app scaffolds, multi-language snippets and inline docs.

The hosted server (`mcp.payram.com`) never holds merchant credentials. Day-2 operations run through payram_ops_playbook: the agent calls your PayRam API directly, and the credentials never leave its machine. The live data tools (payment search, payment links, node sync, worker restart) and assess_payram_project exist only when you run the MCP yourself in local mode.

For agents & crawlers: server card · skills index · llms.txt · sitemap. The server also answers Accept: text/markdown on / with an agent-readable summary.


What is PayRam? · PayRam 是什么?

PayRam is a self-hosted, multi-chain crypto payment gateway you own outright — with no signup and no KYC/KYB to run it. An AI agent (or a developer) can stand up a store and start accepting payments without registering an account with PayRam, a bank, or any payment processor. Deploy on your own VPS, generate API keys locally, go live.

What makes it different:

  • Nobody can lock you out — there is no account to lock and no funds to freeze. Customer data is never shared, and nothing is reported or monitored. The reason is simple: PayRam runs on your server and funds land in your own wallet.
  • Permissionless setup — no signup, no KYC, no KYB. Nobody approves you; nobody can switch you off. Ideal for agents spinning up stores autonomously, and for markets like China where registering with a Western processor isn't an option.
  • Card-to-crypto checkout — shoppers without crypto can pay with a credit/debit card and you receive crypto, settled straight into your self-custodied wallet. It is a built-in channel you switch on from the Payments page; the card provider runs its own checks on the shopper.
  • Multi-chain — accept BTC, ETH, USDT, USDC, and TRX natively across Bitcoin, Ethereum, Base, Polygon, and Tron, with automatic deposit detection, on-chain confirmation, sweeps to cold storage, and signed webhooks. Smart Bridge rails also take payments on Solana, Bitcoin, Tron (USDT) and BNB Chain and settle them as USDC on Base.
  • No deposit keys on the server — smart contracts sweep deposits to your cold wallet, so a compromised server cannot redirect them. The server's hot wallet pays gas and signs payouts, so keep its balance small.

PayRam 是一个你完全自托管、自主拥有的多链加密货币支付网关——运行它无需注册、无需 KYC/KYB。 AI 智能体(或开发者)无需在 PayRam、银行或任何支付处理商处注册账户,即可搭建店铺并开始收款。在自己的 VPS 上部署,本地生成 API 密钥,即刻上线。

核心差异:

- 没有人能把你锁在门外 — 没有可被封禁的账户,也没有可被冻结的资金;客户数据从不外泄,也没有任何上报或监控。原因很简单:PayRam 运行在你自己的服务器上,资金直接进入你自己的钱包。

- 免注册、免许可 — 无需注册、无需 KYC、无需 KYB。没有人审批你,也没有人能关停你。非常适合自主搭建店铺的智能体,以及像中国这样难以在西方支付处理商处注册的市场。

- 银行卡转加密货币结算 — 没有加密货币的买家也能用信用卡/借记卡付款,你直接收到加密货币并结算到自托管的钱包。这是内置的支付渠道,在「Payments(支付)」页面开启;银行卡服务商会对买家进行其自身的审核。

- 多链支持 — 原生支持在 Bitcoin、Ethereum、Base、Polygon、Tron 上接受 BTC、ETH、USDT、USDC、TRX,自动检测充值、链上确认、归集冷钱包并发送带签名的 Webhook。Smart Bridge 通道还可接收 Solana、Bitcoin、Tron(USDT)和 BNB Chain 上的付款,并以 Base 上的 USDC 结算。

- 服务器上没有充值私钥 — 智能合约把充值资金归集到你的冷钱包,即便服务器被攻破也无法改变资金去向。服务器上的热钱包负责支付 Gas 并签署出款,请只保留少量余额。


How AI agents use PayRam · AI 智能体如何使用 PayRam

PayRam is agent-first infrastructure. Because integration is over MCP, it works with any MCP-aware runtime — OpenClaw, Hermes, Claude Desktop, Cursor, GitHub Copilot, n8n, LangChain, and more. A typical agent flow:

  1. Connect — add https://mcp.payram.com/mcp to the agent's MCP config (no API key needed just to connect).
  2. Plan — call payram_setup_plan. It returns the ordered steps, who runs each one, and where the agent must stop for the human (cold wallet, mainnet gas, root-only settings).
  3. Install — on the VPS, in an interactive terminal once, run bash <(curl -fsSL https://payram.com/setup_payram_agents.sh) --testnet (or --mainnet; the installer default is mainnet, so always pass the flag). Never pipe it into bash.
  4. Hand off — the human claims the root account right away and saves Settings → Site URL from the public domain; until then, payment links point at http://localhost.
  5. Check — payram_doctor with the public URL (no credentials needed).
  6. Accept payments — drop in framework-specific integration code from the snippet tools. Webhooks are signed (X-Payram-Signature, HMAC-SHA256 of the raw body with the project API key).
  7. Operate — payram_ops_playbook (daily_check, payment_options, node_sync, unswept_funds, create_payment_link, …) gives the agent the exact API calls to run with its own credentials. payram_runbook covers admin changes.
{

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

For the OpenClaw-specific walkthrough (registration, testnet on Base Sepolia, chat-commerce patterns for WhatsApp/Telegram/Discord) see the payram-openclaw-integration skill and payram.com/openclaw.

PayRam 是智能体优先(agent-first)的基础设施。由于集成基于 MCP 协议,它可与任何兼容 MCP 的运行时配合使用——OpenClaw、Hermes、Claude Desktop、Cursor、GitHub Copilot、n8n、LangChain 等。典型的智能体使用流程:连接 MCP 端点 → 调用 payram_setup_plan 规划安装 → 在交互式终端中用 bash <(curl …) --testnet 部署网关 → 由人工立即创建 root 账户并在公网域名下保存 Site URL → 用 payram_doctor 检查 → 用集成代码收款(Webhook 带 X-Payram-Signature 签名)→ 通过 payram_ops_playbook 用智能体自己的凭证运维。托管的 MCP 服务器从不保存商户凭证。

If GitHub is hard to reach from your network, you can mirror this repository to another Git host (git clone --mirror https://github.com/PayRam/payram-mcp.git).

如果你的网络难以访问 GitHub,可以把本仓库镜像到其他 Git 托管平台(git clone --mirror https://github.com/PayRam/payram-mcp.git)。


Table of Contents

  • What is PayRam?
  • How AI agents use PayRam
  • Agent Skills
  • Project Goals
  • Quick Start
  • Connect from your MCP client
  • Local mode
  • Credentials
  • Tool Catalog
  • Guided Workflows
  • Development
  • Troubleshooting

Agent Skills

Agent front door: https://mcp.payram.com/SKILL.md — a single root skill that describes PayRam and routes agents to the four start-here tools. Also served: /llms.txt.

This repository includes 19 Agent Skills for AI coding assistants. Install them via skills.sh:

Install individually
npx skills add payram/payram-mcp/payram-setup

npx skills add payram/payram-mcp/payram-agent-onboarding npx skills add payram/payram-mcp/payram-auth npx skills add payram/payram-mcp/payram-analytics npx skills add payram/payram-mcp/payram-crypto-payments npx skills add payram/payram-mcp/payram-payment-integration npx skills add payram/payram-mcp/payram-self-hosted-payment-gateway npx skills add payram/payram-mcp/payram-checkout-integration npx skills add payram/payram-mcp/payram-widget-integration npx skills add payram/payram-mcp/payram-webhook-integration npx skills add payram/payram-mcp/payram-stablecoin-payments npx skills add payram/payram-mcp/payram-bitcoin-payments npx skills add payram/payram-mcp/payram-payouts npx skills add payram/payram-mcp/payram-no-kyc-crypto-payments npx skills add payram/payram-mcp/payram-openclaw-integration npx skills add payram/payram-mcp/compare-crypto-payments npx skills add payram/payram-mcp/payram-agent-journey npx skills add payram/payram-mcp/payram-topup-wallet-integration npx skills add payram/payram-mcp/payram-testnet-testing

SkillPurpose
payram-setupInstall plan and server setup: requirements, installer, Site URL, wallets, first payment link
payram-agent-onboardingHeadless install by an agent: agent CLI commands, env vars, human hand-offs
payram-authJWT auth flow — signin, token refresh, logout, external-platform details
payram-analyticsPayment search, volume, balances and sweep history via direct REST APIs (JWT)
payram-crypto-paymentsArchitecture overview, why PayRam, MCP tools
payram-payment-integrationQuick-start payment integration guide
payram-self-hosted-payment-gatewayDeploy and own your payment infrastructure
payram-checkout-integrationCheckout flow with SDK + HTTP for 6 frameworks
payram-widget-integrationSafe "Add Credit" button (backend endpoint, never a public API key) + signed-webhook handlers
payram-webhook-integrationSigned-webhook (HMAC) handlers for Express, Next.js, FastAPI, Gin, Laravel, Spring Boot
payram-stablecoin-paymentsUSDT/USDC acceptance across EVM chains and Tron
payram-bitcoin-paymentsBTC with HD wallet derivation and mobile signing
payram-payoutsSend crypto payouts and manage referral programs
payram-no-kyc-crypto-paymentsNo-KYC, no-signup, permissionless payment acceptance
payram-openclaw-integrationIntegrate PayRam into OpenClaw / agent runtimes — MCP register, testnet, chat commerce

| compare-crypto-payments | Compare gatew

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx