Integration

iugu integration

Billing on the Brazilian platform iugu: raise invoices payable by bank slip, card or Pix and read their barcode and Pix payload, cancel, refund or capture them, keep a customer base with saved payment methods, define plans and run subscriptions against them, and list the transfers moving money between iugu accounts. Every amount is an integer in cents, list calls answer with an items array plus totalItems, and paging is done with limit and start.

Connect iugu How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in iugu.Built from the 19 iugu tools below, on the connection you add once.

Common iugu use cases

listing the subscribers of a plan
polling an invoice until it is paid
showing a customer their saved cards
billing a customer for a one off sale
removing a customer record on request
starting a monthly plan for a customer
reconciling the invoices paid in a period
saving a card so a subscription can bill it
refunding a customer after a cancelled order
checking which card is the default for a customer

What you can do with iugu

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Customer, 5 operations

create_customerCreate customerPOSTRegisters a customer and returns the identifier every other call needs.
delete_customerDelete customerDELETEDeletes a customer and returns the record as it was before removal.
get_customerGet customerGETReturns a single customer record.
list_customersList customersGETReturns a page of customers under items together with the total count.
update_customerUpdate customerPUTChanges the stored details of a customer or switches its default card.

Invoice, 5 operations

cancel_invoiceCancel invoicePUTMarks an invoice as cancelled so it can no longer be settled.
create_invoiceCreate invoicePOSTRaises an invoice and returns the hosted payment page plus the bank slip and Pix payloads.
get_invoiceGet invoiceGETReturns a single invoice and whether it has been paid.
list_invoicesList invoicesGETReturns a page of invoices under items together with the total count.
refund_invoiceRefund invoicePOSTSends money back to the payer and returns the invoice with the refunded amount.

Subscription, 4 operations

create_subscriptionCreate subscriptionPOSTStarts a recurring plan for a customer and returns the subscription with its recent invoices.
get_subscriptionGet subscriptionGETReturns a single recurring plan and the invoices it has generated lately.
list_subscriptionsList subscriptionsGETReturns a page of subscriptions under items together with the total count.
suspend_subscriptionSuspend subscriptionPOSTPauses a recurring plan and returns it with suspended set to true.

Payment method, 2 operations

create_payment_methodCreate payment methodPOSTAttaches a tokenized card to a customer and returns its masked detail.
list_payment_methodsList payment methodsGETReturns the stored cards of one customer with their brand and masked digits.

Plan, 2 operations

create_planCreate planPOSTDefines a recurring price and interval that subscriptions can be attached to.
list_plansList plansGETReturns a page of plans with their price, interval and features.

Transfer, 1 operation

list_transfersList transfersGETReturns the money moved between iugu accounts in two arrays, one outgoing and one incoming.

Use iugu from Claude Code, Cursor or Codex

Connect iugu in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its iugu operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect iugu

Create your workspace
Sign up free. Nothing to install.
Connect iugu once
Add your iugu connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

iugu integration FAQ

What can you do with the iugu integration?

LiveContext exposes 19 operations on iugu, covering customer, invoice, subscription and payment method. Common uses include listing the subscribers of a plan, polling an invoice until it is paid and showing a customer their saved cards.