MCP server
PagSafe MCP by usefulapi
Create Pix charges, check and refund payments, and manage Pix subscriptions in PagSafe.
- Runs
- Remotely
- Version
- 1.4.0
- Listing updated
- 4 days ago
About PagSafe MCP by usefulapi
PagSafe MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http pagsafe https://pagsafe.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://pagsafe.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pagsafe": {
"url": "https://pagsafe.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"pagsafe": {
"type": "http",
"url": "https://pagsafe.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pagsafe": {
"serverUrl": "https://pagsafe.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"pagsafe": {
"type": "http",
"url": "https://pagsafe.usefulapi.io/mcp"
}
}
}Tools this server provides (6)
Read directly from the server.
- pagsafe_create_pix_charge
- Create a one-time Pix charge. Returns the id, status PENDING, and pix.payload (the copy and paste code to show the buyer). The charge is paid only when the PagSafe webhook reports AUTHORIZED: do not treat the reply as paid. A retry with the same external_id, amount and customer.document returns the same pending Pix within 6 hours (reused: true). Writes a real charge. Uses POST /v2/transactions.
- pagsafe_get_transaction
- Get the current status of a transaction created through this API: PENDING, AUTHORIZED (paid), FAILED, REFUNDED, IN_DISPUTE or CHARGEBACK. Use it to check a payment or to recover a lost webhook; prefer the webhook for live updates. Uses GET /v2/transactions/{transaction_id}.
- pagsafe_refund_transaction
- Refund the full amount of a transaction back to the buyer. The transaction must be AUTHORIZED, created through this API, and have enough balance in every split account. A refund cannot be undone. Uses POST /v2/transactions/{transaction_id}/refund.
- pagsafe_create_pix_subscription
- Create a recurring Pix Automático subscription. Returns status PENDING_AUTHORIZATION and pix.qr_code or pix.payment_link: show one to the buyer, who must authorize it once. After authorization the status becomes ACTIVE and later cycles are charged on their own. For Pix, the cycles are SEMANAL, MENSAL and ANUAL only. If the call fails with HTTP 500, check PagSafe for an existing subscription before
- pagsafe_get_subscription
- Get a subscription's status (PENDING_AUTHORIZATION, ACTIVE, LATE, PAUSED or CANCELED), amount, cycle, and the dates of the last and next charge. Uses GET /v2/subscriptions/{subscription_id}.
- pagsafe_cancel_pix_subscription
- Cancel a PagSafe customer subscription so no further cycles are charged. The buyer keeps access until the cycle already paid ends. This cancels a subscription of YOUR customer, not a UsefulAPI plan. Uses POST /v2/subscriptions/{subscription_id}/cancel.
PagSafe MCP by usefulapi FAQ
How do I add PagSafe MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http pagsafe https://pagsafe.usefulapi.io/mcp