cypher_restore_credits
ActiveTool of cypher-mcp
Credit a patron's ledger from a BTCPay-settled invoice. **RESTRICTED to the operator** — the operator owns the books and is the only party who can issue a manual credit grant. Patrons who believe they paid but never got credits must escalate to the operator's support, who then invokes this tool on their behalf. Use cases: cold-start vault races during check_payment, ncred delivery hiccups, patrons closing Top-Off sheets before settle, any infrastructure incident that left an invoice settled at BTCPay but uncredited on the operator's ledger. Idempotent — if the invoice is already credited (in the patron's ``credited_invoices``), returns success with credits_granted=0.
Parameters schema
{
"type": "object",
"required": [
"invoice_id",
"patron_npub",
"dpop_token"
],
"properties": {
"dpop_token": {
"type": "string",
"description": "A kind-27235 Nostr event signed by the OPERATOR's nsec\nfor this tool. Patron proofs are rejected."
},
"invoice_id": {
"type": "string",
"description": "The BTCPay invoice ID to verify and credit."
},
"patron_npub": {
"type": "string",
"description": "The patron's npub whose ledger receives the grant."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
cypher-mcp
https://github.com/lonniev/cypher-mcp
2/7 registries