프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 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의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 클라우드에서 실행
  • 전송 방식: 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

메뉴 이름은 요금제나 시기에 따라 조금 다를 수 있어요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. 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에서 이 저장소를 읽어 오지 않았어요

  • ✓ 통과

    엔드포인트 응답

    421ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✕ 실패

    도구 설명에 숨겨진 지시 없음

    도구 설명 1개에 AI에게 지시하는 것처럼 보이는 글이 있어요. 설치하기 전에 아래 내용을 읽어 보세요

암호화폐 및 블록체인 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 1634개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 1634개 중 58%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 1634개 중 43%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

PayRam, 안전한가요?

해당하는 기본 점검 3개 중 2개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.2.0)은 34일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되기 때문에, 원격 MCP 서버를 지원하는 앱(예: 개발자 모드의 ChatGPT)에서도 쓸 수 있어요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Souvenir, XRPLME Country Intelligence, Crypto News Sentiment (x402)

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Souvenir

Souvenir coins and prize rounds on Solana: search coins, read pots, rounds and draw proofs.

제작자: souvenir.finance초기오늘 업데이트

클라우드에서 실행✓ souvenir.finance

XRPLME Country Intelligence

Source-backed country policy data for AI agents. Pay per call in XRP or USDC (Solana, Base).

제작자: DaimyoVegan초기오늘 업데이트

클라우드에서 실행

Crypto News Sentiment (x402)

Crypto news sentiment for 24 coins: label, score and headlines behind it, paid per call via x402

제작자: whatevercat-creator아주 새로움↓ 61/주오늘 업데이트

내 컴퓨터에서 실행

제작자의 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에게 묻기