Culqi

Peru's Stripe-analog — default PSP for Peruvian D2C and SaaS (CulqiOnline, CulqiLink, CulqiFull). Brings Peru into the catalog alongside BR/MX/AR/CO/CL.

MIT · runs locally with your own credentials

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Tools

What your agent can call.

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 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).

Retrieve a charge by Culqi id.

List charges (GET /charges) with optional filters. Filters are passed as query params: amount, min_amount, max_amount, installments, currency_code, code (auth code), decline_code, fraud_score, first_name, last_name, email, country_code, creation_date_from (ms), creation_date_to (ms), limit, before, after.

Capture a previously-authorized charge (POST /charges/{id}/capture). Use after creating a charge with capture=false. Must be called within 10 days of authorization.

Refund a captured charge (POST /refunds). Partial refunds supported by setting amount below the charge total.

Retrieve a refund by id (GET /refunds/{id}).

Create a customer record (POST /customers). Use the returned customer_id with create_card to save reusable cards.

Retrieve a customer by Culqi id (GET /customers/{id}).

List customers (GET /customers) with optional filters passed as query params: first_name, last_name, email, country_code, creation_date_from (ms), creation_date_to (ms), limit, before, after.

Attach a tokenized card to a customer for reuse (POST /cards). Returns a card id (crd_xxx) usable as source_id on future charges.

Detach a saved card from its customer (DELETE /cards/{id}). The card id becomes unusable as source_id afterwards.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.