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.

LiveContext

All integrations

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.

19 toolsBasic authAPI docs

Connect iugu How integrations work

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

POSTcreate_customer
Registers a customer and returns the identifier every other call needs.
DELETEdelete_customer
Deletes a customer and returns the record as it was before removal.
GETget_customer
Returns a single customer record.
GETlist_customers
Returns a page of customers under items together with the total count.
PUTupdate_customer
Changes the stored details of a customer or switches its default card.

Invoice, 5 operations

PUTcancel_invoice
Marks an invoice as cancelled so it can no longer be settled.
POSTcreate_invoice
Raises an invoice and returns the hosted payment page plus the bank slip and Pix payloads.
GETget_invoice
Returns a single invoice and whether it has been paid.
GETlist_invoices
Returns a page of invoices under items together with the total count.
POSTrefund_invoice
Sends money back to the payer and returns the invoice with the refunded amount.

Subscription, 4 operations

POSTcreate_subscription
Starts a recurring plan for a customer and returns the subscription with its recent invoices.
GETget_subscription
Returns a single recurring plan and the invoices it has generated lately.
GETlist_subscriptions
Returns a page of subscriptions under items together with the total count.
POSTsuspend_subscription
Pauses a recurring plan and returns it with suspended set to true.

Payment method, 2 operations

POSTcreate_payment_method
Attaches a tokenized card to a customer and returns its masked detail.
GETlist_payment_methods
Returns the stored cards of one customer with their brand and masked digits.

Plan, 2 operations

POSTcreate_plan
Defines a recurring price and interval that subscriptions can be attached to.
GETlist_plans
Returns a page of plans with their price, interval and features.

Transfer, 1 operation

GETlist_transfers
Returns 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.