# InvoiceGen

> Freelancer invoices with totals, tax, due dates. Free.

- name: io.github.everyai-com/invoice-gen
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 90/100 flags: duplicate-repo
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.everyai-com%2Finvoice-gen
- tools: https://api.protogrid.dev/v1/servers/io.github.everyai-com%2Finvoice-gen/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "invoice-gen": {
      "type": "http",
      "url": "https://invoice-gen.magicteams.ai/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 99
- freshness: 100
- provenance: 80
- drivers: +repository +namespace-matches-repo +reachable +uptime-97% +updated-19d-ago -duplicate-repo(15 names)
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list carries no ttlMs, so clients re-fetch it

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 4 of 4 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,562 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 12 tool changes in 30 days
- fail `stability.rug_pull`: 8 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 4, about 1,562 tokens to load them all
- tool set hash: 6b5b65238878812b8f95635250d1bd5a
- tools last changed: 2026-10-10T13:32:03.771Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.everyai-com/invoice-gen.svg)](https://protogrid.dev/servers/io.github.everyai-com/invoice-gen)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-10 `render_invoice_text` changed (description, inputSchema, outputSchema) **meaning changed**
  - before: Render an invoice as plain text for emailing. Use when sending invoices via email or text. NOT for generating PDFs; use render_invoice_pdf instead.
  - after: Build an invoice from the same inputs as create_invoice and return it as a plain-text document (header, line items, subtotal, discount, tax, TOTAL DUE, notes) ready to paste into an email or message. Use when the user wants readable invoice text. Do NOT use when structured fields are needed; use create_invoice.
- 2026-10-10 `supported_currencies` changed (description, outputSchema) **meaning changed**
  - before: List all supported invoice currencies. Use when setting up invoices; NOT for real-time currency conversion. Use calculate_totals for that.
  - after: List the currency codes InvoiceGen accepts for invoices (USD, EUR, INR, GBP, AED, SGD, AUD, CAD). Use before create_invoice when unsure whether a currency is supported. No exchange rates or currency conversion are provided.
- 2026-10-10 `calculate_totals` changed (description, inputSchema, outputSchema) **meaning changed**
  - before: Calculate totals for a list of items. Use when needing subtotal, discount, tax, and total. Do NOT use for creating invoices; use create_invoice instead.
  - after: Compute subtotal, discount, tax and total for a list of line items (discount applied before tax, amounts rounded to 2 dp). Use for quick totals math without building an invoice. Do NOT use to produce an invoice document; use create_invoice.
- 2026-10-10 `create_invoice` changed (description, inputSchema, outputSchema) **meaning changed**
  - before: Create an invoice for a business-client transaction. Use when needing a full invoice document. Do NOT use for calculating totals only; use calculate_totals instead.
  - after: Build a complete invoice as structured data: invoice number, issue and due dates, line items, discount, tax, total and payment terms. Nothing is stored. Use when the user wants an invoice for a client. Do NOT use for totals only (use calculate_totals) or for a printable text version (use render_invoice_text).
- 2026-10-10 `render_invoice_text` changed (outputSchema, annotations)
- 2026-10-10 `supported_currencies` changed (outputSchema, annotations)
- 2026-10-10 `calculate_totals` changed (outputSchema, annotations)
- 2026-10-10 `create_invoice` changed (outputSchema, annotations)
- 2026-10-06 `render_invoice_text` changed (title, description, inputSchema, outputSchema, annotations) **meaning changed**
  - before: Rebuild + render an invoice as plain text (same inputs as create_invoice).
  - after: Render an invoice as plain text for emailing. Use when sending invoices via email or text. NOT for generating PDFs; use render_invoice_pdf instead.
- 2026-10-06 `supported_currencies` changed (title, description, outputSchema, annotations) **meaning changed**
  - before: List supported invoice currencies with symbols.
  - after: List all supported invoice currencies. Use when setting up invoices; NOT for real-time currency conversion. Use calculate_totals for that.

Full history: https://api.protogrid.dev/v1/servers/io.github.everyai-com%2Finvoice-gen/changes

## Remotes

- https://invoice-gen.magicteams.ai/mcp (streamable-http, auth none, reachable true, uptime30d 0.972973)

## Packages

_none_

## Tools (4)

- `calculate_totals`: Compute subtotal, discount, tax and total for a list of line items (discount applied before tax, amounts rounded to 2 dp). Use for quick totals math without building an invoice. Do NOT use to produce an invoice document; use create_invoice.
- `create_invoice`: Build a complete invoice as structured data: invoice number, issue and due dates, line items, discount, tax, total and payment terms. Nothing is stored. Use when the user wants an invoice for a client. Do NOT use for totals only (use calculate_totals) or for a printable text version (use render_invoice_text).
- `render_invoice_text`: Build an invoice from the same inputs as create_invoice and return it as a plain-text document (header, line items, subtotal, discount, tax, TOTAL DUE, notes) ready to paste into an email or message. Use when the user wants readable invoice text. Do NOT use when structured fields are needed; use create_invoice.
- `supported_currencies`: List the currency codes InvoiceGen accepts for invoices (USD, EUR, INR, GBP, AED, SGD, AUD, CAD). Use before create_invoice when unsure whether a currency is supported. No exchange rates or currency conversion are provided.