MCP server

PayRam Official

com.payram/mcp

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

payram.com (verified by the MCP Registry)

Status

Working at last check

Tools

44

Token cost

About 6,144 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.payram]
url = "https://mcp.payram.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add payram https://mcp.payram.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"payram","server_url":"https://mcp.payram.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"payram","server_url":"https://mcp.payram.com/mcp"}

Tools

• explain_payment_flow ~65 tokens
  Describe how payments move from customer initiation through settlement.
• explain_payram_basics ~68 tokens
  Explain Payram's product pillars, architecture, payments, and payouts capabilities.
• explain_payram_concepts ~64 tokens
  Glossary-backed explanation of Payram terminology and constraints.
• explain_payram_security ~104 tokens
  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.
• explain_referral_flow ~61 tokens
  Detail the referrer/referee lifecycle and required APIs.
• explain_referrals_basics ~65 tokens
  Summarize how Payram referral campaigns are configured and managed.
• generate_env_template ~81 tokens
  Creates a .env template for configuring a merchant backend to talk to a self-hosted Payram server.
• generate_mock_webhook_event ~187 tokens
  Generates a snippet to send mock Payram webhook events to your local endpoint for testing.
• generate_payment_http_snippet ~126 tokens
  Generates a raw HTTP sample for creating a Payram payment in the requested language.
• generate_payment_route_snippet ~130 tokens
  Generates a ready-to-use backend endpoint (e.g., /api/pay/create) that creates a Payram payment.
• generate_payment_sdk_snippet ~138 tokens
  Generates backend code using the official Payram JS/TS SDK to create a payment.
• generate_payment_status_snippet ~120 tokens
  Generates backend code to query the status of a Payram payment.
• generate_payout_recipient_flow_snippet Moves money · ~122 tokens
  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_payout_sdk_snippet Moves money · ~118 tokens
  Generates a backend code snippet for creating a payout using the Payram JS/TS SDK.
• generate_payout_status_snippet ~77 tokens
  Generates backend code to query the status of a payout using the Payram SDK.
• generate_referral_route_snippet ~128 tokens
  Generates a backend route such as /api/referrals/create for logging referral events.
• generate_referral_sdk_snippet ~122 tokens
  Generates a backend route or service snippet to create a referral event using the Payram SDK.
• generate_referral_status_snippet ~124 tokens
  Generates code to fetch referral progress, rewards, or status.
• generate_referral_validation_snippet ~78 tokens
  Generates a snippet to validate referral IDs, statuses, and eligibility.
• generate_setup_checklist ~81 tokens
  Returns a step-by-step checklist of everything a merchant must configure to start using Payram.
• generate_topup_integration_snippet ~290 tokens
  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 balance states, not p
• generate_webhook_event_router ~81 tokens
  Generates a backend event router that dispatches Payram webhook events to domain handlers.
• generate_webhook_handler ~123 tokens
  Generates backend code to handle Payram webhook HTTP requests.
• get_agent_setup_flow ~117 tokens
  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.
• get_payram_doc_by_id ~82 tokens
  Returns the markdown for a Payram doc given its id, e.g. "features/payouts".
• get_payram_links ~61 tokens
  Surface official documentation, website, and community links.
• get_referral_dashboard_guide ~66 tokens
  Explain how to embed and manage the referral dashboard experience.
• list_payram_docs ~75 tokens
  Lists the available Payram doc ids. Optionally scope by a prefix such as "features".
• onboard_agent_setup ~92 tokens
  Deprecated: use payram_setup_plan, which does this and lets you personalise it. Returns the default headless plan (testnet, USDC on Base).
• payram_doctor ~284 tokens
  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 exact fixes for the
• payram_ops_playbook ~300 tokens
  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, and what not to do. St
• payram_runbook ~299 tokens
  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, reset_test_install, s
• payram_setup_plan ~803 tokens
  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 vs human/dashboard),
• payram_troubleshoot ~332 tokens
  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; what you paste is not
• prepare_payram_test ~68 tokens
  Confirm hosting, credentials, and environment variables before generating demo apps.
• scaffold_payram_app ~278 tokens
  Generates a minimal full-stack app skeleton with Payram payments and payouts routes (and a simple UI) for a chosen language and framework.
• snippet_express_payment_route ~76 tokens
  Returns an Express router that posts to Payram's /api/v1/payment endpoint.
• snippet_fastapi_payment_route ~75 tokens
  Returns a FastAPI handler that calls Payram's create-payment HTTP API.
• snippet_go_payment_handler ~78 tokens
  Returns a Gin handler that proxies /api/pay/create to Payram's create-payment API.
• snippet_laravel_payment_route ~77 tokens
  Returns a Laravel controller that posts to Payram's /api/v1/payment endpoint.
• snippet_nextjs_payment_route ~79 tokens
  Returns a Next.js App Router API route that calls Payram's create-payment HTTP API.
• snippet_spring_payment_controller ~79 tokens
  Returns a Spring Boot controller that calls Payram's /api/v1/payment endpoint.
• suggest_file_structure ~75 tokens
  Suggests a recommended backend folder/file structure for integrating Payram.
• test_payram_connection ~195 tokens
  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.

Browse

• Payments
• Crypto and blockchains

Related MCP servers

• AgentWorld — Live AI Agent Economy
  Live AI agent economy on Base L2: agents, credit files, games, jobs, crypto news, x402 USDC tools.
• Bureau (about)
  About Bureau, the self-hosted office for AI agents: overview, FAQ search, roadmap, install.
• Arrowmem
  Free Ollama hardening checker, plus tools for privacy architecture and the Data Dignity Standard.
• Sato Hub: Build Onchain & Crypto Agents
  Build any crypto agent: stack picks, x402 and ERC-8004 lookups, wallet-key checks, unsigned swaps.
• Dropyour
  Publish micro-apps from your AI with no account; operate them as real apps. Data stored in the EU.
• Last Price
  Compute and verify prices from an agent, metered per call. Works keyless on a demo tenant.
• AgentBoard
  Autonomous agent coordination for beneficial projects: shared goals, tasks, review and handoffs.
• Factline
  EU company dossiers, sanctions and PEP checks, x402 pay guard; Dutch homes and cars.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.payram/mcp.svg)](https://aptlynx.net/servers/com.payram/mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents