UnblockPay

What your agent can do

UnblockPay gives your agent 13 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →create_customer — Create an individual or business customer (KYC mother). Business customers require date_of_incorporation; both types use 3-letter ISO country codes (BRA/USA/MEX). Returns { id, status: 'pending', verification: { verification_link } }.
• →list_customers — List customers under the operator's API key. `limit` is mandatory per UnblockPay's pagination contract.
• →verify_customer — Trigger the KYC verification check for a customer. Sandbox auto-progresses business customers through the hosted KYC flow once documents are uploaded. Idempotent — returns 422 'customer_cannot_be_verified' when already approved (safe to ignore).

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_customer", { /* ... */ });

Install

$ npm install @codespar/mcp-unblockpay

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "unblockpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-unblockpay"
      ],
      "env": {
        "UNBLOCKPAY_API_KEY": "<your_unblockpay_api_key>"
      }
    }
  }
}

After restart, your agent can call any of the 13 tools below — try create_customer first.

Environment variables · 2

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 13

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions