Invoice by Ouroboros Apps
Integrates with Stripe for subscription billing, using Stripe secret key, webhook secret, and monthly/yearly price IDs to manage subscriptions and gate tool access based on active or trialing status.
Integrates with Supabase as an OAuth authorization server with dynamic client registration, using the configured Supabase URL and anon key to authenticate users and manage session tokens.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Invoice
Invoice keeps a freelancer's approved invoice — line items, quantities, the rate already approved, the due date, and late terms — then lets an assistant read that record before it answers. An assistant cannot add a line, change a rate, invent a discount, or move a due date unless that change is explicitly approved.
It works with ChatGPT, Claude, Gemini, Grok, and Cursor, plus any other MCP client that can do Streamable HTTP and OAuth. It is not a ChatGPT-only plugin.
Sign in with your Invoice account when the assistant opens OAuth. Do not paste an API key or password into a header. Invoice supports dynamic client registration: leave the client id and secret empty. The protected-resource metadata at /.well-known/oauth-protected-resource/mcp points clients at the OAuth issuer, which registers them.
Invoice tools need Pro or an active trial. A new subscription includes a 14-day trial. This page does not list a price. Checkout shows the billing interval and payment terms. Amounts stored on an invoice are the freelancer's approved figures, in whole minor units of the invoice currency. They are not a product price.
To self-host, run the server and use the base URL you configure. The default MCP address is http://127.0.0.1:3000/mcp.
Hosted server
MCP server URL:
https://invoice-continuity2.vercel.app/mcp(Streamable HTTP, OAuth sign-in)Status: early access. Paste the URL into Claude, Cursor, Grok, or ChatGPT developer mode.
Registry name:
io.github.LAHutchins91/invoice
Related MCP server: Deposit by Ouroboros Apps
What the assistant can do
After you approve the connection, the server exposes these tools:
list_invoices
begin_invoice
read_invoice
place_line
describe_line
quote_line_rate
set_line_quantity
set_invoice_due
write_late_terms
offer_discount
seal_invoice
suggest_invoice_change
accept_invoice_change
read_invoice is the read the assistant should do before it answers. Draft figures are not an approved commitment. A suggested invoice change does not change the record. After the invoice is sealed, place_line refuses a new line, quote_line_rate refuses a changed rate, offer_discount refuses a discount, and set_invoice_due refuses a moved due date. Those changes go through suggest_invoice_change and then accept_invoice_change, and only when you explicitly approve that change.
The assistant only calls these tools when you and the host allow it.
Connect
Cursor, in ~/.cursor/mcp.json or a project .cursor/mcp.json:
{
"mcpServers": {
"invoice": {
"url": "http://127.0.0.1:3000/mcp"
}
}
}Do not add a headers block. Cursor registers a client and opens sign-in.
Claude Code:
claude mcp add --transport http invoice http://127.0.0.1:3000/mcpDo not pass an Authorization header. Other clients use the same address, choose OAuth, and leave client id and secret empty. Steps for ChatGPT, Claude, Gemini, Grok, and Cursor are on the connect page at /connect.
Registry metadata for this server is in server.json (io.github.LAHutchins91/invoice). The remote URL there is https://invoice-continuity2.vercel.app/mcp.
Run
npm install
npm test
npm run typecheck
npm run build
npm startWhen stdin is a terminal, Invoice serves Streamable HTTP on port 3000. When stdin is not a terminal, it speaks MCP over stdio and still opens the HTTP port. Logs during stdio mode go to stderr so they do not mix with the protocol.
Records are stored durably in a JSON file. The default path is ~/.invoice/invoice.json. Set INVOICE_DATA_PATH to move it. One server process owns that file. Do not point it at another product's data file.
OAuth uses the same idea as a Supabase authorization server with dynamic client registration. Set these on the server process, not in an MCP header:
APP_BASE_URL(defaulthttp://localhost:3000)SUPABASE_URLSUPABASE_ANON_KEYSTRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRETSTRIPE_PRICE_MONTHLYandSTRIPE_PRICE_YEARLY(Stripe catalog ids, not prices)OPENAI_APPS_CHALLENGE(optional; when set,/.well-known/openai-apps-challengereturns that token as plain text)
Tool calls other than discovery require a signed-in account whose subscription status is active or trialing.
More from Ouroboros: https://ouroborosapps.com
Available Tools
13 toolsaccept_invoice_changeaccept invoice changeADestructiveIdempotentInspect
Apply one suggested invoice change after the freelancer explicitly approves that change. Pass confirmed true only then. This is the path that may add a line, change a rate, apply a discount, or move the due date. Calling it is not a substitute for the freelancer's approval.
Inputs: changeId (required), confirmed (required), invoiceId (required). Returns: data
begin_invoicebegin invoiceAInspect
Start a draft invoice. Draft figures are not an approved commitment until seal_invoice. Currency is a three-letter code. Amounts later are minor units of that currency and are the freelancer's figures.
Inputs: title (required), number (required), currency (required), clientName (required). Returns: data
describe_linedescribe lineADestructiveInspect
Correct a line description while the invoice is still a draft. After approval, a different description is refused. Use suggest_invoice_change with add_line for a different line.
Inputs: lineId (required), invoiceId (required), description (required). Returns: data
list_invoiceslist invoicesARead-onlyIdempotentInspect
List the signed-in freelancer's invoices. Use a returned id with read_invoice. Do not guess an invoice.
Inputs: offset. Returns: data
offer_discountoffer discountADestructiveInspect
Record a discount the freelancer is putting on the invoice. kind none uses value 0. kind percent takes a whole number from 1 to 100. kind fixed takes a whole number of minor units. After the invoice is sealed, a different discount is refused until accept_invoice_change applies an apply_discount suggestion. Do not invent a discount.
Inputs: kind (required), note (required), value (required), invoiceId (required). Returns: data
place_lineplace lineADestructiveInspect
Add one line: description, quantity, rate in whole minor units, and unit hour, each, or day. After the invoice is sealed, a new line is refused until accept_invoice_change applies an add_line suggestion.
Inputs: unit (required), quantity (required), invoiceId (required), rateMinor (required), +1 more. Returns: data
quote_line_ratequote line rateADestructiveInspect
Set the rate already chosen for one line, as a whole number of minor units in the invoice currency. After the invoice is sealed, a different rate is refused until accept_invoice_change applies a change_rate suggestion.
Inputs: lineId (required), invoiceId (required), rateMinor (required). Returns: data
read_invoiceread invoiceARead-onlyIdempotentInspect
Read the invoice before answering. Quote only this record. Draft status is not an approved commitment. Proposed changes do not authorize a new line, a different rate, a discount, or a new due date.
Inputs: invoiceId (required). Returns: data
seal_invoiceseal invoiceADestructiveIdempotentInspect
Mark the current draft as the approved invoice. Pass confirmed true only after the freelancer explicitly approves the lines, quantities, rates, due date, late terms, and any discount already on the draft.
Inputs: confirmed (required), invoiceId (required). Returns: data
set_invoice_dueset invoice dueADestructiveInspect
Set the due date as a calendar day in YYYY-MM-DD form. After the invoice is sealed, a different date is refused until accept_invoice_change applies a move_due_date suggestion.
Inputs: dueOn (required), invoiceId (required). Returns: data
set_line_quantityset line quantityADestructiveInspect
Set the quantity on one line. After the invoice is sealed, a different quantity is refused until accept_invoice_change applies an adjust_quantity suggestion.
Inputs: lineId (required), quantity (required), invoiceId (required). Returns: data
suggest_invoice_changesuggest invoice changeAInspect
Record a suggested change. This does not change the invoice. kind add_line requires description, quantity, rateMinor, and unit. kind change_rate requires lineId and rateMinor. kind apply_discount requires discountKind, discountValue, and discountNote. kind move_due_date requires dueOn. kind adjust_quantity requires lineId and quantity. kind revise_late_terms requires graceDays, lateBasis, feeMinor, latePercent, and lateNote.
Inputs: kind (required), summary (required), invoiceId (required), unit, +13 more. Returns: data
write_late_termswrite late termsADestructiveInspect
Record late terms: grace days, and a basis of none, flat_fee, or percent_per_period. flat_fee uses feeMinor and a percent of 0. percent_per_period uses percent and a fee of 0. After approval, a different basis, grace, fee, or percent is refused until an accepted revise_late_terms suggestion.
Inputs: note (required), basis (required), percent (required), feeMinor (required), +2 more. Returns: data
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct field or lifecycle step (read, seal, add line, set rate, set quantity, set due date, etc.), so overlap is limited. The main friction is that describe_line vs place_line and quote_line_rate (sounds like reading a quote, like read_invoice) could momentarily confuse an agent, but descriptions clarify each.
All names are snake_case verb_object constructions (read_invoice, place_line, set_invoice_due, suggest_invoice_change), so the convention is readable and consistent. The verb choice varies widely (place/describe/quote/set/write/offer/suggest/accept), keeping it just short of a strict pattern.
13 tools sit in the well-scoped 3-15 range for an invoicing domain with a draft/seal/change-request lifecycle. Each field-editing tool earns its place by representing a distinct editable attribute.
The create-draft-edit-seal-suggest-accept lifecycle is largely covered, but there is no way to remove a line once placed and no delete/void invoice operation, which are notable gaps. Agents can work around corrections but cannot truly undo a bad line.
Maintenance
Related MCP Connectors
AI invoice follow-up emails for freelancers. Draft-only, never sends for you.
Invoicing for AI assistants: clients, quotes, invoices with computed tax, email send, card payments.
Freelancer invoice generator: line items, tax, totals, PDF - issued from a chat message.
Create invoices from your AI assistant in 6 languages and 10 currencies, ready for WhatsApp.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables drafting quotations and invoices from AI assistants like ChatGPT, Claude, and Gemini, with 133 templates, tax rules for 195 countries, and a link to the finished document.MIT
- AlicenseNot gradedqualityBmaintenanceDeposit by Ouroboros Apps (https://ouroborosapps.com). Freelance deposit and payment schedule: approved deposits, payment dates, and client wording; deposit waivers and date changes need approval. Connect by pasting https://deposit-continuity2.vercel.app/mcp into Claude, Cursor, Grok, or ChatGPT developer mode (OAuth). Docs: https://ouroborosapps.com/docs/depositMIT
- AlicenseNot gradedqualityBmaintenanceScope by Ouroboros Apps (https://ouroborosapps.com). Freelance scope of work: approved scope, rates, deadlines, and change orders, so an assistant cannot promise work or discounts that were not approved. Connect by pasting https://scope-continuity2.vercel.app/mcp into Claude, Cursor, Grok, or ChatGPT developer mode (OAuth). Docs: https://ouroborosapps.com/docs/scopeMIT
- AlicenseAqualityBmaintenanceMilestone by Ouroboros Apps (https://ouroborosapps.com). Freelance project milestones: approved milestones, deliverables, and acceptance criteria; a milestone is only done when the saved criteria are met. Connect by pasting https://milestone-continuity2.vercel.app/mcp into Claude, Cursor, Grok, or ChatGPT developer mode (OAuth). Docs: https://ouroborosapps.com/docs/milestone15MIT