Culqi MCP server

Read from the package source without running it. The installed server may list more.

• cancel_subscriptionwrite action

  Cancel an active subscription (DELETE /subscriptions/{id}).

• capture_chargewrite action

  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.

• confirm_orderwrite action

  Confirm an unpaid order (POST /orders/{id}/confirm). Moves the order to a confirmed state ready to be paid by the customer via Yape / PagoEfectivo.

• create_cardwrite action

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

• create_chargewrite action

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

• create_customerwrite action

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

• create_orderwrite action

  Create an order (POST /orders) for non-card payment methods — Yape, PagoEfectivo (Cash), bank transfer. Returns an order with CIP / QR data the payer uses to complete payment. Confirm reception via webhooks or confirm_order.

• create_planwrite action

  Create a subscription plan (POST /plans). Plans are reusable templates — attach customer cards via create_subscription.

• create_subscriptionwrite action

  Subscribe a customer's saved card to a plan (POST /subscriptions). Requires tyc=true (terms & conditions acceptance).

• create_tokenwrite action

  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.

• delete_cardwrite action

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

• get_chargewrite action

  Retrieve a charge by Culqi id.

• get_customer

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

• get_event

  Retrieve a single webhook event by id (GET /events/{id}). Useful for auditing a webhook delivery against Culqi's canonical record.

• get_refundwrite action

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

• list_charges

  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.

• list_customers

  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.

• list_events

  List webhook events (GET /events) with optional filters. Filters are passed through as query params: event_type, creation_date_from, creation_date_to, limit, before, after.

• list_orders

  List orders (GET /orders) with optional filters passed as query params: order_number, state (created, paid, expired, deleted, failed), creation_date_from (ms), creation_date_to (ms), limit, before, after.

• refund_chargewrite action

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

• Code scan5 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 29 days ago15/15
• Maintainer identityregistry namespace matches repository owner7/10

Safety score

82/100

higher than 63% of 48,255 servers

Tools

20

the typical server has 7

Tools that change things

70%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

271

more than 95% of 28,688 servers

Culqi: common questions

Is Culqi MCP server safe?

Mostly: it is graded B (82/100). Read the Culqi safety report

How do I install Culqi?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Culqi need an API key?

Yes. The registry entry asks for CULQI_SECRET_KEY.

Is Culqi maintained?

The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.

How does Culqi compare with other MCP servers?

safety score 82/100 (higher than 63% of 48,255 servers); tools 20 (the typical server has 7); tools that change things 70% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.