{"_id":"@codespar/mcp-iugu","_rev":"6-e3c249bdb05ab7d0767c02d081f66f76","name":"@codespar/mcp-iugu","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-iugu","version":"0.1.0","keywords":["mcp","iugu","payments","invoices","subscriptions","brazil"],"license":"MIT","_id":"@codespar/mcp-iugu@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-iugu":"dist/index.js"},"dist":{"shasum":"3d75a502b75bfec036f1661794da08516dcdb4b8","tarball":"https://registry.npmjs.org/@codespar/mcp-iugu/-/mcp-iugu-0.1.0.tgz","fileCount":4,"integrity":"sha512-+pb5cy6y7BEDezR/YTN9igV7g9zGfyb1QkGJaVrhpdwwnbSLBL8woHXvws2nQwn04NZbpbv5pkIhOuu2KaTGzA==","signatures":[{"sig":"MEUCIE3cVe276ELMzPa+VfiLaYCHiERv6y2k8YrqsfYLZtIfAiEAwstbrC7GUHSNTRJc/iJyMqqtwdcJ8RQqk+sKUGXrxyE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21889},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ac49d04d5aa50ad5dc16233f0bba88213f917641","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for iugu — invoices, subscriptions, customers, payment methods","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-iugu_0.1.0_1774923301001_0.9590419023616712","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-iugu","version":"0.1.2","keywords":["mcp","iugu","payments","invoices","subscriptions","brazil"],"license":"MIT","_id":"@codespar/mcp-iugu@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-iugu":"dist/index.js"},"dist":{"shasum":"b3cfc47f09d5bc0cb4018ee3a127f68ecb0e09ed","tarball":"https://registry.npmjs.org/@codespar/mcp-iugu/-/mcp-iugu-0.1.2.tgz","fileCount":7,"integrity":"sha512-M3vi1EqMeyAASIPd0VMlfa3BctMZvDMcKf9TFJBBJ+8KRjLpLWBNhe+7aW9Yxq1odMBRcOVbyS0/Dz7TKxkFzQ==","signatures":[{"sig":"MEUCIAefbaRD231pdVi++TglkvIr4G7rd0ILXQg4hB+t1N5/AiEAjzaTi8HjmGLE5eelbXt/txbxtDB95mCY4ZBBZJhP+HI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32106},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-iugu","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for iugu — invoices, subscriptions, customers, payment methods","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-iugu_0.1.2_1775953781495_0.20929033925798302","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-iugu","version":"0.2.0","keywords":["mcp","iugu","payments","invoices","subscriptions","brazil"],"license":"MIT","_id":"@codespar/mcp-iugu@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-iugu":"dist/index.js"},"dist":{"shasum":"3e75ba073d75cbf0988eeab471407db2b37251a6","tarball":"https://registry.npmjs.org/@codespar/mcp-iugu/-/mcp-iugu-0.2.0.tgz","fileCount":7,"integrity":"sha512-LK4V+LijVpPDrMC+MRYRJi560FSY0gGrh4mqGvbkJQu0fwc90tRqfhdLLiKHuHu5qYe/2hjmGWkawUIDo9Co9A==","signatures":[{"sig":"MEQCIAGxL2lmdNEK2PfOcEPhCohOPIIcLrHFqBVkUO9gAohYAiBarMl1zBnowPKsaUxo0xXnBbjJow1AqAkEFbHQ24MHRA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64959},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"bcd94c331d54cfed9e5380cc2d0d8aaee4d0c815","mcpName":"io.github.codespar/mcp-iugu","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for iugu — invoices, subscriptions, plans, customers, payment methods, marketplace sub-accounts, transfers, webhooks","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-iugu_0.2.0_1777038501245_0.048737335776855684","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-iugu","version":"0.2.1","keywords":["mcp","iugu","payments","invoices","subscriptions","brazil"],"license":"MIT","_id":"@codespar/mcp-iugu@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-iugu":"dist/index.js"},"dist":{"shasum":"c6a1b0a3f9e7dd44450be254c8c5d5e279526d19","tarball":"https://registry.npmjs.org/@codespar/mcp-iugu/-/mcp-iugu-0.2.1.tgz","fileCount":7,"integrity":"sha512-yUjXzqM8ZFHGTKNNTBdoyEkeIQg5nm040HJZKLgR/iu9gnE3j/q9mZTZSocKGDQaS0ipjWXFLEN6WR95/leQSw==","signatures":[{"sig":"MEYCIQDXTqN8S/bf1JEOhdkzK3im/xFLFONaBoLOXIvO7pUJ9gIhAOu3XPfbO90kzTTelmkfm5gJFZckO8AN6JIN5NQkiWco","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64584},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-iugu","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for iugu — invoices, subscriptions, plans, customers, payment methods, marketplace sub-accounts, transfers, webhooks","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-iugu_0.2.1_1777123205551_0.06797258622997782","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-iugu","version":"0.2.2","description":"MCP server for iugu — invoices, subscriptions, plans, customers, payment methods, marketplace sub-accounts, transfers, webhooks","type":"module","main":"./dist/index.js","bin":{"mcp-iugu":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","iugu","payments","invoices","subscriptions","brazil"],"mcpName":"io.github.codespar/mcp-iugu","_id":"@codespar/mcp-iugu@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-U4e/V3GspQWBqXV9PeP2icb2XThVpbsji5/dRQNzTQqbeqs0gmnfq/14iJ+eroSeSDD+1TC/ACUNuOEhgFjd8A==","shasum":"f7ab7cdc46cbf7fe6498ed1abae7c7740bc74d8d","tarball":"https://registry.npmjs.org/@codespar/mcp-iugu/-/mcp-iugu-0.2.2.tgz","fileCount":7,"unpackedSize":65834,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAF7iXPn9CI9E5Ymee4uSHyZlGz9do6/9ufe/PloIRNtAiEAzUZN+q4IQwV+R4xFAXnv1/s2naQvNLkNP43OEuvo5rA="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-iugu_0.2.2_1782153854432_0.4782674476069608"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:00.861Z","modified":"2026-06-22T18:44:14.720Z","0.1.0":"2026-03-31T02:15:01.163Z","0.1.2":"2026-04-12T00:29:41.642Z","0.2.0":"2026-04-24T13:48:21.380Z","0.2.1":"2026-04-25T13:20:05.733Z","0.2.2":"2026-06-22T18:44:14.598Z"},"license":"MIT","keywords":["mcp","iugu","payments","invoices","subscriptions","brazil"],"description":"MCP server for iugu — invoices, subscriptions, plans, customers, payment methods, marketplace sub-accounts, transfers, webhooks","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-iugu\n\n> MCP server for **iugu** — invoices, subscriptions, and payment management\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-iugu)](https://www.npmjs.com/package/@codespar/mcp-iugu)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"iugu\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-iugu\"],\n      \"env\": {\n        \"IUGU_API_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add iugu -- npx @codespar/mcp-iugu\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"iugu\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-iugu\"],\n      \"env\": {\n        \"IUGU_API_TOKEN\": \"your-token\"\n      }\n    }\n  }\n}\n```\n\n## Tools (23)\n\n| Tool | Purpose |\n|---|---|\n| `create_invoice` | Create an invoice in iugu (Pix, boleto, or credit card) |\n| `get_invoice` | Get invoice details by ID |\n| `list_invoices` | List invoices with optional filters |\n| `cancel_invoice` | Cancel (delete) an invoice. |\n| `refund_invoice` | Refund a paid invoice (full or partial). |\n| `duplicate_invoice` | Duplicate an existing invoice with a new due date. |\n| `create_customer` | Create a customer in iugu |\n| `update_customer` | Update a customer. |\n| `list_customers` | List customers with optional filters |\n| `create_plan` | Create a subscription plan (recurring template). |\n| `update_plan` | Update an existing plan. |\n| `list_plans` | List subscription plans. |\n| `create_subscription` | Create a recurring subscription in iugu |\n| `suspend_subscription` | Suspend a subscription. |\n| `activate_subscription` | Reactivate a suspended subscription. |\n| `cancel_subscription` | Cancel (delete) a subscription. |\n| `create_payment_token` | Tokenize a credit card server-side. |\n| `create_payment_method` | Attach a payment method (credit card token) to a customer. |\n| `create_subaccount` | Create a marketplace sub-account. |\n| `create_transfer` | Transfer funds between iugu accounts (marketplace). |\n| `request_withdraw` | Request a bank withdrawal (saque) from a sub-account. |\n| `create_webhook` | Register a webhook (gatilho) for an iugu event. |\n| `get_account_info` | Get account information, configuration, and balance |\n\n## Authentication\n\niugu uses Basic Auth with the API token as username and an empty password.\n\n## Sandbox / Testing\n\niugu provides test mode via the dashboard. Use a test-mode API token to avoid real charges.\n\n### Get your credentials\n\n1. Go to [iugu Developer Portal](https://dev.iugu.com)\n2. Create an account and access the dashboard\n3. Toggle to test mode and generate an API token\n4. Set the `IUGU_API_TOKEN` environment variable\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `IUGU_API_TOKEN` | Yes | API token from iugu dashboard |\n| `IUGU_SANDBOX` | No | Set to `\"true\"` for test mode |\n\n## Roadmap\n\n### v0.3 (planned)\n- `create_split` — Create split payment rules\n- `list_transfers` — List marketplace transfers\n- `get_financial_report` — Financial summary report\n- `batch_invoices` — Create multiple invoices in a single request\n- `list_payment_methods` — List saved payment methods for a customer\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [iugu Website](https://iugu.com)\n- [iugu API Documentation](https://dev.iugu.com)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}