Koskamo

theluckystrike McpStamp Invoice MCP

Generates numbered A4 PDF invoices with VAT lines, manages a client list, records payments, and tracks overdue invoices. It supports billing by hours or line items, handles multi-currency, and allows customization of prefixes and logos.

Visit theluckystrike

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

theluckystrike McpStamp Invoice MCP logo, by theluckystrikeCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by theluckystrike
You need:Free tier needs no keyGet a free token. It lasts 30 days and allows 600 calls per hour
MCP endpoint (Streamable HTTP)
https://mcp.zovo.one/mcp/invoice
Vendor documentation

What its tools do

13 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (6)

Can change data (7)

13 of 13 have a description · 13 of 13 declare behavior hints · 6 of 11 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Create a numbered PDF invoice with VAT and due date from a chat message
  • Bill tracked hours at an hourly rate and render the result as a PDF
  • Mark an invoice as paid and retrieve a list of overdue invoices
  • Store client details and generate invoices referencing them by name

Source and maintenance

Community listingRegistry 0.23.0
mcp-registry: io.github.theluckystrike/invoice-pdf-billing-generator@0.23.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
mcp-invoice 0.22.6
MCP protocol negotiated in check
2025-11-25
Tools
13 advertised
Resources
2 advertised
Resource templates
0 advertised
Prompts
2 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "prompts": {
    "listChanged": true
  },
  "resources": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Client invoicing. It covers the business profile printed on documents (name, address, VAT id, bank details and defaults), a client list, numbered invoices with VAT, invoices billed from hours, payment recording, A4 PDF invoices and unpaid invoices past their due date. The business profile is shared with the other McpStamp servers that print documents. Records are stored per user account on McpStamp's hosted service. The free tier allows 3 invoices a month and adds a credit line to PDFs; Pro renders PDFs unbranded with a logo. One lifetime key unlocks this server and all 58 others: https://mcp.zovo.one/buy/bundle?src=instr.invoice

Tools

13 advertised

business_set — Set your business details
Advertised by the server during the last successful anonymous check.

The ONE business profile for the whole suite: name, address, VAT id, bank details and defaults (currency, tax rate, terms, prefix, timezone). Saved to the shared profile every other server reads. Call it once, first.

business_set input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "vat": {
      "type": "number",
      "description": "Alias for default_tax_rate"
    },
    "bank": {
      "type": "string",
      "description": "Bank name / BIC"
    },
    "iban": {
      "type": "string",
      "description": "IBAN or account number for payment"
    },
    "name": {
      "type": "string",
      "description": "Your business or freelancer name"
    },
    "email": {
      "type": "string",
      "description": "Your own email address. Leave it out unless the user gave it: no server ever fills an email from anything but this profile or an explicit argument"
    },
    "phone": {
      "type": "string",
      "description": "Your own phone number. Same rule as email: only if the user gave it"
    },
    "vat_id": {
      "type": "string",
      "description": "VAT / tax registration id"
    },
    "address": {
      "type": "string",
      "description": "Postal address, newlines allowed"
    },
    "tax_rate": {
      "type": "number",
      "description": "Alias for default_tax_rate"
    },
    "timezone": {
      "type": "string",
      "description": "IANA zone you work in, e.g. Europe/Warsaw. Shared with time-tracker (entries are stamped in it) and timezone (your home zone)"
    },
    "vat_rate": {
      "type": "number",
      "description": "Alias for default_tax_rate"
    },
    "logo_path": {
      "type": "string",
      "description": "Path to a PNG or JPG logo (Pro)"
    },
    "invoice_prefix": {
      "type": "string",
      "description": "Invoice number prefix, default INV (custom prefix is Pro)"
    },
    "default_currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "ISO code, e.g. EUR, USD, JPY. Default EUR"
    },
    "default_tax_rate": {
      "type": "number",
      "description": "Default VAT percent applied to items without their own rate"
    },
    "payment_terms_days": {
      "type": "number",
      "description": "Default days until due. Default 14"
    }
  },
  "additionalProperties": {}
}
business_set annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
client_add — Add a client
Advertised by the server during the last successful anonymous check.

Store a client so invoice_create can refer to them by name. Re-adding the same name updates the stored address, email and VAT id; a record identical to a stored one is refused, naming the id that already holds it.

client_add input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "vat_id": {
      "type": "string",
      "description": "Client VAT id, printed for reverse-charge invoices"
    },
    "address": {
      "type": "string"
    }
  }
}
client_add annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
client_delete — Delete a client
Advertised by the server during the last successful anonymous check.
Advertised destructive

Delete one stored client that nothing refers to. A client named on any invoice, quote, credit note, purchase order, deposit, statement or schedule is refused with those documents listed.

client_delete input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "client"
  ],
  "properties": {
    "client": {
      "type": "string",
      "description": "Client name or id, exactly as client_list shows it"
    }
  }
}
client_delete annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}
client_list — List clients
Advertised by the server during the last successful anonymous check.
Advertised read-only

List every stored client with id, address, email and VAT id. No arguments, and it writes nothing. With none stored it says so: invoice_create also creates a client from the name you pass.

client_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
client_list annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
invoice_create — Create an invoice
Advertised by the server during the last successful anonymous check.

Create an invoice from line items and return the record with its next, never-reused number. unit_price is in MAJOR units; lines are rounded then summed. One currency per invoice. Free: 3 a month.

invoice_create input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "client",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description",
          "quantity",
          "unit_price"
        ],
        "properties": {
          "vat": {
            "type": "number",
            "maximum": 1000,
            "minimum": -100,
            "description": "Alias for tax_rate"
          },
          "currency": {
            "type": "string",
            "pattern": "^[A-Za-z]{3}$",
            "description": "Currency this line was captured in. Every line on one invoice must agree; convert first with expense_to_invoice target_currency + fx_rates"
          },
          "quantity": {
            "type": "number",
            "maximum": 1000000000000,
            "minimum": -1000000000000,
            "description": "Hours, units or 1 for a flat fee"
          },
          "tax_rate": {
            "type": "number",
            "maximum": 1000,
            "minimum": -100,
            "description": "VAT percent for this line, overrides the business default"
          },
          "vat_rate": {
            "type": "number",
            "maximum": 1000,
            "minimum": -100,
            "description": "Alias for tax_rate"
          },
          "unit_price": {
            "type": "number",
            "maximum": 1000000000000,
            "minimum": -1000000000000,
            "description": "Price per unit in major units, e.g. 90 for 90 EUR"
          },
          "description": {
            "type": "string"
          },
          "round_total": {
            "type": "boolean",
            "description": "D-R46: round this line's TOTAL to the exact converted amount instead of rounding the unit price to cents first. Default false keeps the D-R24 basis (unit price x quantity always equals the printed gross); true trades that off so the gross matches an fx conversion to the cent."
          }
        }
      },
      "description": "Line items. Amounts are held as integer minor units and every line is rounded first, then summed, so the printed lines can never disagree with the total. A line may carry its own currency"
    },
    "notes": {
      "type": "string",
      "description": "Free text printed under the totals"
    },
    "client": {
      "type": "string",
      "description": "Client name or id. Unknown names are added automatically"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Invoice currency, 3-letter ISO code. Defaults to the one currency every item agrees on, else your business default. Every line on one invoice must agree with it; a mix is refused with the exact conversion argument to pass rather than billed as if it were one currency"
    },
    "due_days": {
      "type": "number",
      "description": "Days until due, defaults to your payment terms"
    },
    "issue_date": {
      "type": "string",
      "description": "YYYY-MM-DD, defaults to today"
    },
    "discount_percent": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Discount percent applied to every line before tax, 0-100"
    }
  }
}
invoice_create annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
invoice_from_hours — Invoice from hours
Advertised by the server during the last successful anonymous check.

Shortcut for the common case: bill one client for N hours at an hourly rate. Creates and returns a single-line invoice, converting the rate into target_currency when you supply fx_rates, and echoing back any entry_ids.

invoice_from_hours input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "client",
    "hours",
    "rate"
  ],
  "properties": {
    "rate": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": -1000000000000,
      "description": "Hourly rate in major units, expressed in currency (or the business default currency)"
    },
    "hours": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": -1000000000000
    },
    "notes": {
      "type": "string"
    },
    "client": {
      "type": "string"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Currency the rate is in. Without target_currency this is also the invoice currency"
    },
    "due_days": {
      "type": "number"
    },
    "fx_rates": {
      "type": "object",
      "description": "Conversion rates, the same pair expense_to_invoice takes: fx_rates maps the RATE's currency to the number of target units one of it buys, meaning 1 unit of that currency = X units of target_currency, e.g. {\"EUR\": 1.1578} with target_currency \"USD\". You supply the rate; nothing here fetches or guesses one",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "number",
        "exclusiveMinimum": 0
      }
    },
    "tax_rate": {
      "type": "number",
      "maximum": 1000,
      "minimum": -100
    },
    "entry_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Time-tracker entry ids these hours came from (the entry_ids invoice_summary returns). Echoed back with the new invoice number so you can call entry_mark_billed"
    },
    "issue_date": {
      "type": "string"
    },
    "description": {
      "type": "string",
      "description": "Line description, default 'Consulting services'"
    },
    "round_total": {
      "type": "boolean",
      "description": "D-R46: when converting with fx_rates, round the line's TOTAL to the exact converted amount instead of rounding the hourly rate to cents first. Default false keeps the D-R24 basis (unit price x hours always equals the printed line, so a rounding_note explains any drift from the exact conversion); true removes the drift but unit_price x hours may then be a cent or two off the printed total."
    },
    "target_currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Issue the invoice in this currency instead, converting the rate. Needs fx_rates for the rate currency"
    },
    "discount_percent": {
      "type": "number",
      "maximum": 100,
      "minimum": 0
    }
  }
}
invoice_from_hours annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
invoice_list — List invoices
Advertised by the server during the last successful anonymous check.
Advertised read-only

List invoices by number: client, dates, currency, subtotal, discount, tax lines, total, status, paid, credited and the balance still due after any credit note. Filter by status, client and date range.

invoice_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "type": "string",
      "description": "YYYY-MM-DD inclusive"
    },
    "from": {
      "type": "string",
      "description": "YYYY-MM-DD inclusive"
    },
    "client": {
      "type": "string"
    },
    "status": {
      "enum": [
        "unpaid",
        "paid",
        "partial"
      ],
      "type": "string"
    }
  }
}
invoice_list annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
invoice_get — Get one invoice
Advertised by the server during the last successful anonymous check.
Advertised read-only

Return the full stored record for one invoice number, including every line, tax breakdown, and the balance still open after any credit note issued against it (see credited_minor).

invoice_get input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number"
  ],
  "properties": {
    "number": {
      "type": "string"
    }
  }
}
invoice_get annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
invoice_mark_paid — Mark an invoice paid
Advertised by the server during the last successful anonymous check.

Record a payment on one invoice. amount is in MAJOR units and ADDS to what is paid, never replaces it; omit it to settle the rest. An overpayment is refused, naming the open balance.

invoice_mark_paid input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number"
  ],
  "properties": {
    "amount": {
      "type": "number",
      "description": "Amount received in major units, ADDED to what is already paid on this invoice. Omit to pay off the remaining balance in full",
      "exclusiveMinimum": 0
    },
    "method": {
      "type": "string",
      "description": "How it was paid, e.g. bank transfer, card. Stored on this payment's row"
    },
    "number": {
      "type": "string"
    },
    "paid_date": {
      "type": "string",
      "description": "YYYY-MM-DD, defaults to today"
    },
    "reference": {
      "type": "string",
      "description": "Bank reference or transaction id for this payment. Stored on this payment's row"
    }
  }
}
invoice_mark_paid annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
invoice_pdf — Render invoice PDF
Advertised by the server during the last successful anonymous check.
Advertised read-only

Call this tool to write one stored invoice as an A4 PDF and return the path: issuer, BILL TO, dates, items, taxes and totals. Free stamps a credit line and no logo; Pro renders it unbranded with your logo.

invoice_pdf input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "number"
  ],
  "properties": {
    "number": {
      "type": "string",
      "description": "Invoice number to render, as returned by invoice_create"
    },
    "out_path": {
      "type": "string",
      "description": "Where to write the PDF; defaults to <data dir>/pdf/<number>.pdf. The page carries the issuer block, the BILL TO client block, dates, an item table with wrapped descriptions, subtotal, discount, one tax line per rate, the total, payment details and notes, and every money value on it carries its currency code. Use a .pdf path: the bytes written are always PDF"
    }
  }
}
invoice_pdf annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
overdue_report — Overdue report
Advertised by the server during the last successful anonymous check.
Advertised read-only

List every invoice not paid in full whose due date has passed, worst first, with days overdue and the amount, then a total per currency. Free. Use invoice_list for everything still open.

overdue_report input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "as_of": {
      "type": "string",
      "description": "YYYY-MM-DD, defaults to today"
    }
  }
}
overdue_report annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
license_status — License status
Advertised by the server during the last successful anonymous check.
Advertised read-only

Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

license_status input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
license_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
license_activate — Activate license
Advertised by the server during the last successful anonymous check.

Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

license_activate input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "License key from checkout, MCPL1.<payload>.<signature>"
    }
  }
}
license_activate annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

2 advertised

monthly_invoicing — Monthly invoicing

Advertised by the server during the last successful anonymous check.

Review what is unpaid and what is overdue, then draft the next invoice for the client that owes the most.

month
YYYY-MM, default the current month
client
Limit the review, and the drafted invoice, to one client name or id
upgrade_to_pro — Explain the upgrade

Advertised by the server during the last successful anonymous check.

Explain what Pro on the invoice server costs and exactly what the user has to do, without leaving the conversation.

feature
The capped feature that prompted this, if there was one

Resources

2 advertised

open-invoices — Open invoices

Advertised by the server during the last successful anonymous check.

Every unpaid or partly paid invoice as JSON, with the balance due.

open-invoices URI
invoices://open

MIME type: application/json

pricing — Pricing and upgrade

Advertised by the server during the last successful anonymous check.

What invoice costs, what Pro unlocks, the checkout link that carries this connection's token, and the one step a person has to take. Machine-readable; read it before telling a user how to lift a free-tier cap.

pricing URI
pricing://invoice

MIME type: application/json

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
520 ms
95th percentile latency
520 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 520 ms · metadata changed · 13 tool(s), 2 resource(s), 0 resource template(s), 2 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http mcpstamp-invoice-mcp https://mcp.zovo.one/mcp/invoice

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add mcpstamp-invoice-mcp --url https://mcp.zovo.one/mcp/invoice

Cursor

Merge this server into .cursor/mcp.json in your project, then enable mcpstamp-invoice-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "mcpstamp-invoice-mcp": {
      "url": "https://mcp.zovo.one/mcp/invoice"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "mcpstamp-invoice-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.zovo.one/mcp/invoice",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start mcpstamp-invoice-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "mcpstamp-invoice-mcp": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/invoice"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http mcpstamp-invoice-mcp https://mcp.zovo.one/mcp/invoice

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://mcp.zovo.one/mcp/invoice

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "mcpstamp-invoice-mcp": {
      "serverUrl": "https://mcp.zovo.one/mcp/invoice"
    }
  }
}

Let your agent find its tools

Find servers like theluckystrike McpStamp Invoice MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,944