MCP.Market

Iugu MCP server

by codespar·io.github.codespar/mcp-iugu·v0.2.2·271 stars
No reviews yet

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

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

271 stars

Reviews

Write one

Nobody has reviewed Iugu yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Iugu tools (23, 14 write)

write = sends, deletes, buys or posts

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

  • activate_subscription

    Reactivate a suspended subscription. Endpoint: POST /subscriptions/:id/activate

  • cancel_invoicewrite action

    Cancel (delete) an invoice. Endpoint: DELETE /invoices/:id

  • cancel_subscriptionwrite action

    Cancel (delete) a subscription. Endpoint: DELETE /subscriptions/:id

  • create_customerwrite action

    Create a customer in iugu

  • create_invoicewrite action

    Create an invoice in iugu (Pix, boleto, or credit card)

  • create_payment_methodwrite action

    Attach a payment method (credit card token) to a customer. Endpoint: POST /customers/:customer_id/payment_methods

  • create_payment_tokenwrite action

    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.

  • create_planwrite action

    Create a subscription plan (recurring template). Endpoint: POST /plans

  • create_subaccountwrite action

    Create a marketplace sub-account. Endpoint: POST /marketplace/create_account. Note: only works in production mode. Returns live/test API tokens and user_token.

  • create_subscriptionwrite action

    Create a recurring subscription in iugu

  • create_transferwrite action

    Transfer funds between iugu accounts (marketplace). Endpoint: POST /transfers

  • create_webhookwrite action

    Register a webhook (gatilho) for an iugu event. Endpoint: POST /web_hooks

  • duplicate_invoice

    Duplicate an existing invoice with a new due date. Endpoint: POST /invoices/:id/duplicate

  • get_account_info

    Get account information, configuration, and balance

  • get_invoice

    Get invoice details by ID

  • list_customers

    List customers with optional filters

  • list_invoices

    List invoices with optional filters

  • list_plans

    List subscription plans. Endpoint: GET /plans

  • refund_invoicewrite action

    Refund a paid invoice (full or partial). Endpoint: POST /invoices/:id/refund

  • request_withdraw

    Request a bank withdrawal (saque) from a sub-account. Endpoint: POST /accounts/:id/request_withdraw

  • suspend_subscription

    Suspend a subscription. Endpoint: POST /subscriptions/:id/suspend

  • update_customerwrite action

    Update a customer. Endpoint: PUT /customers/:id. Omitted fields are unchanged.

  • update_planwrite action

    Update an existing plan. Endpoint: PUT /plans/:id

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • 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
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Iugu compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 73% of 1,761 Finance servers
Tools
23
the typical Finance server has 8
Tools that change things
61%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
271
more than 95% of 946 Finance servers

What its tools let an agent do: 9 read · 9 create · 3 change · 2 delete

Install Iugu in Claude Code, Cursor or VS Code

Runs npx -y @codespar/mcp-iugu on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-iugu -- npx -y @codespar/mcp-iugu
Add to Cursor

What the publisher says

From the Iugu repository's README, as published. We do not edit it. Read it on GitHub

MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.

Agentic Payment Protocols

Four servers for the emerging agentic payment stack:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Iugu: common questions

Is Iugu MCP server safe?
Mostly: it is graded B (82/100). Read the Iugu safety report
How do I install Iugu?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Iugu need an API key?
Yes. The registry entry asks for IUGU_API_TOKEN.
Is Iugu maintained?
The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.
What can I use instead of Iugu?
Servers from other publishers that do the same job: Xero MCP server, three.ws Tutor MCP server and Yolfi Payments MCP server.
How does Iugu compare with other Finance MCP servers?
safety score 82/100 (higher than 73% of 1,761 Finance servers); tools 23 (the typical Finance server has 8); tools that change things 61% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Iugu

Same job from other publishers: the closest match first, then the best rated.

  • Xero
    Xero MCP server for invoices, contacts, payments, quotes, and financial reports.
    More from mindstone →
    A
  • three.ws Tutor
    Read a Pay-As-You-Learn tutoring session's itemized tab and close it for an attested invoice.
    More from nirholas →
    A
  • Yolfi Payments MCP
    Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.
    A
  • X402 List
    Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.
    A
  • SatGate – Economic Firewall for AI Agents
    Budget, payment and audit controls for AI agent API calls and MCP tool calls.
    A

More from codespar →