Culqi MCP Server

MCP server for Culqi - Peru's default PSP. Culqi is the Stripe of Peru: the standard rail for Peruvian D2C brands and SaaS. It ships CulqiOnline (hosted checkout), CulqiLink (payment links), and CulqiFull (subscriptions). Adding Culqi brings Peru into the CodeSpar catalog alongside Mexico, Brazil, Colombia, Argentina, and Chile. Its 20 documented tools cover charge, refund, customer, card.

People who work with charge, refund and customer and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-29 · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Culqi

before you install - you'll need

Set CULQI_SECRET_KEY, MCP_HTTP before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-culqi

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-culqi"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-culqi - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Culqi can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a charge (POST /charges), retrieve a charge by Culqi id, list charges (GET /charges) with optional filters, and capture a previously-authorized charge (POST /charges/{id}/capture).

Capability map

Tools grouped from the project's README - what Culqi lets an agent do.

read & search

5 tools - e.g. List charges (GET /charges) with optional filters.; List customers (GET /customers) with optional filters passed as query params: first_name, last_name, email,...; List orders (GET /orders) with optional…

list_charges · list_customers · list_orders · list_events · get_event

Charge

4 tools - e.g. Create a charge (POST /charges).; Retrieve a charge by Culqi id.; Capture a previously-authorized charge (POST /charges/{id}/capture).

create_charge · get_charge · capture_charge · refund_charge

create & write

3 tools - e.g. Tokenize a card (POST /tokens).; Create an order (POST /orders) for non-card payment methods - Yape, PagoEfectivo (Cash), bank transfer.; Create a subscription plan (POST /plans).

create_token · create_order · create_plan

Customer

2 tools - e.g. Create a customer record (POST /customers).; Retrieve a customer by Culqi id (GET /customers/{id}).

create_customer · get_customer

Card

2 tools - e.g. Attach a tokenized card to a customer for reuse (POST /cards).; Detach a saved card from its customer (DELETE /cards/{id}).

create_card · delete_card

Subscription

2 tools - e.g. Subscribe a customer's saved card to a plan (POST /subscriptions).; Cancel an active subscription (DELETE /subscriptions/{id}).

create_subscription · cancel_subscription

Refund

1 tool - e.g. Retrieve a refund by id (GET /refunds/{id}).

get_refund

Confirm

1 tool - e.g. Confirm an unpaid order (POST /orders/{id}/confirm).

confirm_order

Limitations (from the README)

- Amounts are in cents of the currency (e.g. 1000 = S/ 10.00 PEN). - Currencies supported: PEN, USD. - Tokenization of raw card data is typically done client-side (culqi.js / mobile SDKs). The create_token tool is primarily for test scripts - never send real PANs from a backend without PCI scope. - Subscriptions require tyc: true (terms & conditions acceptance) on creation.

04 · Who maintains Culqi

mcp-culqi is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 271 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: other - actively maintained as of 2026-09-18.
registry: io.github.codespar/mcp-culqi (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-culqi

06 · Culqi FAQ

Is Culqi still maintained?

Yes - as of 2026-09-18, its last commit was 2026-08-29. We re-verify nightly.

What can Culqi do?

How do I install Culqi?

Run `npx -y @codespar/mcp-culqi`. The README documents 2 environment variables (CULQI_SECRET_KEY, MCP_HTTP) to set first. Set CULQI_SECRET_KEY, MCP_HTTP before connecting. You can also paste the ready-made client config above.

Does Culqi run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Culqi

Alternatives to Culqi

Maintained other servers if Culqi isn't the fit.

More MCP servers to compare · Efi · Getnet · Inter Bank · Kushki · Mercado Libre

More TypeScript MCP servers · Dlocal · Ebanx · Flow Cl · see all