How to Use the Invoiced MCP in Cursor

Q: How do I configure the Invoiced connection in Cursor?

Add the server settings to your global /.cursor/mcp.json file or create a project-specific configuration in .cursor/mcp.json. Once saved, enable Agent mode in your chat panel to start querying billing records.

Q: How does the Invoiced MCP Server help me write test cases in Cursor?

Your agent pulls real payloads using getinvoice and uses that structure to generate mock data. This ensures your unit tests reflect actual API responses instead of guessed structures.

Inject live Invoiced customer metrics and payment records directly into your Cursor editor to build billing features with real data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Invoiced MCP to Cursor

Create your Vinkius account to connect Invoiced to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Invoiced with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate Code with Live Invoiced Context in Cursor

Generating code against actual billing endpoints uses `list_items` and `list_plans` to feed live schemas into Cursor. This Invoiced MCP Server lets Cursor inspect your active billing catalog and plan structures to write accurate integration code. Your Cursor agent reads active schemas directly from your Invoiced account, so the code it writes matches your actual production setup. You get working endpoints and precise data models without running manual curl requests.

Verify Customer Balances and Active Subscriptions

Debugging subscription states relies on `get_customer` and `list_subscriptions` to pull live Invoiced account data directly into your Cursor chat. Cursor uses these endpoints to pull live accounts directly into your active composer window. This setup lets you check if a specific Invoiced customer has an active contract before committing code changes in Cursor. You see the exact JSON response, helping you handle edge cases for cancelled or past-due accounts.

Audit Invoice Lifecycles and Tax Rates

Analyzing how active promotions alter invoice totals uses `list_tax_rates` and `list_coupons` inside Cursor. Cursor fetches these rules directly, allowing your agent to analyze how active promotions alter invoice totals. By using `get_invoice` alongside these tools, you can trace exactly why an Invoiced bill settled at a specific amount directly inside your editor. The raw data lands in your Cursor editor, making billing disputes easy to diagnose.

Setup guide

Set up Invoiced MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Invoiced MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Invoiced transactions." If the MCP tools are loaded correctly, Cursor will call the Invoiced tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "invoiced-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Invoiced. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Invoiced now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Invoiced MCP in Cursor

Add the server settings to your global `~/.cursor/mcp.json` file or create a project-specific configuration in `.cursor/mcp.json`. Once saved, enable Agent mode in your chat panel to start querying billing records.

No, this integration is strictly read-only. You can fetch account details via `get_customer` or list clients using `list_customers`, but you cannot write or edit data through this tool.

You can run it either as a local command-line tool or connect via a remote URL. The editor communicates with the API to fetch your billing records securely based on your configuration.

Your agent pulls real payloads using `get_invoice` and uses that structure to generate mock data. This ensures your unit tests reflect actual API responses instead of guessed structures.

Your credentials reside in your local configuration files and are never sent to external servers. Cursor accesses the API through encrypted local processes, keeping your raw financial data isolated from external eyes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript