{"name":"com.payram/mcp","slug":"payram-mcp","title":"PayRam","description":"Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.","url":"https://mcp.market/server/payram-mcp","rating":null,"grade":"B","score":84,"certified":false,"status":"active","category":"finance","tags":["finance"],"presence":{"score":44,"stars":158,"forks":7,"downloads_week":null,"last_push_at":"2026-10-11T15:51:38.000Z","license":null},"uptime":{"percent":100,"checks":28,"ok":28,"last_checked_at":"2026-10-24T03:15:16.334Z","last_ok_at":"2026-10-24T03:15:16.334Z","latency_ms":198},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/PayRam/payram-mcp","website":"https://mcp.payram.com","version":"1.2.0","remotes":[{"type":"streamable-http","url":"https://mcp.payram.com/mcp"}],"packages":[],"tools":[{"name":"explain_payment_flow","description":"Describe how payments move from customer initiation through settlement.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"explain_payram_basics","description":"Explain Payram's product pillars, architecture, payments, and payouts capabilities.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"explain_payram_concepts","description":"Glossary-backed explanation of Payram terminology and constraints.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"explain_payram_security","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"explain_referral_flow","description":"Detail the referrer/referee lifecycle and required APIs.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"explain_referrals_basics","description":"Summarize how Payram referral campaigns are configured and managed.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"generate_env_template","description":"Creates a .env template for configuring a merchant backend to talk to a self-hosted Payram server.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_mock_webhook_event","description":"Generates a snippet to send mock Payram webhook events to your local endpoint for testing.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"language":{"type":"string","enum":["curl","python","go","php","java"],"description":"Language/tool for the mock webhook request (curl for command-line testing)"},"status":{"type":"string","enum":["OPEN","CANCELLED","FILLED","PARTIALLY_FILLED","OVER_FILLED","UNDEFINED"],"description":"Payment status to simulate in the mock webhook event"}},"required":["language","status"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_payment_http_snippet","description":"Generates a raw HTTP sample for creating a Payram payment in the requested language.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"language":{"type":"string","enum":["python","go","php","java"],"description":"Programming language for the HTTP payment creation snippet"}},"required":["language"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_payment_route_snippet","description":"Generates a ready-to-use backend endpoint (e.g., /api/pay/create) that creates a Payram payment.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"framework":{"type":"string","enum":["express","nextjs"],"description":"Web framework for the payment route handler (Express.js or Next.js)"}},"required":["framework"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_payment_sdk_snippet","description":"Generates backend code using the official Payram JS/TS SDK to create a payment.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"framework":{"type":"string","enum":["generic-http","express","nextjs"],"description":"Target framework for the SDK payment snippet. generic-http provides a framework-agnostic example."}},"required":["framework"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_payment_status_snippet","description":"Generates backend code to query the status of a Payram payment.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"style":{"type":"string","enum":["sdk","http"],"description":"Style of code snippet: sdk uses the Payram SDK, http uses raw HTTP requests"}},"required":["style"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_payout_recipient_flow_snippet","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_payout_sdk_snippet","description":"Generates a backend code snippet for creating a payout using the Payram JS/TS SDK.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"framework":{"type":"string","enum":["generic-http"],"description":"Target framework for the payout SDK snippet"}},"required":["framework"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_payout_status_snippet","description":"Generates backend code to query the status of a payout using the Payram SDK.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_referral_route_snippet","description":"Generates a backend route such as /api/referrals/create for logging referral events.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"framework":{"type":"string","enum":["express","nextjs"],"description":"Web framework for the referral route handler (Express.js or Next.js)"}},"required":["framework"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_referral_sdk_snippet","description":"Generates a backend route or service snippet to create a referral event using the Payram SDK.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"framework":{"type":"string","enum":["generic-http"],"description":"Target framework for the referral SDK snippet"}},"required":["framework"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_referral_status_snippet","description":"Generates code to fetch referral progress, rewards, or status.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"style":{"type":"string","enum":["sdk","backend-only"],"description":"Style of code snippet: sdk uses the Payram SDK, backend-only shows direct API calls"}},"required":["style"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_referral_validation_snippet","description":"Generates a snippet to validate referral IDs, statuses, and eligibility.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_setup_checklist","description":"Returns a step-by-step checklist of everything a merchant must configure to start using Payram.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_topup_integration_snippet","description":"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.)","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"part":{"default":"all","description":"Which piece to emit: 'schema' (ledger DDL), 'webhook' (cumulative-credit handler), 'settle' (atomic invoice debit), or 'all'.","type":"string","enum":["schema","webhook","settle","all"]},"framework":{"default":"express","description":"Server framework for the webhook handler + settle function.","type":"string","enum":["express","fastapi"]}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_webhook_event_router","description":"Generates a backend event router that dispatches Payram webhook events to domain handlers.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"generate_webhook_handler","description":"Generates backend code to handle Payram webhook HTTP requests.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"framework":{"type":"string","enum":["express","nextjs","fastapi","gin","laravel","spring-boot"],"description":"Web framework for the webhook handler code"}},"required":["framework"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"get_agent_setup_flow","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"get_payram_doc_by_id","description":"Returns the markdown for a Payram doc given its id, e.g. \"features/payouts\".","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"get_payram_links","description":"Surface official documentation, website, and community links.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"get_referral_dashboard_guide","description":"Explain how to embed and manage the referral dashboard experience.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"list_payram_docs","description":"Lists the available Payram doc ids. Optionally scope by a prefix such as \"features\".","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"prefix":{"type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"onboard_agent_setup","description":"Deprecated: use payram_setup_plan, which does this and lets you personalise it. Returns the default headless plan (testnet, USDC on Base).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"payram_doctor","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"baseUrl":{"description":"Public address of the PayRam server, same origin as the dashboard: https://pay.example.com, or just pay.example.com or an IP (https is tried first, then http). No :8080, no path. Required on the hosted MCP.","type":"string"},"apiKey":{"description":"Optional project API key to validate (never creates anything). Passing it puts the key in this conversation; prefer running payram_ops_playbook \"connect\" locally.","type":"string","minLength":1}},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"payram_ops_playbook","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"task":{"description":"Which recipe. Omit to get the index of tasks.","type":"string","enum":["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"]}},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"payram_runbook","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"task":{"description":"Which runbook. Omit to list all.","type":"string","enum":["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"]}},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"payram_setup_plan","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"path":{"default":"agent","description":"agent = headless CLI after a one-time interactive install; human = installer + web dashboard","type":"string","enum":["agent","human"]},"network":{"default":"testnet","description":"testnet = free test coins (recommended first); mainnet = real money","type":"string","enum":["testnet","mainnet"]},"domain":{"description":"Public hostname for the gateway, e.g. pay.example.com. Omit if you only have an IP for now.","type":"string","pattern":"^(?=.{1,253}$)([a-z0-9-]+\\.)+[a-z]{2,}$"},"ssl":{"description":"letsencrypt (needs domain), own_certificate, proxy (Cloudflare/your own reverse proxy terminates TLS), none. Default: letsencrypt with a domain, none without.","type":"string","enum":["letsencrypt","own_certificate","proxy","none"]},"role":{"default":"merchant","description":"merchant: Take payments for your own business (default). operator: Run PayRam as a platform for other merchants and earn a fee on their volume. Must be chosen before the first project; the role locks once role-specific data exists.","type":"string","enum":["merchant","operator"]},"wallet":{"default":"usdc_base","description":"First deposit wallet: usdc_base (smart-contract wallet on Base, needs a little gas), btc (xpub, no gas), or both","type":"string","enum":["usdc_base","btc","both"]},"stage":{"default":"fresh","description":"Where you are now; the plan starts from the next step","type":"string","enum":["fresh","installed","account_created","wallet_ready","payment_link_created"]},"access":{"default":"ssh","description":"ssh = you can run commands on the server yourself. human_runs_commands = you only chat: the human runs each command and pastes the output back. Ask the user which applies before planning.","type":"string","enum":["ssh","human_runs_commands"]},"integration":{"default":"none","description":"What will take payments once the gateway is up","type":"string","enum":["none","website","shopify","woocommerce"]}},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"payram_troubleshoot","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"symptom":{"description":"The problem in plain words, e.g. \"payment link opens localhost\" or \"502 after upgrade\".","type":"string","maxLength":2000},"output":{"description":"Error text or log lines to match. Remove API keys, tokens, passwords and seed phrases first.","type":"string","maxLength":20000},"area":{"description":"Narrow the search to one area.","type":"string","enum":["install","network","ssl","config","payments","deposits","sweeps","webhooks","api","operations","apps"]},"id":{"description":"Show one known problem by its id (from an earlier answer).","type":"string","maxLength":80}},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"prepare_payram_test","description":"Confirm hosting, credentials, and environment variables before generating demo apps.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"scaffold_payram_app","description":"Generates a minimal full-stack app skeleton with Payram payments and payouts routes (and a simple UI) for a chosen language and framework.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"language":{"type":"string","enum":["node","python","php","go","java"],"description":"Programming language for the application (node for JavaScript/TypeScript)"},"framework":{"type":"string","enum":["express","nextjs","fastapi","laravel","gin","spring-boot"],"description":"Web framework to use for scaffolding the application"},"appName":{"description":"Name for the generated application. If not provided, defaults to payram-{framework}-starter","type":"string","minLength":1},"includeWebhooks":{"default":true,"description":"Whether to include webhook handler code in the scaffolded application","type":"boolean"}},"required":["language","framework"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"snippet_express_payment_route","description":"Returns an Express router that posts to Payram's /api/v1/payment endpoint.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"snippet_fastapi_payment_route","description":"Returns a FastAPI handler that calls Payram's create-payment HTTP API.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"snippet_go_payment_handler","description":"Returns a Gin handler that proxies /api/pay/create to Payram's create-payment API.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"snippet_laravel_payment_route","description":"Returns a Laravel controller that posts to Payram's /api/v1/payment endpoint.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"snippet_nextjs_payment_route","description":"Returns a Next.js App Router API route that calls Payram's create-payment HTTP API.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"snippet_spring_payment_controller","description":"Returns a Spring Boot controller that calls Payram's /api/v1/payment endpoint.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"suggest_file_structure","description":"Suggests a recommended backend folder/file structure for integrating Payram.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"test_payram_connection","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"baseUrl":{"description":"PayRam URL, same origin as the dashboard (e.g. https://pay.example.com). Defaults to PAYRAM_BASE_URL in local mode.","type":"string"},"apiKey":{"description":"Optional project API key to validate (nothing is created). Passing it exposes the key in this conversation.","type":"string","minLength":1}},"$schema":"https://json-schema.org/draft/2020-12/schema"}}],"scan":{"score":84,"grade":"B","scanned_at":"2026-10-13T23:19:10.109Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-13T23:19:10.047Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 765ms"]},"poisoning":{"score":15,"max":15,"notes":["44 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 1 write-action tools with no auth"]},"maintenance":{"score":15,"max":15,"notes":["last push 2 days ago"]},"identity":{"score":10,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year","website matches verified namespace"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"}],"inputs":{"probes":[{"url":"https://mcp.payram.com/mcp","reachable":true,"authRequired":false,"latencyMs":765,"serverInfo":{"name":"payram-helper","version":"1.2.0"}}],"packages":[],"repo":{"found":true,"owner":"PayRam","repo":"payram-mcp","archived":false,"pushedAt":"2026-10-11T15:51:38Z","stars":158,"forks":7,"openIssues":4,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/154656081?v=4","ownerCreatedAt":"2023-12-23T05:55:55Z"},"icon":{"url":"https://mcp.payram.com/favicon.png","source":"registry","width":561,"height":561},"presence":{"stars":158,"forks":7,"downloadsWeek":null,"license":null,"lastPushAt":"2026-10-11T15:51:38.000Z","score":44}}}},"grade_history":[],"reviews":[]}