# Invoice by Ouroboros Apps

> Invoice by Ouroboros Apps is an MCP server for finance and payments. Holds a freelancer's sealed invoice so an assistant cannot quietly change it. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, self-hosted
- **Website:** https://ouroborosapps.com/docs/invoice
- **Repository:** https://github.com/lahutchins91/invoice-mcp
- **MCP Registry name:** io.github.LAHutchins91/invoice
- **Categories:** finance and payments
- **Listing updated:** 2026-11-16

## About

The design goal here is restraint. Once a freelancer seals an invoice, the assistant can read it and quote it, but a new line, a different rate, a discount or a moved due date is refused until the change is suggested and then explicitly accepted. Draft figures carry no weight until the seal step, and read_invoice is meant to be called before the assistant answers anything.

Amounts are stored in whole minor units of the invoice currency, with units of hour, each or day for line items, and late terms can be a flat fee or a percentage per period after a grace period. Sealing and accepting changes both take a confirmed flag that should only be passed after the freelancer approves.

It is in early access. Claude, Cursor, Grok and ChatGPT developer mode connect by URL with OAuth sign-in, and the README also covers self-hosting with a JSON file store.

## Features

- **Sealed invoices:** seal_invoice locks lines, quantities, rates, due date, late terms and discount after explicit approval.
- **Suggest then accept:** Changes to a sealed invoice go through suggest_invoice_change and accept_invoice_change.
- **Late terms:** Record grace days with no fee, a flat fee or a percentage per period.
- **Minor-unit amounts:** Rates and fees are whole minor units of the invoice currency.
- **OAuth sign-in:** Clients register dynamically; no API key or password goes in a header.
- **Self-hostable:** Run the server yourself and keep records in a local JSON file.

## Good for

- Have an assistant answer a client's question about an approved invoice without inventing figures
- Draft an invoice line by line in chat and seal it when happy
- Propose a rate change on a sealed invoice and approve it explicitly
- Record late-payment terms alongside the invoice

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http invoice https://invoice-continuity2.vercel.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://invoice-continuity2.vercel.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "invoice": {
      "url": "https://invoice-continuity2.vercel.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "invoice": {
      "type": "http",
      "url": "https://invoice-continuity2.vercel.app/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "invoice": {
      "serverUrl": "https://invoice-continuity2.vercel.app/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "invoice": {
      "type": "http",
      "url": "https://invoice-continuity2.vercel.app/mcp"
    }
  }
}
```

## Tools

- `list_invoices`: List the signed-in freelancer's invoices.
- `begin_invoice`: Start a draft invoice.
- `read_invoice`: Read the invoice before answering.
- `place_line`: Add one line with description, quantity, rate and unit.
- `describe_line`: Correct a line description while the invoice is a draft.
- `quote_line_rate`: Set the rate for one line.
- `set_line_quantity`: Set the quantity on one line.
- `set_invoice_due`: Set the due date.
- `write_late_terms`: Record grace days and late fee basis.
- `offer_discount`: Record a discount on the invoice.
- `seal_invoice`: Mark the draft as the approved invoice.
- `suggest_invoice_change`: Record a suggested change without applying it.
- `accept_invoice_change`: Apply one suggested change after explicit approval.

## FAQ

### Can the assistant change a sealed invoice?

Not directly. It can record a suggestion, and the change applies only when the freelancer accepts it.

### Is there a trial?

The README says tools need Pro or an active trial, and a new subscription includes a 14-day trial; price is shown at checkout.

### Which clients work?

Claude, Cursor, Grok and ChatGPT developer mode, plus any client supporting Streamable HTTP and OAuth.

### Where is data stored when self-hosting?

In a JSON file, by default under ~/.invoice/invoice.json, configurable with INVOICE_DATA_PATH.

### Is Invoice by Ouroboros Apps free?

Invoice by Ouroboros Apps is a paid product with a free trial.

### How do I add Invoice by Ouroboros Apps to Claude Code?

Run this command in your terminal: claude mcp add --transport http invoice https://invoice-continuity2.vercel.app/mcp

### What are the best alternatives to Invoice by Ouroboros Apps?

The closest alternatives to Invoice by Ouroboros Apps are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/invoice-by-ouroboros-apps
