Mcp Iugu

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for iugu — invoices, subscriptions, customers, payment methods

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the iugu payment platform, letting an assistant manage invoices, customers, plans, subscriptions, payment methods and marketplace…

What you can do
  • Create, read, list, duplicate, cancel and refund invoices
  • Create and update customers, and list them with filters
  • Create, update and list subscription plans, and create, suspend, activate or cancel subscriptions
  • Tokenize credit cards, attach payment methods to customers, and read account info and balance
  • Create marketplace sub-accounts, transfer funds between accounts, request withdrawals and register webhooks
When to use it
Useful when you work with iugu for Brazilian billing and want an assistant to draft invoices, look up customers, manage recurring subscriptions, or inspect account balance and configuration without leaving the chat.
Requirements
Runs locally via npx from the npm package @codespar/mcp-iugu, so Node.js is needed. Requires an iugu account and an API token supplied in the IUGU_API_TOKEN environment variable; the optional IUGU_SANDBOX variable set to "true" switches to test mode. Network access to the iugu API is required.
Before you install
The token grants access to a live payment account: invoices, refunds, transfers, withdrawals and webhooks can move real money or change billing state. Start with a test-mode token and IUGU_SANDBOX to avoid real charges, and keep the token out of shared config files. Card tokenization sends card data to iugu.

Installation

In SourceWeft

  1. Open Mcp Iugu in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-iugu

MCP server for iugu — invoices, subscriptions, and payment management

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "iugu": {      "command": "npx",      "args": ["-y", "@codespar/mcp-iugu"],      "env": {        "IUGU_API_TOKEN": "your-token"      }    }  }}

Claude Code

bash
claude mcp add iugu -- npx @codespar/mcp-iugu

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "iugu": {      "command": "npx",      "args": ["-y", "@codespar/mcp-iugu"],      "env": {        "IUGU_API_TOKEN": "your-token"      }    }  }}

Tools (23)

ToolPurpose
create_invoiceCreate an invoice in iugu (Pix, boleto, or credit card)
get_invoiceGet invoice details by ID
list_invoicesList invoices with optional filters
cancel_invoiceCancel (delete) an invoice.
refund_invoiceRefund a paid invoice (full or partial).
duplicate_invoiceDuplicate an existing invoice with a new due date.
create_customerCreate a customer in iugu
update_customerUpdate a customer.
list_customersList customers with optional filters
create_planCreate a subscription plan (recurring template).
update_planUpdate an existing plan.
list_plansList subscription plans.
create_subscriptionCreate a recurring subscription in iugu
suspend_subscriptionSuspend a subscription.
activate_subscriptionReactivate a suspended subscription.
cancel_subscriptionCancel (delete) a subscription.
create_payment_tokenTokenize a credit card server-side.
create_payment_methodAttach a payment method (credit card token) to a customer.
create_subaccountCreate a marketplace sub-account.
create_transferTransfer funds between iugu accounts (marketplace).
request_withdrawRequest a bank withdrawal (saque) from a sub-account.
create_webhookRegister a webhook (gatilho) for an iugu event.
get_account_infoGet account information, configuration, and balance

Authentication

iugu uses Basic Auth with the API token as username and an empty password.

Sandbox / Testing

iugu provides test mode via the dashboard. Use a test-mode API token to avoid real charges.

Get your credentials

  1. Go to iugu Developer Portal
  2. Create an account and access the dashboard
  3. Toggle to test mode and generate an API token
  4. Set the IUGU_API_TOKEN environment variable

Environment Variables

VariableRequiredDescription
IUGU_API_TOKENYesAPI token from iugu dashboard
IUGU_SANDBOXNoSet to "true" for test mode

Roadmap

v0.3 (planned)

  • create_split — Create split payment rules
  • list_transfers — List marketplace transfers
  • get_financial_report — Financial summary report
  • batch_invoices — Create multiple invoices in a single request
  • list_payment_methods — List saved payment methods for a customer

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/payments/iugu/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts