Iugu MCP Server

iugu uses Basic Auth with the API token as username and an empty password. iugu provides test mode via the dashboard. Use a test-mode API token to avoid real charges. Its 23 documented tools cover invoice, subscription, customer, plan.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Iugu

before you install - you'll need

IUGU_API_TOKEN

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-iugu

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-iugu"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-iugu - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Iugu can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create an invoice in iugu (Pix, boleto, or credit card), get invoice details by ID, list invoices with optional filters, and cancel (delete) an invoice.

Capability map

Tools grouped from the project's README - what Iugu lets an agent do.

Invoice

5 tools - e.g. Create an invoice in iugu (Pix, boleto, or credit card); Get invoice details by ID; Cancel (delete) an invoice.

create_invoice · get_invoice · cancel_invoice · refund_invoice · duplicate_invoice

read & search

4 tools - e.g. List invoices with optional filters; List customers with optional filters; List subscription plans.

list_invoices · list_customers · list_plans · get_account_info

Subscription

4 tools - e.g. Create a recurring subscription in iugu; Suspend a subscription.; Reactivate a suspended subscription.

create_subscription · suspend_subscription · activate_subscription · cancel_subscription

create & write

3 tools - e.g. Create a marketplace sub-account.; Transfer funds between iugu accounts (marketplace).; Register a webhook (gatilho) for an iugu event.

create_subaccount · create_transfer · create_webhook

Customer

2 tools - e.g. Create a customer in iugu; Update a customer.

create_customer · update_customer

Plan

2 tools - e.g. Create a subscription plan (recurring template).; Update an existing plan.

create_plan · update_plan

Payment

2 tools - e.g. Tokenize a credit card server-side.; Attach a payment method (credit card token) to a customer.

create_payment_token · create_payment_method

Request

1 tool - e.g. Request a bank withdrawal (saque) from a sub-account.

request_withdraw

04 · Who maintains Iugu

mcp-iugu is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: finance - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-iugu (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-iugu

06 · Iugu FAQ

Is Iugu still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Iugu do?

With this server connected, an agent can create an invoice in iugu (Pix, boleto, or credit card), get invoice details by ID, list invoices with optional filters, and cancel (delete) an invoice.

How do I install Iugu?

Run `npx -y @codespar/mcp-iugu`. The README documents one environment variable (IUGU_API_TOKEN) to set first. You can also paste the ready-made client config above.

Does Iugu run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Iugu

Alternatives to Iugu

Maintained finance servers if Iugu isn't the fit.

Pairs well with

Servers that cover what Iugu doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Khipu · Mercado Pago · Nubank · Paypal · Rinne

More JavaScript MCP servers · Izipay · Kushki · Mercado Libre · see all