MCP Server
subscriptions
io.github.theluckystrike/subscriptions
What this MCP does
Schedules recurring billing, generates due invoice PDFs, tracks schedule history and forecasts invoiced revenue.
Capabilities
Tools
14
tools
forecast
Revenue forecast
Expected invoiced revenue per calendar month per currency from active schedules. Invoiced and skipped periods are excluded and paused schedules listed apart. Free: 3 months; Pro: up to 120.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'months': {'type': 'integer', 'maximum': 120, 'minimum': 1, 'description': 'Months ahead including this one, default 12'}}, 'additionalProperties': False}
invoice_generate_due
Generate the invoices that are due
Create a real invoice in the invoice server for every schedule occurrence on or before as_of that has not been invoiced yet, and render each PDF. Returns what was created, what was skipped and what is still due.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'as_of': {'type': 'string', 'description': 'YYYY-MM-DD, defaults to today. Every occurrence on or before this date that has not been invoiced is billed. Idempotent: one invoice per schedule per period, keyed by the occurrence date, so running it twice creates nothing the second time'}, 'dry_run': {'type': 'boolean', 'description': 'List what would be created without creating anything. Default false. One run creates at most 60 invoices, oldest period first'}, 'schedule_id': {'type': 'string', 'description': 'Only this schedule. Free and unlimited on every tier'}}, 'additionalProperties': False}
license_activate
Activate license
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.
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>'}}, 'additionalProperties': False}
license_status
License status
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.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
schedule_create
Create a recurring invoice schedule
Define a repeating invoice: a client, the line items, how often to bill, and when it starts and ends. Returns the schedule id, a summary and its next dates. Nothing is invoiced until invoice_generate_due runs.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['client', 'items', 'every', 'start_date'], 'properties': {'every': {'anyOf': [{'enum': ['weekly', 'monthly', 'quarterly', 'yearly'], 'type': 'string'}, {'type': 'object', 'required': ['days'], 'properties': {'days': {'type': 'integer', 'maximum': 3650, 'minimum': 1}}, 'additionalProperties': False}], 'description': 'How often to bill: "weekly", "monthly", "quarterly", "yearly", or {days: 10}. Month steps keep the start date\'s day of month and clamp it to shorter months, so a schedule starting on the 31st bills on the 28th/29th in February and back on the 31st in March'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['description', 'quantity', 'unit_price'], 'properties': {'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'}, 'unit_price': {'type': 'number', 'maximum': 1000000000000, 'minimum': -1000000000000, 'description': 'Price per unit in major units, e.g. 90 for 90 EUR'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 200, 'minItems': 1, 'description': 'The line items billed every period'}, 'notes': {'type': 'string', 'description': 'Free text printed under the totals of every generated invoice'}, 'client': {'type': 'string', 'description': 'Client name or id, as in the invoice server. Unknown names are created on the first generated invoice'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'Defaults to your business default currency'}, 'due_days': {'type': 'integer', 'description': 'Days until each invoice is due, defaults to your payment terms'}, 'end_date': {'type': 'string', 'description': 'YYYY-MM-DD, INCLUSIVE: an occurrence landing exactly on it is still generated'}, 'tax_note': {'type': 'string', 'description': "Why this schedule bills the tax it bills, e.g. 'Reverse charge: VAT accounted for by the recipient, art. 196 Directive 2006/112/EC'. It is printed under the totals of EVERY invoice this schedule generates, so a 0% retainer carries its reason on the document instead of only in the chat"}, 'anchor_day': {'type': 'integer', 'maximum': 31, 'minimum': 1, 'description': "Pro: bill on this day of month instead of the start date's day. 31 means the last day of every month"}, 'start_date': {'type': 'string', 'description': 'YYYY-MM-DD. The first invoice falls on this date, and for weekly/monthly/quarterly/yearly steps its day of month is the billing day for every later period'}, 'end_of_month': {'type': 'boolean', 'description': 'Pro: always bill on the last day of the month'}, 'auto_generate': {'type': 'boolean', 'description': 'Marks the schedule for the monthly_billing_run prompt. Default false. Nothing runs in the background either way: invoices are created only when invoice_generate_due is called'}}, 'additionalProperties': False}
schedule_delete
Delete a schedule
Delete one schedule permanently. Invoices already generated stay in the invoice server and the history is kept. Re-creating it gives a NEW id, so its old periods count as unbilled. schedule_pause is reversible.
Destructive
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Schedule id, or a client name. Deletion is permanent; re-creating the same schedule afterwards gives it a NEW id, so its old periods count as unbilled again'}}, 'additionalProperties': False}
schedule_get
Get one schedule
Return one schedule in full by id or client: items, cadence, dates, due days, anchor rules, notes, per-period amount, next due date and how many invoices it generated. schedule_history is the log.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Schedule id, or a client name'}}, 'additionalProperties': False}
schedule_history
Schedule history
The audit log for one schedule id, oldest first: period, invoice number, issue and due dates, amount, PDF path, and whether that invoice is unpaid, paid, skipped or since deleted. schedule_list finds the id. Pro.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}}, 'additionalProperties': False}
schedule_list
List schedules
List schedules: id, client, cadence, per-period amount and currency, start and end dates, status, next due date and auto_generate. Filter by status; a paused schedule reports no next due date.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'status': {'enum': ['active', 'paused'], 'type': 'string'}}, 'additionalProperties': False}
schedule_pause
Pause a schedule
Stop one schedule generating invoices without deleting it; invoice_generate_due and forecast skip it. Its periods keep falling due and resuming back-bills them, so use schedule_skip to drop just one.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}}, 'additionalProperties': False}
schedule_resume
Resume a schedule
Make a paused schedule active again. Every period missed while it was paused is still due and the next invoice_generate_due creates them all. Refused when it would pass the free tier's 3 active.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}}, 'additionalProperties': False}
schedule_skip
Skip one period
Close ONE occurrence for good without pausing the schedule, reporting what will not be billed. period must be a real occurrence of it. An invoiced period is refused; undo reopens a skip.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'period'], 'properties': {'id': {'type': 'string', 'description': 'Schedule id, or a client name'}, 'undo': {'type': 'boolean', 'description': 'Remove a previous skip so the period becomes due again. Works only on a period that has not been invoiced. Default false'}, 'period': {'type': 'string', 'description': 'The occurrence date to skip, YYYY-MM-DD, exactly as it appears in schedule_upcoming or forecast. This is the answer to "pause this client for October": schedule_pause stops the whole schedule and a resumed schedule still back-bills the periods it missed, whereas a skipped period is closed for good'}}, 'additionalProperties': False}
schedule_upcoming
What falls due soon
Table every occurrence of every ACTIVE schedule due in the next N days (30 default), with its amount and the invoice due date, plus a total per currency. Free lists the first 3 in your horizon.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 3650, 'minimum': 1, 'description': 'Days ahead, default 30. The free tier honours the horizon you ask for and lists the first 3 occurrences in it; Pro lists them all'}}, 'additionalProperties': False}
schedule_update
Update a schedule
Change one schedule by id: client, items, currency, cadence, dates, due_days, notes or auto_generate. Only the fields you pass change. Periods already invoiced are never re-issued, so a new amount applies to future ones.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'every': {'anyOf': [{'enum': ['weekly', 'monthly', 'quarterly', 'yearly'], 'type': 'string'}, {'type': 'object', 'required': ['days'], 'properties': {'days': {'type': 'integer', 'maximum': 3650, 'minimum': 1}}, 'additionalProperties': False}], 'description': 'How often to bill: "weekly", "monthly", "quarterly", "yearly", or {days: 10}. Month steps keep the start date\'s day of month and clamp it to shorter months, so a schedule starting on the 31st bills on the 28th/29th in February and back on the 31st in March'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['description', 'quantity', 'unit_price'], 'properties': {'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'}, 'unit_price': {'type': 'number', 'maximum': 1000000000000, 'minimum': -1000000000000, 'description': 'Price per unit in major units, e.g. 90 for 90 EUR'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 200, 'minItems': 1}, 'notes': {'type': 'string'}, 'client': {'type': 'string'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, 'due_days': {'type': 'integer'}, 'end_date': {'type': ['string', 'null'], 'description': 'null clears the end date'}, 'tax_note': {'type': 'string', 'description': 'Replace the tax reason carried onto every future generated invoice. Pass an empty string to clear it'}, 'anchor_day': {'anyOf': [{'type': 'integer', 'maximum': 31, 'minimum': 1}, {'type': 'null'}], 'description': 'Pro'}, 'start_date': {'type': 'string'}, 'end_of_month': {'type': 'boolean', 'description': 'Pro'}, 'auto_generate': {'type': 'boolean'}}, 'additionalProperties': False}
History
Recent tool changes
Added
license_activate
Sept. 24, 2026, 2:40 a.m.
Added
license_status
Sept. 24, 2026, 2:40 a.m.
Added
forecast
Sept. 24, 2026, 2:40 a.m.
Added
schedule_history
Sept. 24, 2026, 2:40 a.m.
Added
invoice_generate_due
Sept. 24, 2026, 2:40 a.m.
Added
schedule_upcoming
Sept. 24, 2026, 2:40 a.m.
Added
schedule_skip
Sept. 24, 2026, 2:40 a.m.
Added
schedule_delete
Sept. 24, 2026, 2:40 a.m.
Added
schedule_resume
Sept. 24, 2026, 2:40 a.m.
Added
schedule_pause
Sept. 24, 2026, 2:40 a.m.
Added
schedule_update
Sept. 24, 2026, 2:40 a.m.
Added
schedule_get
Sept. 24, 2026, 2:40 a.m.
Added
schedule_list
Sept. 24, 2026, 2:40 a.m.
Added
schedule_create
Sept. 24, 2026, 2:40 a.m.
Discover
Similar MCP servers
Lovie Company Formation
co.lovie/company-formation
Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Red by Big Red Cloud
io.github.BigRedCloud/red-mcp-server
Connects to Big Red Cloud accounting for customers, suppliers, products, invoices, purchases, payments, receipts, journals, quote…
GestãoClick
io.github.mcp-dir/gestaoclick-mcp
Connects to the GestãoClick ERP to manage customers, suppliers, products, sales, service orders, budgets, and financial records.
Superlógica Condomínios
io.github.mcp-dir/superlogica-mcp
Connects to a condominium ERP for billing, collections, agreements, expenses, bank movements, statements, files, communications, …
FalaZuki Finance BR
com.falazuki/finance-br
Provides Brazil-focused financial calculations and rules for investments, credit, taxes, payroll, labor costs, debt, budgeting, a…
XBOSS
kr.xdata/xdata-mcp
Accesses Korean tax, social insurance, payroll, cash receipt, e-tax invoice, and certificate filing services.
Sirenic
eu.sirenic/sirenic
Provides European company registry, financial, procurement, sanctions, regulatory, insolvency, ownership, and ongoing due-diligen…