Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Recently observed → Live
Live → Recently observed
Added "explain_payram_security" (43 tools before, 44 now)
Is PayRam safe? Security and trust — 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.
Added "explain_payram_security" and "payram_troubleshoot"; changed the definition of "generate_mock_webhook_event", "generate_webhook_event_router", "generate_webhook_handler" and 7 more (42 tools before, 44 now)
⟨31 unchanged words⟩ ,"python","go","php","java","bash"],"type":"string"}},"required": ⟨19 unchanged words⟩
⟨31 unchanged words⟩ ,"python","go","php","java","bash"],"type":"string"}},"required": ⟨19 unchanged words⟩
Added "payram_troubleshoot"; changed the definition of "generate_mock_webhook_event", "generate_webhook_event_router", "generate_webhook_handler" and 7 more (42 tools before, 43 now)
⟨31 unchanged words⟩ ,"python","go","php","java","bash"],"type":"string"}},"required": ⟨19 unchanged words⟩
⟨31 unchanged words⟩ ,"python","go","php","java","bash"],"type":"string"}},"required": ⟨19 unchanged words⟩
Recently observed → Live
Live → Recently observed
Added "payram_ops_playbook", "payram_runbook" and "payram_setup_plan"; removed "assess_payram_project", "check_node_sync", "check_payment_readiness" and 10 more; changed the definition of "explain_payment_flow", "explain_payram_basics", "explain_payram_concepts" and 36 more (52 tools before, 42 now)
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
Recently observed → Live
Added "payram_ops_playbook", "payram_runbook" and "payram_setup_plan"; removed "assess_payram_project", "check_node_sync", "check_payment_readiness" and 10 more; changed the definition of "explain_payment_flow", "explain_payram_basics", "explain_payram_concepts" and 36 more (52 tools before, 42 now)
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
Live → Recently observed
Recently observed → Live
Live → Recently observed
Recently observed → Live
Live → Recently observed
Certificate recorded, valid to 2026-11-20
Authorization not required
Recently observed → Live
Live → Recently observed
Certificate recorded, valid to 2026-11-20
Authorization not required
Certificate recorded, valid to 2026-11-20
Authorization not required
First tool surface recorded: 52 tools (server version 1.1.0)
First tool surface recorded: 52 tools (server version 1.1.0)
Showing the latest 25 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
⟨31 unchanged words⟩ ,"python","go","php","java","bash"],"type":"string"}},"required": ⟨19 unchanged words⟩
Returns the canonical PayRam headless-agent guide(payram-scripts PAYRAM_HEADLESS_AGENT.md): agent CLI commands, env vars, merchant ⟨19 unchanged words⟩
Lists the available Payram docids relative to docs/payram-docs-live.ids. Optionally scope by a prefix such as "features".
Onboard: install PayRam as an agent (deprecated)QuickDeprecated:startuseforpayram_setup_plan,anwhichagentdoesinstallingthisPayRamandonletsayouVPS:personalisereturnsit. 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).
⟨8 unchanged words⟩ title":"Onboard: install PayRam as an agent (deprecated)"}
⟨33 unchanged words⟩ string"},"baseUrl":{"description":"PublicURLaddress of the PayRam server, same origin as the dashboard(e.g.: https://pay.example.com, or just pay.example.com or an IP (https is tried first, then http). No :8080.8080, no path. Required on the hosted MCP.","type": ⟨3 unchanged words⟩
⟨92 unchanged words⟩ :"object"},"type":"array"},"nextCall":{"anyOf":[{"additionalProperties":false,"properties":{"arguments":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":"object"},"tool":{"type":"string"}},"required":["tool","arguments"],"type":"object"},{"type":"null"}],"description":"The single most useful tool call to make next"},"nextSteps":{"items":{"type":"string"},"type":"array"},"setupStage":{"anyOf":[{"const":"installed","type":"string"},{"type":"null"}],"description":"Pass as payram_setup_plan stage once the server answers PayRam health; null when not reachable"},"version":{"type":["string","null" ⟨12 unchanged words⟩ ","findings","warnings","likelyCauses","nextSteps","setupStage","nextCall"],"type":"object"}
⟨28 unchanged words⟩ operator_setup, rotate_api_key, reset_test_install, shopify_connector, woocommerce_plugin,secure_analytics_mcp.secure_analytics_mcp, install_failed, custom_port_or_proxy, external_database, forgot_root_password. Omit task to list them.
⟨26 unchanged words⟩ ,"reset_test_install","shopify_connector","woocommerce_plugin","secure_analytics_mcp","install_failed","custom_port_or_proxy","external_database","forgot_root_password"],"type":"string"}},"type":"object"}
⟨24 unchanged words⟩ ,"who":{"enum":["agent_shell","agent_http","human","human_dashboard"],"type":"string"} ⟨22 unchanged words⟩ ","reset_test_install","shopify_connector","woocommerce_plugin","secure_analytics_mcp","install_failed","custom_port_or_proxy","external_database","forgot_root_password"],"type":"string"},"title": ⟨48 unchanged words⟩
⟨66 unchanged words⟩ 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 resumemid-way.mid-way; payram_doctor tells you the stage of a running server.
{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"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.","enum":["ssh","human_runs_commands"],"type":"string"},"domain":{"description":"Public hostname for the ⟨220 unchanged words⟩
⟨42 unchanged words⟩ :{"enum":["agent_shell","agent_http","human_shell","human","human_dashboard"],"type":"string"} ⟨15 unchanged words⟩ ","type":"string"},"id":{"type":"string"},"ifItFails":{"description":"What to do when the step does not give the expected result","type":"string"},"notes":{"items ⟨44 unchanged words⟩
Test PayRam connectivity (deprecated)Deprecated: use payram_doctor, which does this and more. Read-only check that a PayRam server is reachable ⟨9 unchanged words⟩ that the key is accepted. Never creates payments.For a full diagnosis use payram_doctor.
⟨6 unchanged words⟩ "readOnlyHint":true,"title":"Test PayRam connectivity (deprecated)"}
Is PayRam safe? Security and trust — 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.
Troubleshoot a PayRam problem — 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.
⟨31 unchanged words⟩ ,"python","go","php","java","bash"],"type":"string"}},"required": ⟨19 unchanged words⟩
Returns the canonical PayRam headless-agent guide(payram-scripts PAYRAM_HEADLESS_AGENT.md): agent CLI commands, env vars, merchant ⟨19 unchanged words⟩
Lists the available Payram docids relative to docs/payram-docs-live.ids. Optionally scope by a prefix such as "features".
Onboard: install PayRam as an agent (deprecated)QuickDeprecated:startuseforpayram_setup_plan,anwhichagentdoesinstallingthisPayRamandonletsayouVPS:personalisereturnsit. 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).
⟨8 unchanged words⟩ title":"Onboard: install PayRam as an agent (deprecated)"}
⟨33 unchanged words⟩ string"},"baseUrl":{"description":"PublicURLaddress of the PayRam server, same origin as the dashboard(e.g.: https://pay.example.com, or just pay.example.com or an IP (https is tried first, then http). No :8080.8080, no path. Required on the hosted MCP.","type": ⟨3 unchanged words⟩
⟨92 unchanged words⟩ :"object"},"type":"array"},"nextCall":{"anyOf":[{"additionalProperties":false,"properties":{"arguments":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":"object"},"tool":{"type":"string"}},"required":["tool","arguments"],"type":"object"},{"type":"null"}],"description":"The single most useful tool call to make next"},"nextSteps":{"items":{"type":"string"},"type":"array"},"setupStage":{"anyOf":[{"const":"installed","type":"string"},{"type":"null"}],"description":"Pass as payram_setup_plan stage once the server answers PayRam health; null when not reachable"},"version":{"type":["string","null" ⟨12 unchanged words⟩ ","findings","warnings","likelyCauses","nextSteps","setupStage","nextCall"],"type":"object"}
⟨28 unchanged words⟩ operator_setup, rotate_api_key, reset_test_install, shopify_connector, woocommerce_plugin,secure_analytics_mcp.secure_analytics_mcp, install_failed, custom_port_or_proxy, external_database, forgot_root_password. Omit task to list them.
⟨26 unchanged words⟩ ,"reset_test_install","shopify_connector","woocommerce_plugin","secure_analytics_mcp","install_failed","custom_port_or_proxy","external_database","forgot_root_password"],"type":"string"}},"type":"object"}
⟨24 unchanged words⟩ ,"who":{"enum":["agent_shell","agent_http","human","human_dashboard"],"type":"string"} ⟨22 unchanged words⟩ ","reset_test_install","shopify_connector","woocommerce_plugin","secure_analytics_mcp","install_failed","custom_port_or_proxy","external_database","forgot_root_password"],"type":"string"},"title": ⟨48 unchanged words⟩
⟨66 unchanged words⟩ 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 resumemid-way.mid-way; payram_doctor tells you the stage of a running server.
{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"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.","enum":["ssh","human_runs_commands"],"type":"string"},"domain":{"description":"Public hostname for the ⟨220 unchanged words⟩
⟨42 unchanged words⟩ :{"enum":["agent_shell","agent_http","human_shell","human","human_dashboard"],"type":"string"} ⟨15 unchanged words⟩ ","type":"string"},"id":{"type":"string"},"ifItFails":{"description":"What to do when the step does not give the expected result","type":"string"},"notes":{"items ⟨44 unchanged words⟩
Test PayRam connectivity (deprecated)Deprecated: use payram_doctor, which does this and more. Read-only check that a PayRam server is reachable ⟨9 unchanged words⟩ that the key is accepted. Never creates payments.For a full diagnosis use payram_doctor.
⟨6 unchanged words⟩ "readOnlyHint":true,"title":"Test PayRam connectivity (deprecated)"}
Troubleshoot a PayRam problem — 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.
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payment Flow Guide"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payram Basics Overview"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Core Payram Concepts"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Referral Flow Guide"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Referral Basics Overview"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨51 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram .env Template"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"language" ⟨44 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate mock Payram webhook event"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"language" ⟨20 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate HTTP payment snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨20 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨23 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate SDK payment snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"style" ⟨24 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payment status snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨39 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate 3-step recipient payout flow snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨16 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨39 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payout SDK snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨39 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payout status SDK snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨20 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨16 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral SDK snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"style" ⟨24 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral status snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral validation snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨44 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram Setup Checklist"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨46 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"notes" ⟨14 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate top-up wallet integration"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram webhook event router"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨21 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram webhook HTTP handler"}GetAgenttheSetupheadlessFlowagent guide (full reference)
Returns thestep-by-step setup flowcanonicalforPayRamdeployingheadless-agentPayRamguideas(payram-scriptsanPAYRAM_HEADLESS_AGENT.md):agent.agentCoversCLIinstallcommands,walletenvcreationvars,faucetmerchantfunding,vscontractoperatordeploymentmode,andwalletfirstflows,payment.addingIncludeschains,chaintroubleshooting.recommendationsLong (ETH Sepolia for testnet, Base for~11kmainnettokens), faucet URLs, card-to-crypto.prerequisites,Forandastatus/recoveryshortcommandspersonalisedforplaninterruptedusesessions.payram_setup_plan.
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨13 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Get the headless agent guide (full reference)"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{"id":{"minLength": ⟨7 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"id" ⟨19 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Get Payram Doc By ID"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payram Important Links"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Referral Dashboard Guide"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{"prefix":{"type": ⟨3 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"count" ⟨16 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"List Payram Docs"}GetOnboard:PayraminstallAgentPayRamOnboardingasGuidean agent
ReturnsQuickthestartcompleteforautonomousan agentsetupinstallingguidePayRamforondeployingaPayramVPS:withoutreturnsanythewebdefaultUIheadlessorplan (testnet, USDC on Base) with exact commands and the humaninteraction.hand-offs. Same as payram_setup_plan with defaults; call that tool to personalise (domain, mainnet, BTC, operator, Shopify/WooCommerce).
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨13 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Onboard: install PayRam as an agent"}Diagnose a PayRamsetup (one call)server
Staged,Read-onlyread-onlydiagnosishealthofdiagnosis:a PayRam server by its public URL — works from the hosted MCP without credentials: reachability,->health,merchantTLSAPIcertificate,keyinstalled->vsadminlatestJWTversion,->workerpaymentstates.readinessOptionally(walletsvalidates+anlistenerAPIworkers).key without creating anything. Returns ranked likely causeswithand exactfix commandsfixes for the first failing stage. Run thisFIRSTfirst when anything PayRam-related fails.
{"$schema":"httphttps://json-schema.org/draft-07/schema#","additionalProperties//json-schema.org/draft/2020-12/schema":false,"properties":{"apiKey":{"description":"MerchantOptional project API key to validate (per-projectnever creates anything).DefaultsPassingtoitPAYRAM_API_KEY.putsObtaintheheadlessly:key./setup_payram_agents.shinensure-api-keythis conversation; prefer running payram_ops_playbook \"connect\" locally.","minLength":1,"type":"string"},"baseUrl":{"description":"
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"failedStage":{"anyOfbaseUrl":[{"type":["string"},{"type":"null"}]},"failedStage":{"description":"First failing stage: reachability | api-key | jwt | readiness;, null when healthy","type":["string","null"]},"findings":{"items":{"additionalProperties": ⟨19 unchanged words⟩ ,"healthy":{"type":"boolean"},"latestVersion":{"type":["string","null"]},"likelyCauses":{"description":"Ranked causes for the ⟨23 unchanged words⟩ :{"description":"Rough probability, e.g. \"80%\60%\"","type":"string"}},"required" ⟨9 unchanged words⟩ type":"string"},"type":"array"},"version":{"type":["string","null"]
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true,"title":"Diagnose a PayRam server"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payram Test Readiness Checklist"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"appName" ⟨76 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"appName" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Scaffold Payram Payments & Payouts App"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Express create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"FastAPI create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Go (Gin) create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Laravel create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Next.js create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Spring Boot create-payment controller snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions$defs":{"__schema0":{"additionalProperties":false,"properties":{"children":{"items":{"$ref":"#/definitions/__schema0#/$defs/__schema0"},"type":"array"},"description": ⟨13 unchanged words⟩ "type"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description":{"type":"string" ⟨2 unchanged words⟩ :"string"},"root":{"$ref":"#/definitions/__schema0#/$defs/__schema0"},"title":{"type":"string"} ⟨5 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Suggest Payram File Structure"}TestPayramPayRamConnectivityconnectivity
Checks the /api/v1/paymentRead-onlyendpointcheckonthat aPayramPayRam serverusingisbaseUrlreachable andapiKey.healthyIfand,theyifareannotAPIprovidedkey is supplied,returnsthatathe.envkeytemplateisyouaccepted.canNeveraddcreatestopayments.yourForworkspace.a full diagnosis use payram_doctor.
{"$schema":"httphttps://json-schema.org/draft-07/schema#","additionalProperties//json-schema.org/draft/2020-12/schema":false,"properties":{"apiKey":{"description":"YourOptionalPayramproject API keyfromtothevalidatedashboard.(nothingIfisnotcreated).provided,PassingusesitPAYRAM_API_KEYexposesfromtheenvironment.
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"baseUrl" ⟨2 unchanged words⟩ ,"errorMessage":{"type":"string"},"okkeyChecked":{"type":"boolean"},"payramVersionok":{"type":"stringboolean"},"statusCode":{"anyOf":[{"maximum":599,"minimum":100,"typepayramVersion":"integer"},{"type":"nullstring"}]}},"required":["ok","statusCodebaseUrl","baseUrlkeyChecked"],"type":"object"}
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true,"title":"Test PayRam connectivity"}PayRam ops playbook (direct API recipes) — 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 runbooks (one-off admin tasks) — 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.
Plan a PayRam install (step by step) — 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). Pass stage to resume mid-way.
Assess Payram readiness in an existing codebase — Inspects dependency files, frameworks, and .env status to suggest the next integration actions.
Check Node Sync — Per-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.
Check Payment Readiness — Diagnoses 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.
Create Payment Link — Creates 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}).
Get Daily Volume — Returns 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.
Get Payment Summary — Returns payment counts: total, open, closed, and cancelled. Useful for a quick overview of payment activity.
Get Unswept Balances — Returns 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".
List Supported Currencies — Lists 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 Platforms — Lists all external platforms (projects) for the authenticated user. Use this to discover your platform ID, which other tools auto-resolve if omitted.
List Payout Recipients — Lists 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.
Lookup Payment — Look up payments by transaction hash, email, reference ID, customer ID, or invoice ID. Returns up to 5 matching payments with full details.
Restart PayRam Worker — REMEDIATION 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.
Search Payments — Search and filter payments with full control over status, network, currency, dates, webhook status, and pagination. Returns a paginated list of matching payments.
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payment Flow Guide"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payram Basics Overview"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Core Payram Concepts"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Referral Flow Guide"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Referral Basics Overview"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨51 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram .env Template"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"language" ⟨44 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate mock Payram webhook event"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"language" ⟨20 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate HTTP payment snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨20 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨23 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate SDK payment snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"style" ⟨24 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨46 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payment status snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨39 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate 3-step recipient payout flow snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨16 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨39 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payout SDK snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨39 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate payout status SDK snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨20 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨16 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral SDK snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"style" ⟨24 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral status snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate referral validation snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨44 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram Setup Checklist"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨46 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"notes" ⟨14 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate top-up wallet integration"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram webhook event router"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"framework" ⟨21 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Generate Payram webhook HTTP handler"}GetAgenttheSetupheadlessFlowagent guide (full reference)
Returns thestep-by-step setup flowcanonicalforPayRamdeployingheadless-agentPayRamguideas(payram-scriptsanPAYRAM_HEADLESS_AGENT.md):agent.agentCoversCLIinstallcommands,walletenvcreationvars,faucetmerchantfunding,vscontractoperatordeploymentmode,andwalletfirstflows,payment.addingIncludeschains,chaintroubleshooting.recommendationsLong (ETH Sepolia for testnet, Base for~11kmainnettokens), faucet URLs, card-to-crypto.prerequisites,Forandastatus/recoveryshortcommandspersonalisedforplaninterruptedusesessions.payram_setup_plan.
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨13 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Get the headless agent guide (full reference)"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{"id":{"minLength": ⟨7 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"id" ⟨19 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Get Payram Doc By ID"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payram Important Links"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Referral Dashboard Guide"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{"prefix":{"type": ⟨3 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"count" ⟨16 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"List Payram Docs"}GetOnboard:PayraminstallAgentPayRamOnboardingasGuidean agent
ReturnsQuickthestartcompleteforautonomousan agentsetupinstallingguidePayRamforondeployingaPayramVPS:withoutreturnsanythewebdefaultUIheadlessorplan (testnet, USDC on Base) with exact commands and the humaninteraction.hand-offs. Same as payram_setup_plan with defaults; call that tool to personalise (domain, mainnet, BTC, operator, Shopify/WooCommerce).
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨13 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Onboard: install PayRam as an agent"}Diagnose a PayRamsetup (one call)server
Staged,Read-onlyread-onlydiagnosishealthofdiagnosis:a PayRam server by its public URL — works from the hosted MCP without credentials: reachability,->health,merchantTLSAPIcertificate,keyinstalled->vsadminlatestJWTversion,->workerpaymentstates.readinessOptionally(walletsvalidates+anlistenerAPIworkers).key without creating anything. Returns ranked likely causeswithand exactfix commandsfixes for the first failing stage. Run thisFIRSTfirst when anything PayRam-related fails.
{"$schema":"httphttps://json-schema.org/draft-07/schema#","additionalProperties//json-schema.org/draft/2020-12/schema":false,"properties":{"apiKey":{"description":"MerchantOptional project API key to validate (per-projectnever creates anything).DefaultsPassingtoitPAYRAM_API_KEY.putsObtaintheheadlessly:key./setup_payram_agents.shinensure-api-keythis conversation; prefer running payram_ops_playbook \"connect\" locally.","minLength":1,"type":"string"},"baseUrl":{"description":"
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"failedStage":{"anyOfbaseUrl":[{"type":["string"},{"type":"null"}]},"failedStage":{"description":"First failing stage: reachability | api-key | jwt | readiness;, null when healthy","type":["string","null"]},"findings":{"items":{"additionalProperties": ⟨19 unchanged words⟩ ,"healthy":{"type":"boolean"},"latestVersion":{"type":["string","null"]},"likelyCauses":{"description":"Ranked causes for the ⟨23 unchanged words⟩ :{"description":"Rough probability, e.g. \"80%\60%\"","type":"string"}},"required" ⟨9 unchanged words⟩ type":"string"},"type":"array"},"version":{"type":["string","null"]
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true,"title":"Diagnose a PayRam server"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description" ⟨59 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Payram Test Readiness Checklist"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"appName" ⟨76 unchanged words⟩
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"appName" ⟨41 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Scaffold Payram Payments & Payouts App"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Express create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"FastAPI create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Go (Gin) create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Laravel create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Next.js create-payment route snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"meta" ⟨50 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Spring Boot create-payment controller snippet"}{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{},"type":"object"}
{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"definitions$defs":{"__schema0":{"additionalProperties":false,"properties":{"children":{"items":{"$ref":"#/definitions/__schema0#/$defs/__schema0"},"type":"array"},"description": ⟨13 unchanged words⟩ "type"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"description":{"type":"string" ⟨2 unchanged words⟩ :"string"},"root":{"$ref":"#/definitions/__schema0#/$defs/__schema0"},"title":{"type":"string"} ⟨5 unchanged words⟩
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Suggest Payram File Structure"}TestPayramPayRamConnectivityconnectivity
Checks the /api/v1/paymentRead-onlyendpointcheckonthat aPayramPayRam serverusingisbaseUrlreachable andapiKey.healthyIfand,theyifareannotAPIprovidedkey is supplied,returnsthatathe.envkeytemplateisyouaccepted.canNeveraddcreatestopayments.yourForworkspace.a full diagnosis use payram_doctor.
{"$schema":"httphttps://json-schema.org/draft-07/schema#","additionalProperties//json-schema.org/draft/2020-12/schema":false,"properties":{"apiKey":{"description":"YourOptionalPayramproject API keyfromtothevalidatedashboard.(nothingIfisnotcreated).provided,PassingusesitPAYRAM_API_KEYexposesfromtheenvironment.
{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"baseUrl" ⟨2 unchanged words⟩ ,"errorMessage":{"type":"string"},"okkeyChecked":{"type":"boolean"},"payramVersionok":{"type":"stringboolean"},"statusCode":{"anyOf":[{"maximum":599,"minimum":100,"typepayramVersion":"integer"},{"type":"nullstring"}]}},"required":["ok","statusCodebaseUrl","baseUrlkeyChecked"],"type":"object"}
before
—after
{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true,"title":"Test PayRam connectivity"}PayRam ops playbook (direct API recipes) — 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 runbooks (one-off admin tasks) — 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.
Plan a PayRam install (step by step) — 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). Pass stage to resume mid-way.
Assess Payram readiness in an existing codebase — Inspects dependency files, frameworks, and .env status to suggest the next integration actions.
Check Node Sync — Per-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.
Check Payment Readiness — Diagnoses 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.
Create Payment Link — Creates 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}).
Get Daily Volume — Returns 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.
Get Payment Summary — Returns payment counts: total, open, closed, and cancelled. Useful for a quick overview of payment activity.
Get Unswept Balances — Returns 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".
List Supported Currencies — Lists 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 Platforms — Lists all external platforms (projects) for the authenticated user. Use this to discover your platform ID, which other tools auto-resolve if omitted.
List Payout Recipients — Lists 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.
Lookup Payment — Look up payments by transaction hash, email, reference ID, customer ID, or invoice ID. Returns up to 5 matching payments with full details.
Restart PayRam Worker — REMEDIATION 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.
Search Payments — Search and filter payments with full control over status, network, currency, dates, webhook status, and pagination. Returns a paginated list of matching payments.