io.github.codespar/mcp-iugu
NPM · @CODESPAR/MCP-IUGU · SCANNED AUG 8
MCP server for iugu — invoices, subscriptions, customers, payment methods
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 Security48
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 30 of 95 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- 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 46 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability66
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1684 tokens (~73/item across 23 items; 23 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management43
- Stability observed for 13 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage94
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 83% of tool parameters carry a description.Partial
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-iugu
claude mcp add codespar-mcp-iugu -- npx -y @codespar/mcp-iugu
codex mcp add codespar-mcp-iugu -- npx -y @codespar/mcp-iugu
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"codespar-mcp-iugu": {
"type": "local",
"command": [
"npx",
"-y",
"@codespar/mcp-iugu"
],
"enabled": true
}
}
} openclaw mcp add codespar-mcp-iugu --command npx --arg -y --arg @codespar/mcp-iugu
mcp_servers:
codespar-mcp-iugu:
command: "npx"
args: ["-y", "@codespar/mcp-iugu"] {
"mcpServers": {
"codespar-mcp-iugu": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-iugu"
]
}
}
} 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.
- 8 Aug 26 +1
- Security disclosure: fail → pass ▲ functional
- 7 Aug 26 +4
- Known CVEs: partial → pass ▲ security
- Dependency health: partial → 0.85 functional
- 6 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.
- 5 Aug 26 +1
- CVE-2026-69207 no longer affects this package ▲ security
- Known CVEs: fail → partial ▲ security
- 4 Aug 26 0
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
- 2 Aug 26 +26
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- License: unverified → pass ▲ functional
- Stability: unverified → 0.23 ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- Licence: MIT functional
- 1 Aug 26 +5
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
- 31 Jul 26 −8
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
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 8 Aug 2026 · Analysed npm/@codespar/[email protected]
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Dependencies 95 packages
| Packages resolved | 95 |
|---|---|
| Stale | 30 |
| Tree resolution | Complete |
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.
activate_subscription ~33
Reactivate a suspended subscription. Endpoint: POST /subscriptions/:id/activate
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Subscription ID |
No output schema declared.
No examples provided.
cancel_invoice ~33
Cancel (delete) an invoice. Endpoint: DELETE /invoices/:id
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Invoice ID |
No output schema declared.
No examples provided.
cancel_subscription ~32
Cancel (delete) a subscription. Endpoint: DELETE /subscriptions/:id
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Subscription ID |
No output schema declared.
No examples provided.
create_customer ~123
Create a customer in iugu
| Name | Type | Req | Description |
|---|---|---|---|
| city | string | – | City |
| cpf_cnpj | string | – | CPF or CNPJ (numbers only) |
| string | yes | Email address | |
| name | string | yes | Customer name |
| number | string | – | Address number |
| phone | string | – | Phone number |
| phone_prefix | string | – | Phone area code (DDD) |
| state | string | – | State (UF, 2 letters) |
| street | string | – | Street address |
| zip_code | string | – | ZIP code (CEP) |
No output schema declared.
No examples provided.
create_invoice ~110
Create an invoice in iugu (Pix, boleto, or credit card)
| Name | Type | Req | Description |
|---|---|---|---|
| customer_id | string | – | Customer ID (optional) |
| due_date | string | yes | Due date (YYYY-MM-DD) |
| string | yes | Payer email address | |
| items | array | yes | Invoice items |
| notification_url | string | – | Webhook URL for status updates |
| payable_with | string | – | Payment method (default: all) |
| return_url | string | – | URL to redirect after payment |
No output schema declared.
No examples provided.
create_payment_method ~93
Attach a payment method (credit card token) to a customer. Endpoint: POST /customers/:customer_id/payment_methods
| Name | Type | Req | Description |
|---|---|---|---|
| customer_id | string | yes | Customer ID |
| description | string | yes | Card description (e.g., 'Visa ending 1234') |
| set_as_default | boolean | – | Set as default payment method |
| token | string | yes | Card token from iugu.js or create_payment_token |
No output schema declared.
No examples provided.
create_payment_token ~95
Tokenize a credit card server-side. Endpoint: POST /payment_token. WARNING: using this from your server subjects you to PCI audits — prefer iugu.js client-side tokenization in production.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | yes | iugu account ID |
| data | object | yes | Card data |
| method | string | yes | Payment method (e.g., 'credit_card') |
| test | boolean | – | Use test mode |
No output schema declared.
No examples provided.
create_plan ~134
Create a subscription plan (recurring template). Endpoint: POST /plans
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | – | Currency code (default BRL) |
| features | array | – | Plan features |
| identifier | string | yes | Unique slug identifier (e.g., 'basic_monthly') |
| interval | number | yes | Interval quantity (e.g., 1) |
| interval_type | string | yes | Interval unit |
| name | string | yes | Plan name |
| payable_with | array | – | Allowed payment methods: credit_card, bank_slip, pix |
| value_cents | number | yes | Price per period in cents (BRL) |
No output schema declared.
No examples provided.
create_subaccount ~78
Create a marketplace sub-account. Endpoint: POST /marketplace/create_account. Note: only works in production mode. Returns live/test API tokens and user_token.
| Name | Type | Req | Description |
|---|---|---|---|
| commission_percent | number | – | Commission percentage to retain from this sub-account |
| name | string | – | Sub-account name (no special characters; defaults to account_id if omitted) |
No output schema declared.
No examples provided.
create_subscription ~121
Create a recurring subscription in iugu
| Name | Type | Req | Description |
|---|---|---|---|
| credits_based | boolean | – | Whether this is a credit-based subscription |
| customer_id | string | yes | Customer ID |
| expires_at | string | – | First charge date (YYYY-MM-DD) |
| only_on_charge_success | boolean | – | Only activate on first successful charge |
| payable_with | string | – | Payment method |
| plan_identifier | string | – | Plan identifier slug |
| price_cents | number | – | Amount in cents for credit-based subscriptions |
| return_url | string | – | Redirect URL after payment |
No output schema declared.
No examples provided.
create_transfer ~52
Transfer funds between iugu accounts (marketplace). Endpoint: POST /transfers
| Name | Type | Req | Description |
|---|---|---|---|
| amount_cents | number | yes | Amount in cents (minimum 1) |
| receiver_id | string | yes | Destination account ID |
No output schema declared.
No examples provided.
create_webhook ~79
Register a webhook (gatilho) for an iugu event. Endpoint: POST /web_hooks
| Name | Type | Req | Description |
|---|---|---|---|
| authorization | string | – | Optional Basic auth header value for callbacks |
| event | string | yes | Event name (e.g., 'invoice.status_changed', 'subscription.expired') |
| url | string | yes | Your endpoint that will receive the POST |
No output schema declared.
No examples provided.
duplicate_invoice ~69
Duplicate an existing invoice with a new due date. Endpoint: POST /invoices/:id/duplicate
| Name | Type | Req | Description |
|---|---|---|---|
| due_date | string | yes | New due date (YYYY-MM-DD) |
| id | string | yes | Invoice ID to duplicate |
| ignore_due_email | boolean | – | Skip sending due-date email |
No output schema declared.
No examples provided.
get_account_info ~18
Get account information, configuration, and balance
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_invoice ~23
Get invoice details by ID
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Invoice ID |
No output schema declared.
No examples provided.
list_customers ~46
List customers with optional filters
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of results |
| query | string | – | Search by name or email |
| start | number | – | Pagination offset |
No output schema declared.
No examples provided.
list_invoices ~93
List invoices with optional filters
| Name | Type | Req | Description |
|---|---|---|---|
| created_at_from | string | – | Filter from date (YYYY-MM-DD) |
| created_at_to | string | – | Filter to date (YYYY-MM-DD) |
| customer_id | string | – | Filter by customer ID |
| limit | number | – | Number of results (default 100) |
| start | number | – | Pagination offset |
| status_filter | string | – | Filter by status |
No output schema declared.
No examples provided.
list_plans ~50
List subscription plans. Endpoint: GET /plans
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of results |
| query | string | – | Search by name or identifier |
| start | number | – | Pagination offset |
No output schema declared.
No examples provided.
refund_invoice ~59
Refund a paid invoice (full or partial). Endpoint: POST /invoices/:id/refund
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Invoice ID |
| partial_value_refund_cents | number | – | Partial refund amount in cents (omit for full refund) |
No output schema declared.
No examples provided.
request_withdraw ~67
Request a bank withdrawal (saque) from a sub-account. Endpoint: POST /accounts/:id/request_withdraw
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | yes | Sub-account ID requesting the withdraw |
| amount | string | yes | Amount (e.g., '100.00' in BRL) |
No output schema declared.
No examples provided.
suspend_subscription ~31
Suspend a subscription. Endpoint: POST /subscriptions/:id/suspend
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Subscription ID |
No output schema declared.
No examples provided.
update_customer ~109
Update a customer. Endpoint: PUT /customers/:id. Omitted fields are unchanged.
| Name | Type | Req | Description |
|---|---|---|---|
| city | string | – | – |
| cpf_cnpj | string | – | – |
| string | – | – | |
| id | string | yes | Customer ID |
| name | string | – | – |
| number | string | – | – |
| phone | string | – | – |
| phone_prefix | string | – | – |
| state | string | – | – |
| street | string | – | – |
| zip_code | string | – | – |
No output schema declared.
No examples provided.
update_plan ~69
Update an existing plan. Endpoint: PUT /plans/:id
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Plan ID |
| interval | number | – | – |
| interval_type | string | – | – |
| name | string | – | – |
| payable_with | array | – | – |
| value_cents | number | – | – |
No output schema declared.
No examples provided.