Culqi

What your agent can do

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

• →create_token — Tokenize a card (POST /tokens). Returns a token id like tkn_xxx. Tokenization is typically done client-side via culqi.js or mobile SDKs; this tool is primarily for test scripts and integration tests. Never send real PANs from a backend without PCI scope.
• →create_charge — Create a charge (POST /charges). Amount is in cents of the currency (e.g. 1000 = S/ 10.00 PEN). source_id accepts a token id (tkn_xxx) or a stored card id (crd_xxx).
• →get_charge — Retrieve a charge by Culqi id.

// 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_token", { /* ... */ });

Install

$ npm install @codespar/mcp-culqi

Quickstart

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

{
  "mcpServers": {
    "culqi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-culqi"
      ],
      "env": {
        "CULQI_SECRET_KEY": "<your_culqi_secret_key>"
      }
    }
  }
}

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

Environment variables · 1

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

Available tools · 20

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