{"_id":"@codespar/mcp-vindi","_rev":"6-f6b9f44ac6c592a069818f4239057d53","name":"@codespar/mcp-vindi","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-vindi","version":"0.1.0","keywords":["mcp","vindi","payments","subscriptions","billing","brazil"],"license":"MIT","_id":"@codespar/mcp-vindi@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vindi":"dist/index.js"},"dist":{"shasum":"fd3af01bb4c4f46a099c622682cb3c702d79e6ba","tarball":"https://registry.npmjs.org/@codespar/mcp-vindi/-/mcp-vindi-0.1.0.tgz","fileCount":4,"integrity":"sha512-oZOpir0aF5mjFLwhwaGV4B2kpOZv+qS6sQcbh4tT4CkajUFjOrZ42zOhjoYEq7MUjlkWrDv8w3+5OzXMyYEing==","signatures":[{"sig":"MEUCIQCrqB+ogA1k+CauqALpgGUmgjHA+3KFSp+qBmbRGR3gJwIgVxB9+XdIn6XyEDYo9oibVRVIrtxJypuC3Rx2O2R4TK0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22154},"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 Vindi — recurring billing, subscriptions, invoices","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-vindi_0.1.0_1774923312492_0.5805156571841319","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-vindi","version":"0.1.2","keywords":["mcp","vindi","payments","subscriptions","billing","brazil"],"license":"MIT","_id":"@codespar/mcp-vindi@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vindi":"dist/index.js"},"dist":{"shasum":"a9397a2144a8e4dd70c44ee0396890a08556178a","tarball":"https://registry.npmjs.org/@codespar/mcp-vindi/-/mcp-vindi-0.1.2.tgz","fileCount":7,"integrity":"sha512-RkKqeYurIlxDHnNv71pGH1WEFQCw3hiv5YChThrbEeKr47bZeAAevRSjte4/jH2HOw4HL4dje1HyMEMLF+Tgqw==","signatures":[{"sig":"MEUCIDw/LUfjEW+u1NzsGQGzAkRpeBNButiz7Y38hoGVGawgAiEAwUzHu54ivV+oPlVBKlVD/Hd18w0Gn7uw5bTVS615PiM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32288},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-vindi","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Vindi — recurring billing, subscriptions, invoices","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-vindi_0.1.2_1775953806888_0.4496579747831939","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-vindi","version":"0.2.0","keywords":["mcp","vindi","payments","subscriptions","billing","brazil"],"license":"MIT","_id":"@codespar/mcp-vindi@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vindi":"dist/index.js"},"dist":{"shasum":"2d5685c25f8047733c9bb46aac66e0ba6cd7938e","tarball":"https://registry.npmjs.org/@codespar/mcp-vindi/-/mcp-vindi-0.2.0.tgz","fileCount":7,"integrity":"sha512-ocyTL5pow0jXP9dvYr0P9WeVS5e4uAlVDlIZZvqhE3LkrMXTEFh8q2O7hpqV2b0iIW+z8Mvxa3ctxulnSyHAow==","signatures":[{"sig":"MEUCIFa5NYymYXx6fURH0dvsHm8dO507cylQh6bCQaXlpzlUAiEAsttBf7ymM9uTbAlWZymgp9rFK05Ayo74YPMQnrfo53M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48676},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"206367773b96786003af53c16c38c7c3d6f823bd","mcpName":"io.github.codespar/mcp-vindi","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Vindi — recurring billing, subscriptions, invoices","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-vindi_0.2.0_1777069511781_0.9249291990108814","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-vindi","version":"0.2.1","keywords":["mcp","vindi","payments","subscriptions","billing","brazil"],"license":"MIT","_id":"@codespar/mcp-vindi@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vindi":"dist/index.js"},"dist":{"shasum":"6e7059805f9fb744d61d45c27845fdef54502151","tarball":"https://registry.npmjs.org/@codespar/mcp-vindi/-/mcp-vindi-0.2.1.tgz","fileCount":7,"integrity":"sha512-Bx3FvjYGKoKDXQfanE+arlGHZ3yG64klb7hVdMBv/caJGhznQu7i5Uo58cI3hMq9F8utf0JHndy9EEqKbUrk3Q==","signatures":[{"sig":"MEUCIGgwsZ9RQZuHmP8pbMOAWI634vl91ZJHcODz2hvzt7ZcAiEAllzr2lPMDTSFCD2a9qMcpasJbv/xbvJ/KkPHaWiLRx4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":49366},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-vindi","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Vindi — recurring billing, subscriptions, invoices","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-vindi_0.2.1_1777123284669_0.11600255629111555","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-vindi","version":"0.2.2","description":"MCP server for Vindi — recurring billing, subscriptions, invoices","type":"module","main":"./dist/index.js","bin":{"mcp-vindi":"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","vindi","payments","subscriptions","billing","brazil"],"mcpName":"io.github.codespar/mcp-vindi","_id":"@codespar/mcp-vindi@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-nJCooz9lzXvedvHwPgHsr/z2a0Esw79dvfp+anyOTvw9b/6g4ZsrNhRJvdhTZDgQ+WXRqH8cyrTXqijs5jtwbA==","shasum":"47b22ecd5f1f2835a37e300d5f7f7b598a9d36d7","tarball":"https://registry.npmjs.org/@codespar/mcp-vindi/-/mcp-vindi-0.2.2.tgz","fileCount":7,"unpackedSize":50639,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICxj9xMotB7RbDi2QF+9cd9XWsUFgbtuiizZT0WUL6VGAiA0nFog3d63U8yed2/BZNX+Q2sLnFntIouX2Hv97dS5Ag=="}]},"_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-vindi_0.2.2_1782153997524_0.6479744531423053"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:12.394Z","modified":"2026-06-22T18:46:37.774Z","0.1.0":"2026-03-31T02:15:12.682Z","0.1.2":"2026-04-12T00:30:07.043Z","0.2.0":"2026-04-24T22:25:11.932Z","0.2.1":"2026-04-25T13:21:24.823Z","0.2.2":"2026-06-22T18:46:37.657Z"},"license":"MIT","keywords":["mcp","vindi","payments","subscriptions","billing","brazil"],"description":"MCP server for Vindi — recurring billing, subscriptions, invoices","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-vindi\n\n> MCP server for **Vindi** — recurring billing, subscriptions, and payment plans\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-vindi)](https://www.npmjs.com/package/@codespar/mcp-vindi)\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    \"vindi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-vindi\"],\n      \"env\": {\n        \"VINDI_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add vindi -- npx @codespar/mcp-vindi\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"vindi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-vindi\"],\n      \"env\": {\n        \"VINDI_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n## Tools (20)\n\n| Tool | Purpose |\n|---|---|\n| `create_subscription` | Create a recurring subscription in Vindi |\n| `get_subscription` | Get subscription details by ID |\n| `list_subscriptions` | List subscriptions with optional filters |\n| `create_bill` | Create a bill (charge) in Vindi |\n| `get_bill` | Get bill details by ID |\n| `list_bills` | List bills with optional filters |\n| `create_customer` | Create a customer in Vindi |\n| `get_customer` | Get customer details by ID |\n| `create_plan` | Create a billing plan in Vindi |\n| `list_plans` | List available billing plans |\n| `update_customer` | Update a customer's details |\n| `create_product` | Create a product (catalog item that can be attached to plans or bills) |\n| `list_products` | List products in the catalog |\n| `cancel_subscription` | Cancel a subscription immediately |\n| `reactivate_subscription` | Reactivate a canceled subscription |\n| `cancel_bill` | Cancel a pending bill |\n| `charge_bill` | Retry charging a pending bill (runs the billing workflow) |\n| `refund_charge` | Refund a charge (full or partial). |\n| `create_payment_profile` | Create a payment profile (tokenized card / saved payment method) for a customer |\n| `list_payment_profiles` | List payment profiles, optionally filtered by customer |\n\n## Authentication\n\nVindi uses Basic Auth with the API key as username and empty password.\n\n## Sandbox / Testing\n\nVindi provides a sandbox via the dashboard. Use a sandbox API key for testing.\n\n### Get your credentials\n\n1. Go to [Vindi](https://app.vindi.com.br)\n2. Create an account\n3. Navigate to settings and generate your API key\n4. Set the `VINDI_API_KEY` environment variable\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `VINDI_API_KEY` | Yes | API key from Vindi dashboard |\n\n## Roadmap\n\n### v0.2 (planned)\n- `cancel_subscription` — Cancel an active subscription\n- `update_subscription` — Update subscription details\n- `list_payment_profiles` — List payment profiles for a customer\n- `create_discount` — Create a discount for a subscription\n- `get_charges` — Get charge details with filters\n\n### v0.3 (planned)\n- `batch_bills` — Create multiple bills in a single request\n- `financial_reports` — Generate financial summary reports\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- [Vindi Website](https://vindi.com.br)\n- [Vindi Documentation](https://atendimento.vindi.com.br/hc/pt-br)\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"}