Local MCP proxy that gives AI assistants (Claude, Cursor, Copilot) secure, role-based access to your Stripe billing through your Billy container API.
Agent Billy is an MCP project maintained in the agent-billy/mcp repository. The maintainer describes its purpose as “Local MCP proxy that gives AI assistants (Claude, Cursor, Copilot) secure, role-based access to your Stripe billing through your Billy container API”. Read the project documentation for the complete scope.
The documented npm package is agent-billy. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares BILLY_API_URL, BILLY_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| billy_list_charges | List recent charges. Filter by status (succeeded, failed, pending). |
| billy_get_charge | Get details for a specific charge by Stripe charge ID. |
| billy_list_customers | List customers with pagination. |
| billy_get_customer | Get details for a specific customer by Stripe customer ID. |
| billy_list_subscriptions | List subscriptions. Filter by status (active, past_due, canceled, trialing). |
| billy_list_invoices | List invoices. Filter by status (draft, open, paid, void, uncollectible). |
| billy_list_refunds | List all refunds that have been issued. |
| billy_get_stats | Dashboard snapshot: MTD revenue, success rate, active subs, failed charges. |
| billy_search | Search across customers, charges, subscriptions, and invoices by keyword. |
| billy_create_refund | Issue a full or partial refund for a charge. |
| billy_create_customer | Create a new Stripe customer. |
| billy_update_customer | Update a customer's email, name, description, or metadata. |
| billy_cancel_subscription | Cancel a subscription (at period end or immediately). |
| billy_reactivate_subscription | Reactivate a canceled subscription that hasn't fully expired. |
| billy_send_invoice | Send an invoice to the customer via email. |
| billy_void_invoice | Void an invoice so it can no longer be paid. |
| billy_create_coupon | Create a discount coupon (percentage or fixed amount). |
| billy_delete_coupon | Delete a coupon so it can't be applied to new customers. |
{
"mcpServers": {
"agent-billy": {
"command": "npx",
"args": [
"-y",
"agent-billy"
],
"env": {
"BILLY_API_URL": "https://yourorg.agentbilly.ai",
"BILLY_API_KEY": "YOUR_BILLY_API_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| BILLY_API_URL | Declared in the maintainer’s client configuration. | Check documentation |
| BILLY_API_KEY | Declared in the maintainer’s client configuration. | Check documentation |
Access Stripe billing and payment tools through its MCP server. Connect with OAuth or a supported agent API key and choose the intended account.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Global B2B trade: verified manufacturers, product search, sanctions screening, HS codes.
MCP discovery and x402 checkout handoff for five paid Batcave agent products.
Data marketplace for AI agents: quality-scored datasets, compliance checks, x402 USDC payments.
Official AI-native print-on-demand MCP — say it, AI designs it, sell 40+ goods, earn royalties.