PayRam

Connect it to your AI

Claude Code

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

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://mcp.payram.com/mcp

Cursor, VS Code and other apps (mcp.json)

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

Tools it offers

44 tools, as the server itself reported during our check on Oct 31, 2026.

• payram_setup_planStart 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 → st
• payram_doctorRead-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
• payram_troubleshootSomething 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 u
• payram_runbookStep-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, smar
• payram_ops_playbookExact, 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 / pro
• 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 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
• 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 payou
• 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.
• 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 invo
• explain_payram_basicsExplain Payram's product pillars, architecture, payments, and payouts capabilities.
• explain_payram_securityAnswer "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_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".

Questions