Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

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

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

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "payram": {
      "type": "remote",
      "url": "https://mcp.payram.com/mcp",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "payram": {
      "type": "http",
      "url": "https://mcp.payram.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=payram&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnBheXJhbS5jb20vbWNwIn0%3D"
}

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

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

extensions:
  "payram":
    enabled: true
    name: "payram"
    type: streamable_http
    uri: "https://mcp.payram.com/mcp"
    timeout: 300

Quality 84 / 100good

protocol100 · weight 25

pass
protocol.modernsupports 2026-07-28 (server/discover)
pass
protocol.statelessanswers without a session
pass
protocol.transportstreamable HTTP
pass
protocol.list_ttltool list is cacheable (ttlMs 300000)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene100 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations44 of 44 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 6,320 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability25 · weight 15

warn
stability.changes67 tool changes in 30 days
fail
stability.rug_pull5 tools kept their name but changed most of their description in 30 days; review before trusting them

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

44 tools, about 6,320 tokens to load them all · tool set fda52b3d09c1 · tools last changed 2026-10-11 · checked 2026-10-20 11:08 UTC

Tool changes

2026-10-11explain_payram_securityadded
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.
2026-10-11onboard_agent_setupchangedtitle, description, annotationsmeaning changed
before
Quick start for an agent installing PayRam on a VPS: returns the default headless plan (testnet, USDC on Base) with exact commands and the human hand-offs. Same as payram_setup_plan with defaults; call that tool to personalise (domain, mainnet, BTC, operator, Shopify/WooCommerce).
after · 27% of words in common
Deprecated: use payram_setup_plan, which does this and lets you personalise it. Returns the default headless plan (testnet, USDC on Base).
2026-10-11test_payram_connectionchangedtitle, description, annotations
before
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. For a full diagnosis use payram_doctor.
after · 74% of words in common
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.
2026-10-11list_payram_docschangeddescription
before
Lists the available Payram doc ids relative to docs/payram-docs-live. Optionally scope by a prefix such as "features".
after · 78% of words in common
Lists the available Payram doc ids. Optionally scope by a prefix such as "features".
2026-10-11generate_mock_webhook_eventchangedoutput schema
2026-10-11generate_webhook_event_routerchangedoutput schema
2026-10-11generate_webhook_handlerchangedoutput schema
2026-10-11get_agent_setup_flowchangeddescription
before
Returns the canonical PayRam headless-agent guide (payram-scripts PAYRAM_HEADLESS_AGENT.md): 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.
after · 94% of words in common
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.
2026-10-11payram_runbookchangeddescription, input schema, output schema
before
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, shopify_connector, woocommerce_plugin, secure_analytics_mcp. Omit task to list them.
after · 85% of words in common
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, shopify_connector, woocommerce_plugin, secure_analytics_mcp, install_failed, custom_port_or_proxy, external_database, forgot_root_password. Omit task to list them.
2026-10-11payram_troubleshootadded
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 stored. Call with nothing to list known problems. For a live check of a running server use payram_doctor.

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 100 / 100

provenance100

liveness99

freshness100

hygiene100

+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-98% +updated-13d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://mcp.payram.com/mcp` streamable-http	none	yes	98%	241 ms	2026-07-28	2026-10-20

Tools (44)

`explain_payment_flow`read-only	Describe how payments move from customer initiation through settlement.
`explain_payram_basics`read-only	Explain Payram's product pillars, architecture, payments, and payouts capabilities.
`explain_payram_concepts`read-only	Glossary-backed explanation of Payram terminology and constraints.
`explain_payram_security`read-only	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`read-only	Detail the referrer/referee lifecycle and required APIs.
`explain_referrals_basics`read-only	Summarize how Payram referral campaigns are configured and managed.
`generate_env_template`read-only	Creates a .env template for configuring a merchant backend to talk to a self-hosted Payram server.
`generate_mock_webhook_event`read-only	Generates a snippet to send mock Payram webhook events to your local endpoint for testing.
`generate_payment_http_snippet`read-only	Generates a raw HTTP sample for creating a Payram payment in the requested language.
`generate_payment_route_snippet`read-only	Generates a ready-to-use backend endpoint (e.g., /api/pay/create) that creates a Payram payment.
`generate_payment_sdk_snippet`read-only	Generates backend code using the official Payram JS/TS SDK to create a payment.
`generate_payment_status_snippet`read-only	Generates backend code to query the status of a Payram payment.
`generate_payout_recipient_flow_snippet`read-only	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`read-only	Generates a backend code snippet for creating a payout using the Payram JS/TS SDK.
`generate_payout_status_snippet`read-only	Generates backend code to query the status of a payout using the Payram SDK.
`generate_referral_route_snippet`read-only	Generates a backend route such as /api/referrals/create for logging referral events.
`generate_referral_sdk_snippet`read-only	Generates a backend route or service snippet to create a referral event using the Payram SDK.
`generate_referral_status_snippet`read-only	Generates code to fetch referral progress, rewards, or status.
`generate_referral_validation_snippet`read-only	Generates a snippet to validate referral IDs, statuses, and eligibility.
`generate_setup_checklist`read-only	Returns a step-by-step checklist of everything a merchant must configure to start using Payram.
`generate_topup_integration_snippet`read-only	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 payment exceptions. Pair with the payram-topup-wallet-integration skill. (New store with no users? Use the checkout/plugin path instead.)
`generate_webhook_event_router`read-only	Generates a backend event router that dispatches Payram webhook events to domain handlers.
`generate_webhook_handler`read-only	Generates backend code to handle Payram webhook HTTP requests.
`get_agent_setup_flow`read-only	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`read-only	Returns the markdown for a Payram doc given its id, e.g. "features/payouts".
`get_payram_links`read-only	Surface official documentation, website, and community links.
`get_referral_dashboard_guide`read-only	Explain how to embed and manage the referral dashboard experience.
`list_payram_docs`read-only	Lists the available Payram doc ids. Optionally scope by a prefix such as "features".
`onboard_agent_setup`read-only	Deprecated: use payram_setup_plan, which does this and lets you personalise it. Returns the default headless plan (testnet, USDC on Base).
`payram_doctor`read-only	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 first failing stage. Run this first when anything PayRam-related fails.
`payram_ops_playbook`read-only	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. Start with "connect". Tasks: connect, health, version_check, workers, restart_worker, node_sync, site_url, payment_options, unswept_funds, payments_today, payment_lookup, stuck_payment, create_payment_link, payouts, webhooks, logs, daily_check. Omit task to list them.
`payram_runbook`read-only	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, shopify_connector, woocommerce_plugin, secure_analytics_mcp, install_failed, custom_port_or_proxy, external_database, forgot_root_password. Omit task to list them.
`payram_setup_plan`read-only	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), exact commands, what success looks like, and hard stops that need the human (cold wallet, mainnet spend, root-only settings). Ask the user first whether you can run commands on their server (access "ssh") or only chat with them (access "human_runs_commands": they run each command and paste the output back). Pass stage to resume mid-way; payram_doctor tells you the stage of a running server.
`payram_troubleshoot`read-only	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 stored. Call with nothing to list known problems. For a live check of a running server use payram_doctor.
`prepare_payram_test`read-only	Confirm hosting, credentials, and environment variables before generating demo apps.
`scaffold_payram_app`read-only	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`read-only	Returns an Express router that posts to Payram's /api/v1/payment endpoint.
`snippet_fastapi_payment_route`read-only	Returns a FastAPI handler that calls Payram's create-payment HTTP API.
`snippet_go_payment_handler`read-only	Returns a Gin handler that proxies /api/pay/create to Payram's create-payment API.
`snippet_laravel_payment_route`read-only	Returns a Laravel controller that posts to Payram's /api/v1/payment endpoint.
`snippet_nextjs_payment_route`read-only	Returns a Next.js App Router API route that calls Payram's create-payment HTTP API.
`snippet_spring_payment_controller`read-only	Returns a Spring Boot controller that calls Payram's /api/v1/payment endpoint.
`suggest_file_structure`read-only	Suggests a recommended backend folder/file structure for integrating Payram.
`test_payram_connection`read-only	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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "com.payram/mcp",
  "icons": [
    {
      "src": "https://mcp.payram.com/favicon.png",
      "mimeType": "image/png"
    }
  ],
  "title": "PayRam",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.payram.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.2.0",
  "repository": {
    "url": "https://github.com/PayRam/payram-mcp",
    "source": "github"
  },
  "websiteUrl": "https://mcp.payram.com",
  "description": "Install, configure, operate and integrate self-hosted PayRam crypto payment gateways."
}