Skip to main content
Glama
Invoice by Ouroboros Apps

Invoice by Ouroboros Apps

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)

  • Docs: https://ouroborosapps.com/docs/invoice

  • 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/mcp

Do 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 start

When 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 (default http://localhost:3000)

  • SUPABASE_URL

  • SUPABASE_ANON_KEY

  • STRIPE_SECRET_KEY

  • STRIPE_WEBHOOK_SECRET

  • STRIPE_PRICE_MONTHLY and STRIPE_PRICE_YEARLY (Stripe catalog ids, not prices)

  • OPENAI_APPS_CHALLENGE (optional; when set, /.well-known/openai-apps-challenge returns 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 tools
accept_invoice_changeaccept invoice changeA
DestructiveIdempotent
Inspect

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 lineA
Destructive
Inspect

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 invoicesA
Read-onlyIdempotent
Inspect

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 discountA
Destructive
Inspect

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 lineA
Destructive
Inspect

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 rateA
Destructive
Inspect

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 invoiceA
Read-onlyIdempotent
Inspect

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 invoiceA
DestructiveIdempotent
Inspect

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 dueA
Destructive
Inspect

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 quantityA
Destructive
Inspect

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 termsA
Destructive
Inspect

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

    A3.9/5.0

    Scored across 13 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Deposit 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/deposit
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Scope 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/scope
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Milestone 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/milestone
      15
      MIT