io.github.codespar/mcp-culqi
NPM · @CODESPAR/MCP-CULQI · SCANNED AUG 4
MCP server for Culqi — Peru PSP: charges, refunds, cards, Yape/PagoEfectivo, subscriptions
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security83
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known medium-severity CVE affects hono 4.12.33, reached via @modelcontextprotocol/sdk > hono. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 42 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability77
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 1887 tokens (~94/item across 20 items; 20 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management30
- Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @codespar/mcp-culqi
claude mcp add codespar-mcp-culqi -- npx -y @codespar/mcp-culqi
codex mcp add codespar-mcp-culqi -- npx -y @codespar/mcp-culqi
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"codespar-mcp-culqi": {
"type": "local",
"command": [
"npx",
"-y",
"@codespar/mcp-culqi"
],
"enabled": true
}
}
} openclaw mcp add codespar-mcp-culqi --command npx --arg -y --arg @codespar/mcp-culqi
mcp_servers:
codespar-mcp-culqi:
command: "npx"
args: ["-y", "@codespar/mcp-culqi"] {
"mcpServers": {
"codespar-mcp-culqi": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-culqi"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Aug 26 0
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
- 3 Aug 26 +48
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Maintenance: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Stability: unverified → 0.27 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
- 2 Aug 26 +15
- Malware scan: unverified → pass ▲ security
- 1 Aug 26 −15
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- 31 Jul 26 −3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −22
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- 27 Jul 26 46
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 4 Aug 2026 · Analysed npm/@codespar/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Vulnerabilities 1 finding
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-8j4g-w8fx-2239 | CVE-2026-69207 | medium | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L | yes |
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
cancel_subscription ~35
Cancel an active subscription (DELETE /subscriptions/{id}).
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi subscription id (sub_xxx) |
No output schema declared.
No examples provided.
capture_charge ~59
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi charge id to capture (chr_xxx) |
No output schema declared.
No examples provided.
confirm_order ~59
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi order id (ord_xxx) |
No output schema declared.
No examples provided.
create_card ~109
Attach a tokenized card to a customer for reuse (POST /cards). Returns a card id (crd_xxx) usable as source_id on future charges.
| Name | Type | Req | Description |
|---|---|---|---|
| customer_id | string | yes | Culqi customer id (cus_xxx) |
| metadata | object | — | Merchant-side key-value metadata |
| token_id | string | yes | Culqi token id from create_token (tkn_xxx) |
| validate | boolean | — | Run a 0-amount validation charge on attach (default true) |
No output schema declared.
No examples provided.
create_charge ~219
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).
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Amount in cents (e.g. 1000 = S/ 10.00) |
| antifraud_details | object | — | Antifraud signals — recommended for live traffic |
| capture | boolean | — | true (default) authorizes + captures; false authorizes only |
| currency_code | string | yes | ISO-4217 currency code supported by Culqi |
| description | string | — | Human-readable description for the payer |
| string | yes | Payer email | |
| installments | number | — | Installment count for cuotas (0 for single payment) |
| metadata | object | — | Merchant-side key-value metadata |
| source_id | string | yes | Token id (tkn_xxx) or saved card id (crd_xxx) |
No output schema declared.
No examples provided.
create_customer ~127
Create a customer record (POST /customers). Use the returned customer_id with create_card to save reusable cards.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Street address |
| address_city | string | yes | City |
| country_code | string | yes | ISO-3166 alpha-2 (e.g. PE) |
| string | yes | Customer email (must be unique) | |
| first_name | string | yes | Customer first name |
| last_name | string | yes | Customer last name |
| metadata | object | — | Merchant-side key-value metadata |
| phone_number | string | yes | Phone, digits only |
No output schema declared.
No examples provided.
create_order ~185
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.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Order amount in cents |
| client_details | object | yes | Payer details required for Yape / Cash orders |
| confirm | boolean | — | If true, confirms the order immediately on creation (default false) |
| currency_code | string | yes | ISO-4217 currency |
| description | string | yes | Human-readable order description |
| expiration_date | number | yes | Unix epoch seconds for when the order expires (must be ~>10 min ahead) |
| metadata | object | — | Merchant-side key-value metadata |
| order_number | string | yes | Merchant-side unique order number (3-80 chars) |
No output schema declared.
No examples provided.
create_plan ~146
Create a subscription plan (POST /plans). Plans are reusable templates — attach customer cards via create_subscription.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Amount charged per interval, in cents |
| currency_code | string | yes | Plan currency |
| description | string | — | Plan description |
| initial_cycles | object | — | Optional intro pricing for the first N cycles |
| interval_count | number | yes | Number of interval units between charges (e.g. 1 = every month) |
| interval_unit_time | string | yes | Billing interval unit |
| metadata | object | — | Merchant-side key-value metadata |
| name | string | yes | Full plan name |
| short_name | string | yes | Short/display name |
No output schema declared.
No examples provided.
create_subscription ~102
Subscribe a customer's saved card to a plan (POST /subscriptions). Requires tyc=true (terms & conditions acceptance).
| Name | Type | Req | Description |
|---|---|---|---|
| card_id | string | yes | Culqi card id (crd_xxx) from create_card |
| metadata | object | — | Merchant-side key-value metadata |
| plan_id | string | yes | Culqi plan id (pln_xxx) from create_plan |
| tyc | boolean | yes | Customer accepted terms & conditions. Must be true. |
No output schema declared.
No examples provided.
create_token ~156
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.
| Name | Type | Req | Description |
|---|---|---|---|
| card_number | string | yes | PAN (13-19 digits). Never log. |
| cvv | string | yes | Card verification value (3 or 4 digits) |
| string | yes | Cardholder email | |
| expiration_month | string | yes | Two-digit month (01-12) |
| expiration_year | string | yes | Four-digit year (e.g. 2027) |
| metadata | object | — | Optional merchant-side key-value metadata |
No output schema declared.
No examples provided.
delete_card ~50
Detach a saved card from its customer (DELETE /cards/{id}). The card id becomes unusable as source_id afterwards.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi card id (crd_xxx) |
No output schema declared.
No examples provided.
get_charge ~31
Retrieve a charge by Culqi id.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi charge id (chr_xxx) |
No output schema declared.
No examples provided.
get_customer ~38
Retrieve a customer by Culqi id (GET /customers/{id}).
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi customer id (cus_xxx) |
No output schema declared.
No examples provided.
get_event ~50
Retrieve a single webhook event by id (GET /events/{id}). Useful for auditing a webhook delivery against Culqi's canonical record.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi event id (evt_xxx) |
No output schema declared.
No examples provided.
get_refund ~38
Retrieve a refund by id (GET /refunds/{id}).
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Culqi refund id (ref_xxx) |
No output schema declared.
No examples provided.
list_charges ~99
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.
| Name | Type | Req | Description |
|---|---|---|---|
| filters | object | — | Query filters passed as-is to the Culqi /charges endpoint. |
No output schema declared.
No examples provided.
list_customers ~72
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.
| Name | Type | Req | Description |
|---|---|---|---|
| filters | object | — | Query filters passed as-is to the Culqi /customers endpoint. |
No output schema declared.
No examples provided.
list_events ~89
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.
| Name | Type | Req | Description |
|---|---|---|---|
| filters | object | — | Query filters passed as-is: event_type (e.g. 'charge.creation.succeeded'), creation_date_from (ms timestamp), creation_date_to (ms timestamp), limit, before, after. |
No output schema declared.
No examples provided.
list_orders ~75
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.
| Name | Type | Req | Description |
|---|---|---|---|
| filters | object | — | Query filters passed as-is to the Culqi /orders endpoint. |
No output schema declared.
No examples provided.
refund_charge ~81
Refund a captured charge (POST /refunds). Partial refunds supported by setting amount below the charge total.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Refund amount in cents |
| charge_id | string | yes | Culqi charge id to refund (chr_xxx) |
| metadata | object | — | Optional metadata |
| reason | string | yes | Refund reason (Culqi enum) |
No output schema declared.
No examples provided.