PayRam Helper MCP Server

PayRam Helper MCP Server: помогает интегрировать и проверять self-hosted PayRam

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Проверять соединение с развёрнутым PayRam
  • Диагностировать конфигурацию через payram_doctor
  • Генерировать код обработки платежей и выплат для разных фреймворков
  • Создавать обработчики вебхуков и тестовые события
  • Оценивать проект перед интеграцией PayRam

Какие данные видит

Ассистент работает с локальным развёртыванием PayRam разработчика и не получает доступ к сторонним данным.

Нужен ли аккаунт

Не нужен: сервер работает без входа

MCP-сервер для разработчиков, которые подключают платёжный шлюз PayRam к своему приложению. Ассистент проверяет соединение с развёрнутым PayRam, диагностирует конфигурацию и генерирует готовые фрагменты кода для приёма платежей, выплат, рефералов и вебхуков на разных стеках — Next.js, Express, FastAPI, Laravel, Go, Spring.

Как подключить

Как подключить PayRam Helper MCP Server к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://mcp.payram.com/

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить PayRam Helper MCP Server к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://mcp.payram.com/

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить PayRam Helper MCP Server к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://mcp.payram.com/

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (52)

Технические названия из tools/list. Нужны только разработчикам.

test_payram_connectionChecks the /api/v1/payment endpoint on a Payram server using baseUrl and apiKey. If they are not provided, returns a .env template you can add to your workspace.
payram_doctorStaged, read-only health diagnosis: server reachability -> merchant API key -> admin JWT -> payment readiness (wallets + listener workers). Returns ranked likely causes with exact fix commands for the first failing stage. Run this FIRST when anything PayRam-related fails.
generate_payment_sdk_snippetGenerates backend code using the official Payram JS/TS SDK to create a payment.
generate_payment_http_snippetGenerates a raw HTTP sample for creating a Payram payment in the requested language.
generate_payment_status_snippetGenerates backend code to query the status of a Payram payment.
generate_payment_route_snippetGenerates a ready-to-use backend endpoint (e.g., /api/pay/create) that creates a Payram payment.
snippet_nextjs_payment_routeReturns a Next.js App Router API route that calls Payram's create-payment HTTP API.
snippet_express_payment_routeReturns an Express router that posts to Payram's /api/v1/payment endpoint.
snippet_fastapi_payment_routeReturns a FastAPI handler that calls Payram's create-payment HTTP API.
snippet_laravel_payment_routeReturns a Laravel controller that posts to Payram's /api/v1/payment endpoint.
snippet_go_payment_handlerReturns a Gin handler that proxies /api/pay/create to Payram's create-payment API.
snippet_spring_payment_controllerReturns a Spring Boot controller that calls Payram's /api/v1/payment endpoint.
generate_payout_sdk_snippetGenerates a backend code snippet for creating a payout using the Payram JS/TS SDK.
generate_payout_status_snippetGenerates backend code to query the status of a payout using the Payram SDK.
generate_payout_recipient_flow_snippetGenerates 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_snippetGenerates a backend route or service snippet to create a referral event using the Payram SDK.
generate_referral_validation_snippetGenerates a snippet to validate referral IDs, statuses, and eligibility.
generate_referral_status_snippetGenerates code to fetch referral progress, rewards, or status.
generate_referral_route_snippetGenerates a backend route such as /api/referrals/create for logging referral events.
generate_webhook_handlerGenerates backend code to handle Payram webhook HTTP requests.
generate_webhook_event_routerGenerates a backend event router that dispatches Payram webhook events to domain handlers.
generate_mock_webhook_eventGenerates a snippet to send mock Payram webhook events to your local endpoint for testing.
assess_payram_projectInspects dependency files, frameworks, and .env status to suggest the next integration actions.
generate_topup_integration_snippetFor 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 balance states, not payment exceptions. Pair with the payram-topup-wallet-integration skill. (New store with no users? Use the checkout/plugin path instead.)
explain_payram_basicsExplain Payram's product pillars, architecture, payments, and payouts capabilities.
get_payram_linksSurface official documentation, website, and community links.
explain_payment_flowDescribe how payments move from customer initiation through settlement.
explain_payram_conceptsGlossary-backed explanation of Payram terminology and constraints.
explain_referrals_basicsSummarize how Payram referral campaigns are configured and managed.
explain_referral_flowDetail the referrer/referee lifecycle and required APIs.
get_referral_dashboard_guideExplain how to embed and manage the referral dashboard experience.
prepare_payram_testConfirm hosting, credentials, and environment variables before generating demo apps.
get_payram_doc_by_idReturns the markdown for a Payram doc given its id, e.g. "features/payouts".
list_payram_docsLists the available Payram doc ids relative to docs/payram-docs-live. Optionally scope by a prefix such as "features".
generate_env_templateCreates a .env template for configuring a merchant backend to talk to a self-hosted Payram server.
generate_setup_checklistReturns a step-by-step checklist of everything a merchant must configure to start using Payram.
suggest_file_structureSuggests a recommended backend folder/file structure for integrating Payram.
get_agent_setup_flowReturns the step-by-step setup flow for deploying PayRam as an agent. Covers install, wallet creation, faucet funding, contract deployment, and first payment. Includes chain recommendations (ETH Sepolia for testnet, Base for mainnet), faucet URLs, card-to-crypto prerequisites, and status/recovery commands for interrupted sessions.
onboard_agent_setupReturns the complete autonomous agent setup guide for deploying Payram without any web UI or human interaction.
scaffold_payram_appGenerates a minimal full-stack app skeleton with Payram payments and payouts routes (and a simple UI) for a chosen language and framework.
list_platformsLists all external platforms (projects) for the authenticated user. Use this to discover your platform ID, which other tools auto-resolve if omitted.
get_payment_summaryReturns payment counts: total, open, closed, and cancelled. Useful for a quick overview of payment activity.
lookup_paymentLook up payments by transaction hash, email, reference ID, customer ID, or invoice ID. Returns up to 5 matching payments with full details.
search_paymentsSearch and filter payments with full control over status, network, currency, dates, webhook status, and pagination. Returns a paginated list of matching payments.
get_unswept_balancesReturns unswept (unsettled) balances across all wallets, broken down by blockchain and currency. Shows sweep readiness per entry (sweep, sweep_in_progress, sweep_not_allowed, no_balance) AND why stuck funds are stuck: lastSweepError (e.g. HOT_WALLET_LOW_GAS with the hot-wallet address to fund), pending SCW deployment, or missing cold wallet. Use this to answer "where is my money / why has it not swept".
get_daily_volumeReturns the total payment volume for a given date, with breakdowns by network and currency. Only counts FILLED (completed) payments. Defaults to today if no date is specified.
list_currenciesLists every blockchain currency PayRam supports on this node (chain code, network, currency code). Public endpoint — works with only PAYRAM_BASE_URL set, no API key or JWT required. Use this to discover valid blockchainCode/currencyCode values before creating payments or payouts.
list_recipientsLists saved withdrawal recipients (payout beneficiaries). Use this to find a recipient ID for the 3-step payout flow, or to check whether a beneficiary is already OTP-verified (status "active") before creating a payout.
create_payment_linkCreates a PayRam checkout (payment) link and returns the hosted URL plus a reference_id. Authenticates with the Merchant API-Key (set PAYRAM_API_KEY). This WRITES — it creates a real payment request. The customer chooses the chain/currency on the hosted checkout. Poll status later with lookup_payment (or GET /api/v1/payment/reference/{reference_id}).
check_node_syncPer-chain node health verdict: healthy / lagging / unreachable / listener-down. Computes how old each RPC node’s last block is — any non-BTC chain older than 10 minutes (BTC: 90 minutes, since BTC blocks every ~10m) is flagged as lagging or not syncing. Also checks the chain’s listener worker. When something is wrong it names the exact remediation (usually restart_payram_worker). Read-only — run this first; restart second; re-run this ~60s after a restart to confirm recovery.
restart_payram_workerREMEDIATION ACTION (write): restarts a blockchain listener worker via supervisor — the minimal fix when check_node_sync reports a chain as lagging or listener-down. Workflow: run check_node_sync first → restart the named worker → wait ~60s → run check_node_sync again to confirm recovery. A restart does NOT fix an unreachable RPC (fix the RPC config in the dashboard instead). Requires admin JWT with write_system_settings.
check_payment_readinessDiagnoses what is NOT yet set up to accept payments, per blockchain: missing deposit wallet, chain/currency not enabled for the project, or a stopped listener worker. Read-only — reports gaps and points to the CLI for wallet setup; it does not create wallets itself.