プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

PayRam

作者:PayRamバージョン 1.2.0i★ –iクラウドで動く
レジストリ名com.payram/mcp

インストール

概要

作者による説明(英語の原文)

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: クラウドで動く
  • トランスポート: 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月9日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン payram.com で確認済みです(レジストリがドメインの所有を確認しています)

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • ✓ 合格

    エンドポイントが応答する

    421ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✕ 不合格

    ツールの説明に隠れた指示がない

    1件のツールの説明に、AIへの指示のように見える文章が含まれています。インストールする前に、下の内容を読んでください

暗号資産・ブロックチェーンのほかのサーバーとの比較i

  • このカテゴリのほかの1622件のうち0%よりスターが多い
  • このカテゴリのほかの1622件のうち59%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1622件のうち41%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

PayRamは安全ですか?

当てはまる基本チェック3項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(1.2.0)がレジストリに届いたのは33 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。

代わりに使えるものは?

同じカテゴリには:onchaincheck, Bvcc Agent Wallet, FinzData Workspace

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

onchaincheck

100+ pay-per-call tools: token risk, wallet sanctions screening, onchain data, web, company, AI

作者:lx1112初期今日更新

クラウドで動く

Bvcc Agent Wallet

Non-custodial BVCC Agent Wallet on-chain for AI agents: balances, transfers, approvals, swaps.

作者:blockventurechaincapital-crypto初期↓ 622/週今日更新

パソコンで動く✓ blockventurechaincapital.com

FinzData Workspace

AI workspace with FinzData built in: stocks, futures, options GEX, macro, crypto data and code runs.

作者:finzdata.com初期今日更新

クラウドで動く✓ finzdata.com

作者の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に聞く