Mcp Vindi

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for Vindi — recurring billing, subscriptions, invoices

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server for Vindi recurring billing that lets an assistant create and manage subscriptions, bills, charges, refunds, customers, plans and payment profiles.

What you can do
  • Create, list and fetch subscriptions, and cancel or reactivate them
  • Create, list and fetch bills, cancel pending bills, retry charges and issue full or partial refunds
  • Create, fetch and update customers
  • Create and list billing plans and catalog products
  • Create and list tokenized payment profiles for customers
When to use it
Useful when you manage Vindi subscriptions and billing from an assistant, for example to look up a customer's subscriptions, create a plan or bill, or handle cancellations and refunds without switching to the Vindi dashboard.
Requirements
Runs locally via npx from the npm package @codespar/mcp-vindi (Node.js needed). Requires a Vindi account and an API key supplied in the VINDI_API_KEY environment variable; the key is used as the Basic Auth username. A sandbox API key is available for testing.
Before you install
The API key in VINDI_API_KEY grants access to a live billing account and can move real money. Tools create bills and charges, retry charging, refund charges, cancel subscriptions and bills, and store tokenized payment profiles, so mistakes have financial and customer-facing effects. Test with a sandbox key first.

Installation

In SourceWeft

  1. Open Mcp Vindi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-vindi

MCP server for Vindi — recurring billing, subscriptions, and payment plans

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "vindi": {      "command": "npx",      "args": ["-y", "@codespar/mcp-vindi"],      "env": {        "VINDI_API_KEY": "your-key"      }    }  }}

Claude Code

bash
claude mcp add vindi -- npx @codespar/mcp-vindi

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "vindi": {      "command": "npx",      "args": ["-y", "@codespar/mcp-vindi"],      "env": {        "VINDI_API_KEY": "your-key"      }    }  }}

Tools (20)

ToolPurpose
create_subscriptionCreate a recurring subscription in Vindi
get_subscriptionGet subscription details by ID
list_subscriptionsList subscriptions with optional filters
create_billCreate a bill (charge) in Vindi
get_billGet bill details by ID
list_billsList bills with optional filters
create_customerCreate a customer in Vindi
get_customerGet customer details by ID
create_planCreate a billing plan in Vindi
list_plansList available billing plans
update_customerUpdate a customer's details
create_productCreate a product (catalog item that can be attached to plans or bills)
list_productsList products in the catalog
cancel_subscriptionCancel a subscription immediately
reactivate_subscriptionReactivate a canceled subscription
cancel_billCancel a pending bill
charge_billRetry charging a pending bill (runs the billing workflow)
refund_chargeRefund a charge (full or partial).
create_payment_profileCreate a payment profile (tokenized card / saved payment method) for a customer
list_payment_profilesList payment profiles, optionally filtered by customer

Authentication

Vindi uses Basic Auth with the API key as username and empty password.

Sandbox / Testing

Vindi provides a sandbox via the dashboard. Use a sandbox API key for testing.

Get your credentials

  1. Go to Vindi
  2. Create an account
  3. Navigate to settings and generate your API key
  4. Set the VINDI_API_KEY environment variable

Environment Variables

VariableRequiredDescription
VINDI_API_KEYYesAPI key from Vindi dashboard

Roadmap

v0.2 (planned)

  • cancel_subscription — Cancel an active subscription
  • update_subscription — Update subscription details
  • list_payment_profiles — List payment profiles for a customer
  • create_discount — Create a discount for a subscription
  • get_charges — Get charge details with filters

v0.3 (planned)

  • batch_bills — Create multiple bills in a single request
  • financial_reports — Generate financial summary reports

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/payments/vindi/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts