Skip to content
MCP server

PagSafe MCP by usefulapi

Create Pix charges, check and refund payments, and manage Pix subscriptions in PagSafe.

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://pagsafe.usefulapi.io/mcp
Install 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