Iugu

v0.2.0API Key

Subscription billing with Pix, boleto, and credit card. Your agent creates invoices, manages customers, and handles recurring charges.

23 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-iugu

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "iugu": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-iugu"
      ],
      "env": {
        "IUGU_API_TOKEN": "<your_iugu_api_token>"
      }
    }
  }
}

After restart, your agent can call any of the 23 tools below — try create_invoice first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

IUGU_API_TOKEN

requiredsecret

API key for iugu

Available tools · 23

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_invoice

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

READget_invoice

Get invoice details by ID

READlist_invoices

List invoices with optional filters

DELETEcancel_invoice

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

DELETErefund_invoice

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

READduplicate_invoice

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

WRITEcreate_customer

Create a customer in iugu

WRITEupdate_customer

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

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.