Frihet MCP Server
This server exposes Frihet ERP as MCP tools so an AI can read and manage business records, finances, taxes, CRM, e-invoicing, hospitality, POS, kitchen, and banking data.
Read business context, monthly P&L, quarterly tax prep, Spanish tax model summaries (303/130/390/180/347), and VeriFactu status.
Create, list, update, duplicate, send, pay, cancel/delete invoices; retrieve PDF/e-invoice XML; issue credit notes and late fees.
Manage expenses, clients, contacts, CRM activities/notes, products, quotes, vendors, deposits, and webhooks.
Validate, export, and dispatch e-invoices in EN16931/UBL/CII/Factur-X/XRechnung/FatturaPA/PEPPOL/Facturae formats; export DATEV; submit to FACe and TicketBAI (KSeF is not deployed).
Manage vacation rentals, reservations, properties, and booking-channel sync.
Manage POS terminals, sales/refunds, and kitchen tickets/stations/menu/flow.
Manage bank accounts/transactions; categorize and reconcile transactions against invoices/expenses.
Some sensitive writes require confirm=true; some backends may be unavailable or workspace-dependent.
What is this
An MCP server that connects your AI assistant to Frihet, the AI-native ERP for businesses of any size. Ask for invoices, expenses, clients, quotes, banking and tax figures in plain language, from the tools you already use.
You: "Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/hour, due March 1st"
Claude: Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,630.00 EUR.158 canonical operations. Five fiscal aliases. Ten prompts. The local package serves 11 resources; the hosted Worker deliberately serves the 7 static resources, while API-backed workspace resources remain local-profile only.
Related MCP server: Finizi B4B MCP Server
Quick start
Remote, one step. Add https://mcp.frihet.io/mcp as a remote MCP server in any client that supports OAuth. You sign in with your browser; there is nothing to install and no key to copy.
Local, with your API key (create one in app.frihet.io under Settings > API):
claude mcp add frihet -s user -e FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-serverNo account yet? Try demo mode. It answers from example data, persists nothing and makes no network calls:
FRIHET_DEMO=1 npx -y @frihet/mcp-serverLocal installs need Node 22.23.4+, 24.22.1+ or 26.12.1+. Other clients are covered under Client setup.
Distribution
Where to get it
Channel | Status | Entry point |
npm | Published |
|
Remote MCP | Live, OAuth or API key |
|
ChatGPT app | Live | |
Raycast | Coming to the Raycast Store | |
Official MCP Registry | Listed | |
GitHub MCP Registry | Listed |
Also listed on Glama, Cursor Directory, mcp.so, mcpservers.org and the ToolSDK registry.
Surface truth: the catalogue contains 158 canonical operations. The local full profile serves 163 tool names, 11 resources, and 10 prompts (158 canonical operations plus 5 fiscal aliases). The hosted grouped profile serves 166 tool names, 7 resources, and 10 prompts (the same names plus 3 discovery tools, with API-backed resources kept local-only). The separately reviewed OpenAI profile serves 33 tool names, 0 resources, and 0 prompts. These counts describe the current source release; the hosted server reports the version it is running at
/health. Catalogue membership is not a promise that a backing API is enabled for every workspace.
What you can do
Real prompts, grouped by area.
Area | Try asking |
Invoicing | "Show me all unpaid invoices" · "Create an invoice for Acme SL with 10h of consulting at 95/hour" · "Mark invoice abc123 as paid" |
Expenses | "Log a 59.99 EUR expense for Adobe Creative Cloud, category: software, tax-deductible" · "What did I spend on travel last quarter?" |
Clients and CRM | "Add a new client: TechStart SL, NIF B12345678" · "Log a call with TechStart: discussed Q2 proposal" · "Show all activities for Acme SL" |
Quotes | "Create a quote for Design Studio: logo design (2000 EUR) + brand guidelines (3500 EUR)" |
Tax and reporting | "Prepare my quarterly tax summary" · "Give me this month's profit and loss" |
Webhooks | "Set up a webhook to notify https://my-app.com/hook when invoices are paid" |
Beyond these, the catalogue covers banking, e-invoicing, time tracking, recurring invoices, HR and payroll, POS and more. See the full catalogue.
Client setup
Claude Code
claude mcp add frihet -s user -e FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-server
claude mcp list # verify: frihet ✓ ConnectedOr use the hosted server: claude mcp add --transport http frihet https://mcp.frihet.io/mcp.
Codex CLI
codex mcp add frihet --env FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-serverCodex reads TOML, not JSON. Pasting a JSON mcpServers block into ~/.codex/config.toml is a parse error that breaks the whole file, so use the command above.
Claude Desktop, Cursor, Windsurf, Cline
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_your_key_here"
}
}
}
}Client | Config file |
Claude Desktop |
|
Cursor |
|
Windsurf |
|
Cline | VS Code settings or |
Remote server with an API key
{
"mcpServers": {
"frihet": {
"type": "streamable-http",
"url": "https://mcp.frihet.io/mcp",
"headers": {
"Authorization": "Bearer fri_your_key_here"
}
}
}
}Clients that support OAuth 2.1 with PKCE can connect to the same URL and sign in through the browser instead.
ChatGPT
Open Frihet in ChatGPT and connect your account.
Skill for coding agents
npx skills add Frihet-io/frihet-mcpInstalls the Frihet skill for Claude Code, Cursor, Codex, Windsurf, Gemini CLI and others. It routes requests to the MCP tools and asks for confirmation before writes. Tax figures come from your Frihet data, not from the skill. Skill docs.
Get your API key
Log into app.frihet.io
Go to Settings > API
Click Create API key
Copy the key (starts with
fri_). It is only shown once.
For AI agents
If you are an agent reading this repository, the contract is machine-readable and generated from the running server.
What | Where |
Onboarding contract: quickstart per client, auth, safe workflow, human-authority tool lists, error recovery |
|
Per-tool capability truth: |
|
How to behave once connected | the |
Orient before acting.
get_business_contextand thefrihet://tax/ratesresource decide the correct fiscal treatment. Do not recall a tax rate from memory.Draft, show, stop.
create_invoice,create_quoteandcreate_credit_notedefault tostatus=draft: no fiscal number, no hash, nothing sent to a tax authority.Human authority is not yours to assume. Any tool with a non-empty
externalSideEffectsreaches a client's inbox, a webhook, money, or a tax authority. Several also takeconfirm=true; that flag records a human decision.
What to expect
This MCP is a structured data interface -- you describe what you want in natural language, and the AI creates, queries, or modifies business records in Frihet. Most of the 158 canonical operations are CRUD operations over the REST API; the rest are read-only summaries and fiscal/e-invoice actions. Alias and discovery names are counted separately.
It does not do OCR, PDF scanning, file upload or image processing. To digitize a paper invoice, extract the data first (a vision model, an OCR service, or manual entry), then ask the assistant to create the record. One API key maps to one Frihet workspace, and you need a Frihet account at app.frihet.io.
Full catalogue
Invoices (12)
Tool | What it does |
| List invoices with pagination |
| Get full invoice details by ID |
| Create a new invoice with line items |
| Update any invoice field |
| Delete a draft invoice; a sent/paid one is cancelled, not destroyed ( |
| Find invoices by client name, date, or status |
| Email invoice to client (PDF attachment) — reaches a third party, |
| Mark an invoice as paid with optional payment date |
| Get bounded invoice PDF bytes as base64 |
| Get bounded XML or Factur-X PDF bytes for an invoice |
| Create a credit note linked to an existing invoice |
| Apply a late payment fee to an overdue invoice |
Expenses (5)
Tool | What it does |
| List expenses with pagination |
| Get expense details |
| Record a new expense |
| Modify an expense |
| Delete an expense |
Clients (5)
Tool | What it does |
| List all clients |
| Get client details |
| Register a new client |
| Update client info |
| Remove a client |
CRM: Contacts (3)
Tool | What it does |
| List all contacts for a client |
| Add a contact person to a client |
| Remove a contact from a client |
CRM: Activities (2)
Tool | What it does |
| List CRM activities (calls, emails, meetings, tasks) |
| Log a call, email, meeting, or task against a client |
CRM: Notes (3)
Tool | What it does |
| List all notes for a client |
| Add a free-form note to a client |
| Remove a note from a client |
Products (5)
Tool | What it does |
| List products and services |
| Get product details |
| Add a product or service |
| Update pricing or details |
| Remove a product |
Quotes (6)
Tool | What it does |
| List all quotes |
| Get quote details |
| Draft a new quote |
| Modify a quote |
| Delete only a clean draft with no delivery, response, attachment, or conversion evidence; refuse protected drafts; cancel non-drafts ( |
| Email quote to client for acceptance |
Webhooks (6)
Tool | What it does |
| List configured webhooks |
| Get webhook details |
| Register a new webhook endpoint |
| Modify events or URL |
| Remove a webhook |
| Send a test payload to a configured webhook endpoint |
Intelligence (4)
Tool | What it does |
| Full snapshot: profile, plan, recent activity, top clients, current month |
| Monthly P&L: revenue, expenses, profit, tax liability, top clients by revenue |
| Quarterly tax prep: Modelo 303/130 fields, collected vs deductible, liability |
| Clone an invoice for recurring billing (copies items/client/tax, starts as draft) |
E-Invoicing (10)
Tool | What it does |
| Dispatch an invoice in 11 formats (XRechnung, Factur-X, FatturaPA, PEPPOL, Facturae, UBL, CII) via email / Chorus Pro / SDI / PEPPOL / download |
| Poll an e-invoice dispatch until it succeeds or fails; returns ackId, XML URL and PDF/A-3 URL |
| Validate raw XML against format schema + schematron rules (KOSIT / Mustang / XSD / Schematron) |
| Export accounting data as DATEV EXTF (Buchungsstapel / Debitoren / Kreditoren) in CP1252 encoding |
| Export e-invoice data in machine-readable formats (JSON/XML) for archival or integration |
| Submit invoice to FACe (Spain B2G government e-invoicing platform) |
| Poll submission status from FACe for a submitted invoice |
| Submit TicketBAI fiscal record to Basque Country tax authority (Hacienda) |
| Poll TicketBAI submission status from the Basque tax authority |
| NOT_DEPLOYED: submit an invoice to KSeF (Poland). Returns a labeled "unavailable" error until activated |
Time Tracking (6)
Tool | What it does |
| List time entries with filter by user, project, date range, billable status |
| Get full details of a single time entry by ID |
| Log hours for a project (billable flag, description, date) |
| Update any field on an existing time entry (PATCH semantics) |
| Soft-delete a time entry (confirm=true required) |
| Aggregate total/billable/non-billable hours for a period, with optional groupBy (user/project/day) |
Recurring Invoices (8)
Tool | What it does |
| List all recurring invoice templates (filter by active/paused) |
| Get full details of a recurring template by ID |
| Create a new recurring invoice template (daily/weekly/monthly/quarterly/yearly) |
| Update template fields — affects future generated invoices only |
| Pause an active template — no invoices generated while paused |
| Resume a paused template — next invoice on next scheduled cycle |
| Permanently delete a template (confirm=true required) |
| Generate the next recurring invoice with explicit |
Team Management (4)
Tool | What it does |
| List active members + pending invites (owner excluded) |
| Invite a new member by email with role (admin/editor/accountant/viewer) |
| Change an existing member's role (admin/editor/accountant/viewer) |
| Remove a member from the workspace (confirm=true required) |
Gestoria — Accountants (5)
Tool | What it does |
| Send a message in a contextual thread (documentRequest / filingItem / obligation) |
| List messages in a thread, newest first; paginate backwards with |
| Create a reusable document request template with variables + due-date offset |
| Bulk send a template to up to 500 client workspaces in one call |
| Cross-client AR aging report (buckets, per-workspace breakdown, top overdue) |
Audit GL (3)
Tool | What it does |
| Approve a GL journal entry (gestor/admin only, restricted) |
| Reject a GL entry with a mandatory reason (restricted) |
| Retrieve full audit trail for a GL entry |
White-label Portal Domain (3)
Tool | What it does |
| Add a custom domain to the client portal (returns DNS CNAME records) |
| Verify DNS propagation for a custom portal domain |
| Remove a custom portal domain (reverts to default Frihet subdomain) |
Self-onboard & VIES (2)
Tool | What it does |
| Generate a time-limited self-onboard link for a prospective client |
| Validate an EU VAT number (CIF intracomunitario) via VIES |
IGIC — Canary Islands Indirect Tax (4)
Tool | What it does |
| M415 annual operations >€3,005 (Canarias equivalent of M347) — not deployed, returns |
| M425 annual IGIC recap for Canary Islands businesses — not deployed, returns |
| M418 monthly individual IGIC return, régimen especial del grupo de entidades — not deployed, returns |
| AIEM (Arbitrio Importación) calculation for Canarias — not deployed, returns |
Impuesto sobre Sociedades — Corporate Tax (2)
Tool | What it does |
| Modelo 200 annual IS return — not deployed, returns |
| Modelo 202 installment payments (1P/2P/3P) — not deployed, returns |
Bank Categorization Rules (2)
Tool | What it does |
| List all bank auto-categorization rules (conditions + actions + status) |
| Create a new rule to auto-categorize transactions by description, amount, counterparty |
Deposits (7)
Tool | What it does |
| List deposits with pagination |
| Get deposit details by ID |
| Record a new client deposit |
| Update deposit fields |
| Delete a deposit (confirm=true required) |
| Apply a deposit balance against an invoice |
| Record a deposit refund in Frihet bookkeeping with |
Vendors (5)
Tool | What it does |
| List all vendors/suppliers |
| Get vendor details |
| Add a new vendor |
| Update vendor info |
| Remove a vendor |
Banking (5)
Tool | What it does |
| List connected bank accounts |
| Get details for a bank account |
| List bank transactions with filters |
| Assign a category and expense/income type to a transaction |
| Link a bank transaction to an existing invoice |
Fiscal — Spanish Tax Models (7)
Tool | What it does |
| Quarterly IVA return (Modelo 303) — collected vs deductible, net payable |
| Quarterly IRPF installment for self-employed (Modelo 130) |
| Annual IVA summary (Modelo 390) |
| Annual withholding summary for rentals (Modelo 180) — not deployed, returns |
| Annual third-party transactions >€3,005 (Modelo 347) |
| Get VeriFactu submission status for a fiscal record |
| Resubmit a rejected VeriFactu fiscal record |
Vacation Rentals / Stay (5)
Tool | What it does |
| List rental reservations with filters |
| Get reservation details |
| Create a new reservation |
| List all rental properties |
| Trigger OTA channel sync (Airbnb, Booking.com, etc.) |
POS — Point of Sale (4)
Tool | What it does |
| List registered POS terminals |
| Get details for a POS sale transaction |
| List POS sales with pagination |
| Issue a refund for a POS sale |
Kitchen / Restaurant (6)
Tool | What it does |
| List kitchen order tickets for the live board, filtered by status or station |
| Get a single kitchen ticket by ID with all items and their individual statuses |
| Advance a ticket's status (queued → preparing → ready → served) or reassign it to another station |
| List all kitchen stations with id, name, and active status |
| List the kitchen menu catalog with free-text search and active/inactive filter |
| Slow-station detection: aggregate open tickets per station and flag the bottleneck |
HR — Human Resources (9)
Tool | What it does |
| Create a leave request (vacation, sick, personal) |
| Approve a pending leave request |
| Reject a leave request with a reason |
| Cancel an approved or pending leave request |
| List leave requests with filters (user, status, date range) |
| Record clock-in for an employee |
| Record clock-out for an employee |
| Read daily/weekly overtime, aggregate minutes/hours, and compliance alerts computed over the selected YYYY or YYYY-MM records |
| List attendance anomalies (missing punches, excessive overtime) |
Payroll (2)
Tool | What it does |
| Read normalized payroll-ready employee data; the format value is an echoed destination label, not a generated file |
| List payable employees with payroll-profile readiness, missing fields, and monthly review state |
Permissions (2)
Tool | What it does |
| Get the documented RBAC-model snapshot (not a runtime authorization guarantee) |
| Compare RBAC-model fields with actual API-key scopes and known scope denials (non-exhaustive) |
Period Close (3)
Tool | What it does |
| Get the current or selected YYYY fiscal-year range, open/closed state, and nullable closing details |
| Close an accounting period (gestor/admin only, restricted) |
| Reopen a closed period with a mandatory reason (restricted) |
All canonical operations (and their aliases) return structured output via outputSchema -- typed JSON, not raw text. List response shapes follow their API family; not every list endpoint is paginated.
Capability and side-effect truth
On the full MCP surfaces, every tools/list entry includes _meta["io.frihet/capability"]:
registeredmeans the name and handler exist in this server build;callabilityisapi_dependent(the handler calls the API; deployment, workspace enablement, and authorization still decide),runtime_checked(the handler explicitly distinguishes an absent backend from empty data),deferred,unavailable, orlocal—never an unconditional “available” claim;writesFrihet,externalInteraction, andexternalSideEffectsdistinguish state changes and calls to external entities/providers;MCP action annotations remain the standard source for read-only, destructive, idempotent, and open-world hints.
The ChatGPT app uses a separately reviewed profile of 33 business operations, with no discovery meta-tools, prompts or resources. Its 17 reads and 16 writes are deliberately narrow, and every write requires literal confirm=true. Do not infer it from the full catalogue.
Resources
Context the AI can read to make smarter decisions.
The local package serves 11 resources: 7 static references plus 4 API-backed workspace resources. The hosted Worker serves the 7 static resources. The OpenAI-reviewed host serves 0 resources.
Static (reference data, no API calls):
Resource | URI | What it provides |
API Schema |
| OpenAPI summary: endpoints, auth, rate limits, pagination, error codes |
Tax Rates |
| Tax rates by Spanish fiscal zone: IVA, IGIC, IPSI, EU reverse charge, IRPF |
Tax Calendar |
| Quarterly and annual filing deadlines for the listed Spanish tax models |
Expense Categories |
| 8 categories with deductibility rules, IVA treatment, amortization |
Invoice Statuses |
| Status flow (draft > sent > paid/overdue > cancelled), transition rules, webhook events |
Currencies |
| 40 supported currencies with ISO codes, symbols, decimal places, locale formatting |
Countries |
| Supported countries with fiscal zones, default tax rates, currencies, invoice prefixes |
Dynamic (live data from your account):
Resource | URI | What it provides |
Business Profile |
| Your business info, plan, defaults, recent activity, top clients |
Monthly Snapshot |
| Current month P&L, revenue, expenses, tax liability |
Overdue Invoices |
| All invoices past due date (up to 100) |
Plan Limits |
| Live plan tier, usage counters, invoices/month, API rate limits |
Prompts (10)
Pre-built workflows the AI can execute as guided multi-step operations.
Prompt | What it does | Arguments |
| Close the month: review unpaid invoices, categorize expenses, check tax obligations, generate summary |
|
| Set up a new client with correct tax rates by location, optionally create a welcome quote |
|
| Prepare quarterly tax filing: calculate IVA/IGIC, identify deductibles, preview Modelo 303/130/420 |
|
| Find overdue invoices, draft follow-up messages, suggest payment reminders | -- |
| Create a client + first invoice in one workflow with tax rate lookup |
|
| Generate expense report grouped by category with deductible totals |
|
| Full annual closing: quarterly review, pending invoices, uncategorized expenses, year-end checklist |
|
| Project cash flow for coming months: recurring income, expenses, overdue receivables, tax deadlines |
|
| AR aging analysis: group unpaid invoices by bucket (0-30/31-60/61-90/90+ days), top debtors, collection actions | -- |
| Process expenses in bulk: categorize, apply tax rates, flag missing receipts |
|
Configuration
Variable | Required | Default |
| Yes (stdio) | -- |
| No |
|
| No |
|
FRIHET_TOOL_MODE=grouped is progressive disclosure: each tool description collapses to one line and three discovery tools (list_tool_groups, search_tools, describe_tool) are added, so an agent loads full schemas only for the tools it needs. Operation names, input schemas and handlers do not change. The hosted server runs in grouped mode.
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["@frihet/mcp-server"],
"env": { "FRIHET_API_KEY": "fri_...", "FRIHET_TOOL_MODE": "grouped" }
}
}
}Rate limits depend on your plan; the server retries with exponential backoff on 429. See the API reference.
Development and contributing
git clone https://github.com/Frihet-io/frihet-mcp.git
cd frihet-mcp
npm install
npm run build # must pass before submitting
FRIHET_API_KEY=fri_xxx node dist/index.jsTest with the MCP Inspector: npx @modelcontextprotocol/inspector node dist/index.js. Open an issue before large changes. Report vulnerabilities as described in SECURITY.md.
Ecosystem
Package | What it is |
This MCP server (158 canonical operations + 5 alias names; 11 local resources; 10 prompts) | |
TypeScript SDK ( | |
CLI ( | |
n8n community node for workflow automation | |
OpenAPI 3.1 at | |
Real-time events with HMAC-SHA256 |
Frihet · Documentation · MCP server docs · OpenAPI spec
License
MIT. See LICENSE.
Built by Frihet.
Available Tools
148 toolsanomaly_listList AnomaliesARead-onlyIdempotent
List HR / operational / financial anomalies detected by the system. Filter by type (duplicate_clock_in, overtime_spike, missing_clock_out, expense_outlier, etc.), severity (low/medium/high/critical), or period. Useful for daily HR review and compliance audits. / Lista anomalias detectadas (RRHH/operativas/financieras) con filtros opcionales.
Inputs: to, from, type, limit, +2 more. Returns: data, limit, total, offset, +1 more
apply_depositApply DepositAIdempotent
Apply a deposit to an invoice or mark it as used. Transitions the deposit status to 'applied'. Example: id='dep_abc123', invoiceId='inv_xyz' / Aplica un deposito a una factura o lo marca como utilizado.
Inputs: id (required), notes, invoiceId. Returns: id, data, meta, message, +1 more
apply_late_feeApply Late FeeA
Apply late payment interest to an overdue invoice. Calculates interest based on EU Late Payment Directive (8% default) or auto-calculates from days overdue. Creates a debit note linked to the original invoice. / Aplica intereses de demora a una factura vencida. Calcula intereses segun la Directiva Europea de Morosidad (8% por defecto) o los calcula automaticamente a partir de los dias de retraso. Crea una nota de debito vinculada a la factura original.
Inputs: invoiceId (required), amount, daysOverdue. Returns: id, data, meta, message, +1 more
attendance_clock_inClock In (Attendance)A
Record an employee clock-in. Optionally captures mood (employee well-being tracking) and location (remote/office/site). Returns an attendance entry with status='open'. Pair with attendance_clock_out to close the entry. / Registra una entrada de fichaje. Captura opcionalmente estado de animo y ubicacion.
Inputs: employeeId (required), mood, location. Returns: id, mood, status, location, +6 more
attendance_clock_outClock Out (Attendance)AIdempotent
Close an open attendance entry. Stamps clockOutAt and computes durationMinutes. Idempotent: clocking out an already-closed entry is a no-op. / Cierra una entrada de fichaje abierta. Calcula la duracion en minutos.
Inputs: entryId (required). Returns: id, mood, status, location, +6 more
categorize_transactionCategorize TransactionAIdempotent
Apply a category to a bank transaction for manual classification. Categories map to expense categories for tax deduction tracking. Example: id='tx_abc', category='supplies', notes='Office paper Q1' / Asigna una categoria a un movimiento bancario. Las categorias se mapean a categorias de gastos para el control de deducciones fiscales.
Inputs: id (required), category (required), notes. Returns: id, amount, status, category, +7 more
create_client_noteCreate Client NoteA
Add a note to a client. Notes are free-form text entries useful for keeping context. Example: clientId='abc123', content='Prefers invoices in English. Payment NET 30.' / Anade una nota a un cliente. Las notas son texto libre para mantener contexto.
Inputs: content (required), clientId (required). Returns: id, content, createdAt, updatedAt
create_credit_noteCreate Credit NoteA
Create a credit note (factura rectificativa) for an existing invoice. This reverses all or part of an invoice for compliance. Spanish market: generates VeriFactu-compliant R1-R5 rectificativa. Other markets: standard credit note with negative amounts. / Crea una factura rectificativa para una factura existente. Mercado espanol: genera rectificativa R1-R5 conforme a VeriFactu. Otros mercados: nota de credito estandar con importes negativos.
Inputs: reason (required), invoiceId (required), issueDate, fullCredit, +1 more. Returns: data, meta, success, creditNote
create_depositCreate DepositA
Record a new deposit from a client. Requires clientId and amount. Useful for tracking advance payments, retainers, and security deposits. Example: clientId='abc123', amount=500, currency='EUR', description='Project retainer' / Registra un nuevo deposito de un cliente. Requiere clientId e importe. Util para adelantos, retenciones y depositos de garantia.
Inputs: amount (required), clientId (required), date, notes, +6 more. Returns: id, date, notes, amount, +9 more
create_invoiceCreate InvoiceA
Create a new invoice. Requires client name and at least one line item. The invoice number is auto-generated. Defaults to draft status and today's date. Example: clientName='Acme Corp', items=[{description:'Consulting', quantity:10, unitPrice:150}], taxRate=21, irpfRate=15 / Crea una nueva factura. Requiere nombre del cliente y al menos un concepto. El numero se genera automaticamente. Por defecto estado borrador y fecha de hoy. Soporta retencion IRPF (autonomos ES), recargo de equivalencia, serie, anticipo y descuento global.
Inputs: items (required), clientName (required), notes, status, +15 more. Returns: id, items, notes, total, +7 more
create_productCreate ProductA
Create a new product or service in the catalog. Requires a name and unit price. Products can be referenced when creating invoices and quotes for faster data entry. Example: name='Web Design', unitPrice=1500, taxRate=21, description='Full website redesign' / Crea un nuevo producto o servicio en el catalogo. Requiere nombre y precio unitario. Los productos se pueden usar al crear facturas y presupuestos para entrada rapida de datos.
Inputs: name (required), unitPrice (required), taxRate, description. Returns: id, name, taxRate, createdAt, +3 more
create_quoteCreate QuoteA
Create a new quote/estimate for a client. Requires client name and at least one line item. Quotes can later be converted to invoices. Defaults to draft status. Example: clientName='Acme Corp', items=[{description:'Design', quantity:1, unitPrice:3000}], validUntil='2026-04-30' / Crea un nuevo presupuesto. Requiere nombre del cliente y al menos un concepto. Los presupuestos se pueden convertir en facturas despues.
Inputs: items (required), clientName (required), notes, status, +10 more. Returns: id, items, notes, total, +5 more
create_recurring_invoiceCreate Recurring InvoiceA
Create a new recurring invoice template. Specify frequency (daily/weekly/monthly/quarterly/yearly), recipient client, line items, and optional start date. The first invoice instance is generated on the next scheduled run date. Example: clientId='cli_abc', frequency='monthly', templateName='Servicio mensual', lineItems=[{description:'SaaS', quantity:1, unitPrice:299}] / Crea una nueva plantilla de factura recurrente. Especifica frecuencia, cliente destinatario, lineas y fecha de inicio opcional. La primera instancia se genera en la proxima fecha programada.
Inputs: clientId (required), frequency (required), lineItems (required), templateName (required), +3 more. Returns: id, status, nextRun, createdAt, +5 more
create_reservationCreate ReservationA
Create a new reservation manually (not via channel sync). Requires property ID, check-in/check-out dates, and guest count. Optionally provide a guest ID or inline guest data to create a new guest. / Crea una nueva reserva manualmente. Requiere propiedad, fechas y numero de huespedes.
Inputs: checkIn (required), checkOut (required), guestCount (required), propertyId (required), +6 more. Returns: id, notes, nights, status, +10 more
create_time_entryCreate Time EntryA
Log a time entry for a project. Requires projectId, hours (decimal), and date. Mark as billable=true to include in client invoicing. Example: projectId='proj_abc', hours=2.5, description='Frontend review', billable=true, date='2026-05-10' / Registra una entrada de tiempo para un proyecto. Requiere projectId, horas (decimal) y fecha. Marca billable=true para incluirlo en la facturacion al cliente.
Inputs: date (required), hours (required), projectId (required), userId, +2 more. Returns: id, date, hours, status, +6 more
create_vendorCreate VendorA
Create a new vendor/supplier. Requires at minimum a name. Vendors are used when tracking expenses and purchase orders. Example: name='Office Supplies Ltd', email='billing@office.com', taxId='B87654321', address={street:'Gran Via 1', city:'Madrid', country:'ES'} / Crea un nuevo proveedor. Requiere como minimo un nombre. Los proveedores se usan al registrar gastos y pedidos de compra.
Inputs: name (required), email, phone, taxId, +1 more. Returns: id, name, email, phone, +4 more
create_webhookCreate WebhookA
Register a new webhook endpoint. You must specify the URL to receive notifications and which events to subscribe to. Available events: invoice.created, invoice.updated, invoice.paid, invoice.deleted, expense.created, expense.updated, expense.deleted, client.created, client.updated, quote.created, quote.updated, quote.accepted. Example: url='https://example.com/webhook', events=['invoice.created','invoice.paid'], secret='my-secret' / Registra un nuevo endpoint de webhook. Especifica la URL y los eventos a suscribir.
Inputs: url (required), events (required), active, secret. Returns: id, url, active, events, +3 more
delete_client_contactDelete Client ContactADestructiveIdempotent
Permanently delete a contact from a client. This action cannot be undone. / Elimina permanentemente un contacto de un cliente. Esta accion no se puede deshacer.
Inputs: clientId (required), contactId (required). Returns: id, success
delete_client_noteDelete Client NoteADestructiveIdempotent
Permanently delete a note from a client. This action cannot be undone. / Elimina permanentemente una nota de un cliente. Esta accion no se puede deshacer.
Inputs: noteId (required), clientId (required). Returns: id, success
delete_depositDelete DepositBDestructiveIdempotent
Permanently delete a deposit by its ID. This action cannot be undone. / Elimina permanentemente un deposito por su ID. Esta accion no se puede deshacer.
Inputs: id (required). Returns: id, success
delete_expenseDelete ExpenseADestructiveIdempotent
Permanently delete an expense by its ID. This action cannot be undone. / Elimina permanentemente un gasto por su ID. Esta accion no se puede deshacer.
Inputs: id (required). Returns: id, success
delete_invoiceDelete InvoiceADestructiveIdempotent
Permanently delete an invoice by its ID. This action cannot be undone. / Elimina permanentemente una factura por su ID. Esta accion no se puede deshacer.
Inputs: id (required). Returns: id, success
delete_productDelete ProductADestructiveIdempotent
Permanently delete a product by its ID. This action cannot be undone. / Elimina permanentemente un producto por su ID. Esta accion no se puede deshacer.
Inputs: id (required). Returns: id, success
delete_quoteDelete QuoteADestructiveIdempotent
Permanently delete a quote by its ID. This action cannot be undone. / Elimina permanentemente un presupuesto por su ID. Esta accion no se puede deshacer.
Inputs: id (required). Returns: id, success
delete_recurring_invoiceDelete Recurring InvoiceADestructiveIdempotent
Permanently delete a recurring invoice template. This does NOT delete previously generated invoices — only the template and future scheduled runs. Requires confirm=true to prevent accidental deletion. / Elimina permanentemente una plantilla de factura recurrente. No elimina facturas ya generadas — solo la plantilla y las ejecuciones futuras. Requiere confirm=true para evitar eliminaciones accidentales.
Inputs: id (required), confirm (required). Returns: id, success
delete_time_entryDelete Time EntryADestructiveIdempotent
Soft-delete a time entry by ID. Requires confirm=true to prevent accidental deletion. Deleted entries are excluded from billing reports but retained for audit. / Elimina (soft-delete) una entrada de tiempo por su ID. Requiere confirm=true para evitar eliminaciones accidentales. Las entradas eliminadas se excluyen de informes de facturacion pero se retienen en auditoria.
Inputs: id (required), confirm (required). Returns: id, success
delete_vendorDelete VendorADestructiveIdempotent
Permanently delete a vendor by their ID. This action cannot be undone. Warning: this may affect existing expenses referencing this vendor. / Elimina permanentemente un proveedor por su ID. Esta accion no se puede deshacer. Advertencia: puede afectar a gastos existentes que referencien este proveedor.
Inputs: id (required). Returns: id, success
delete_webhookDelete WebhookADestructiveIdempotent
Permanently delete a webhook by its ID. Notifications will stop immediately. / Elimina permanentemente un webhook por su ID. Las notificaciones se detendran inmediatamente.
Inputs: id (required). Returns: id, success
duplicate_invoiceDuplicate InvoiceA
Duplicate an existing invoice for a new period. Copies all line items, client data, tax rate, and notes. Strips the original ID, document number, status, and timestamps. The new invoice starts as 'draft' with today's date (or the provided date). Perfect for recurring invoices — duplicate last month's invoice and adjust if needed. / Duplica una factura existente para un nuevo periodo. Copia conceptos, cliente, impuestos y notas. La nueva factura empieza como 'borrador' con fecha de hoy.
Inputs: id (required), newDueDate, newIssueDate. Returns: The newly created draft invoice, cloned from the original / La nueva factura bo…
einvoice_exportExport E-Invoice XMLARead-onlyIdempotent
Export an invoice as e-invoicing XML in a specific format. Supports Facturae (ES B2G), XRechnung-CII (DE), XRechnung-UBL (DE), Factur-X profiles (FR), FatturaPA (IT), PEPPOL-BIS-3 (EU network), UBL and CII (generic). For Facturae, set signed=true to get XAdES-enveloped XML for FACe/AEAT submission. Returns a signed download URL valid for 24 hours.
/ Exporta una factura como XML de facturacion electronica en el formato especificado. Para Facturae con signed=true devuelve XML firmado XAdES para envio a FACe/AEAT.
Inputs: format (required), invoiceId (required), signed. Returns: xml, format, signed, filename, +1 more
export_datevExport DATEVARead-onlyIdempotent
Export accounting data in DATEV EXTF format for import into DATEV Kanzlei-Rechnungswesen or compatible systems. Returns a signed download URL valid for 24 hours.
Supported EXTF formats: • extf-buchungsstapel — Journal entries (Buchungsstapel) — most common, use for P&L/tax • extf-debitoren — Accounts receivable master data (Debitoren-/Kreditorenstamm AR) • extf-kreditoren — Accounts payable master data (Debitoren-/Kreditorenstamm AP)
Output encoding is always CP1252 per DATEV EXTF specification. Date range: both periodStart and periodEnd must be ISO 8601 dates (YYYY-MM-DD).
If the DATEV export backend is not deployed for this workspace, returns an honest 'unavailable' response — never a fabricated file URL. / Exporta datos contables en formato DATEV EXTF para importacion en DATEV o sistemas compatibles.
Inputs: format (required), periodEnd (required), periodStart (required). Returns: fileUrl, encoding, filename, rowCount, +1 more
face_statusGet FACe Submission StatusARead-onlyIdempotent
Poll the status of a FACe (Spain B2G) invoice submission. Returns the current FACe portal state code, description, and the registro number.
Common FACe status codes: • 1200 — Registrada / Registered (submission received) • 1300 — En proceso de contabilización / In accounting (being processed) • 1400 — Contabilizada / Accounted (approved, awaiting payment) • 2400 — Anulada / Cancelled • 3100 — Rechazada / Rejected (check rejectionReason)
/ Consulta el estado de un envío a FACe. Devuelve el código de estado, descripción y número de registro.
Inputs: invoiceId (required). Returns: codigo, motivo, descripcion, numeroRegistro, +1 more
face_submitSubmit to FACe (Spain B2G)A
Submit a Facturae-formatted invoice to the Spanish FACe (Punto General de Entrada de Facturas Electrónicas) B2G portal. The invoice must have a recipient with DIR3 administrative unit codes (órgano gestor, unidad tramitadora, oficina contable). Returns a submission reference (registro) that can be used with face_status to poll the portal.
Modes: • mock — local simulation only, no network call (safe for dev/test) • sandbox — FACe pre-production endpoint (requires sandbox credentials) • production — live FACe SOAP endpoint (default)
/ Envía una factura Facturae al portal FACe del Estado español. Requiere códigos DIR3 en el destinatario (órgano gestor, unidad tramitadora, oficina contable). Devuelve el número de registro para consulta de estado con face_status.
Inputs: invoiceId (required), mode. Returns: codigo, status, idempotent, descripcion, +1 more
frihet_aiem_calculateCalculate AIEM (Arbitrio Importación Canarias)ARead-onlyIdempotent
Calculate the AIEM (Arbitrio sobre Importaciones y Entrega de Mercancias) for goods imported to or produced in the Canary Islands. Returns applicable AIEM rate, tax base, and amount due for the given product. AIEM is a Canarian surcharge on top of IGIC for protected local industries. Example: ncCode='8471', amount=1000, description='Ordenadores portatiles'. / Calcula el AIEM para mercancias importadas o producidas en Canarias. Devuelve tipo aplicable, base imponible y cuota. El AIEM protege la industria local canaria.
Inputs: amount (required), ncCode (required), description. Returns: AIEM calculation result: applicable rate, tax base and amount due / Resultado A…
frihet_bank_rule_createCreate Bank Categorization RuleA
Create a new bank auto-categorization rule. Rules apply automatically to matching incoming transactions. A rule has conditions (AND logic) and actions (assign category, tag, or client). Example: name='Mercadona groceries', condition description contains 'MERCADONA', action category='groceries'. / Crea una nueva regla de categorizacion automatica de transacciones bancarias. Las reglas aplican condiciones (logica AND) y acciones (categoria, etiqueta, cliente).
Inputs: name (required), actions (required), conditions (required), isActive. Returns: Created bank rule record with ID, conditions and actions / Regla bancaria cread…
frihet_bank_rules_listList Bank Categorization RulesARead-onlyIdempotent
List all bank auto-categorization rules for the workspace. Rules automatically categorize transactions matching conditions (description, amount, counterparty). Returns rule name, conditions, actions (category/tag/client assign), and active status. / Lista las reglas de categorizacion automatica de transacciones bancarias del workspace. Devuelve nombre, condiciones, acciones (categoria/etiqueta/cliente) y estado activo.
Inputs: limit, offset, isActive. Returns: data, limit, total, offset, +1 more
frihet_gl_entry_approveApprove GL EntryAIdempotent
Approve a General Ledger journal entry pending review. Sets entry status to 'approved' and records the approver + timestamp in the audit trail. Requires gestor/admin role. This is a TRUST AREA action — double-check entry ID before calling. Example: entryId='gl_2026_q1_042'. / Aprueba un asiento contable pendiente de revision. Requiere rol gestor/admin. Accion de area de confianza.
Inputs: entryId (required), notes. Returns: Approved GL entry record with new status and audit trail entry / Asiento contab…
frihet_gl_entry_audit_logGet GL Entry Audit LogARead-onlyIdempotent
Retrieve the full audit trail for a General Ledger entry — all state transitions (created, submitted, approved, rejected), who acted, and when. Use this to investigate approval history or compliance audits. Example: entryId='gl_2026_q1_042'. / Obtiene el historial de auditoría completo de un asiento contable. Muestra todas las transiciones de estado, quien actuo y cuando.
Inputs: entryId (required). Returns: Audit trail entries for the GL entry (state transitions, actor, timestamp) / Hi…
frihet_gl_entry_rejectReject GL EntryAIdempotent
Reject a General Ledger journal entry pending review with a required reason. Sets entry status to 'rejected' and records the rejector + reason in the audit trail. Requires gestor/admin role. This is a TRUST AREA action. Example: entryId='gl_2026_q1_042', reason='Importe incorrecto, revisar factura F-2026-042'. / Rechaza un asiento contable pendiente con una razon obligatoria. Requiere rol gestor/admin.
Inputs: reason (required), entryId (required). Returns: Rejected GL entry record with reason and audit trail entry / Asiento contable r…
frihet_modelo_200_summaryGet Modelo 200 Summary (Corporate Tax — Annual IS)ARead-onlyIdempotent
Get Modelo 200 summary — annual corporate income tax return (Impuesto sobre Sociedades) for Spanish SLs and SAs. Returns taxable base, deductions, tax rate, withholdings, installment payments made (M202), and net payable/refundable. Filing deadline: 25 days after 6 months from fiscal year end (typically 25 July for Dec FY). Example: year='2025'. / Resumen Modelo 200 — declaracion anual del Impuesto sobre Sociedades para SL/SA. Devuelve base imponible, deducciones, tipo, retenciones, pagos fraccionados y cuota.
Inputs: year. Returns: Modelo 200 annual corporate tax summary: taxable base, deductions, rate, net pa…
frihet_modelo_202_summaryGet Modelo 202 Summary (Corporate Tax — Installment Payments)ARead-onlyIdempotent
Get Modelo 202 summary — installment payments (pagos fraccionados) for Impuesto sobre Sociedades. Three annual payments: April (1P), October (2P), December (3P). Returns each installment amount, due date, payment status, and cumulative total vs M200 projection. Example: year='2026', installment='1P'. / Resumen Modelo 202 — pagos fraccionados del Impuesto sobre Sociedades. Tres plazos: abril (1P), octubre (2P), diciembre (3P). Devuelve importes, plazos y estado de pago.
Inputs: year, installment. Returns: Modelo 202 installment payments: amounts, due dates, payment status / Pagos fra…
frihet_modelo_415_summaryGet Modelo 415 Summary (IGIC Annual Operations >€3,005)ARead-onlyIdempotent
Get IGIC Modelo 415 summary — annual declaration of operations with third parties exceeding €3,005. Canary Islands equivalent of Modelo 347 (peninsular Spain). Returns counterparty list, operation totals, and filing deadline. Example: year='2025'. / Resumen del Modelo 415 IGIC — declaracion anual de operaciones con terceros > €3.005. Equivalente canario del Modelo 347. Devuelve listado de contrapartes, totales y plazo.
Inputs: year. Returns: Modelo 415 summary: counterparty operations, totals and filing deadline / Resum…
frihet_modelo_418_summaryGet Modelo 418 Summary (IGIC Monthly Large Enterprises)ARead-onlyIdempotent
Get IGIC Modelo 418 summary — monthly IGIC return for large enterprises (grandes empresas) in the Canary Islands. Returns monthly IGIC collected, deductible, net due, and any carryover. Applicable when annual turnover exceeds the grandes empresas threshold. Example: period='2026-04'. / Resumen del Modelo 418 IGIC — declaracion mensual para grandes empresas en Canarias. Devuelve IGIC repercutido, soportado, cuota a ingresar y saldo a compensar.
Inputs: period. Returns: Modelo 418 monthly IGIC summary: collected, deductible, net due, carryover / Re…
frihet_modelo_425_summaryGet Modelo 425 Summary (IGIC Annual Recap)ARead-onlyIdempotent
Get IGIC Modelo 425 summary — annual IGIC recap for Canary Islands businesses. Returns aggregated IGIC collected, deductible IGIC, net payable, and filing status. Example: year='2025'. / Resumen del Modelo 425 IGIC — resumen anual IGIC para empresas canarias. Devuelve IGIC repercutido, IGIC soportado, cuota neta y estado de presentacion.
Inputs: year. Returns: Modelo 425 annual IGIC recap: IGIC collected, deductible, net payable / Resumen…
frihet_portal_domain_addAdd Custom Portal DomainA
Add a custom domain to the Frihet client portal for white-label branding. Returns DNS records (CNAME) that must be configured at the registrar before verification. Example: domain='portal.miempresa.com'. / Agrega un dominio personalizado al portal de clientes Frihet para marca blanca. Devuelve los registros DNS (CNAME) que deben configurarse en el registrador antes de verificar.
Inputs: domain (required), workspaceId. Returns: Added domain record with required DNS (CNAME) records / Dominio añadido con los…
frihet_portal_domain_removeRemove Custom Portal DomainADestructiveIdempotent
Remove a custom domain from the Frihet client portal. The portal will revert to the default Frihet subdomain. Example: domain='portal.miempresa.com'. / Elimina un dominio personalizado del portal de clientes Frihet. El portal volverá al subdominio predeterminado de Frihet.
Inputs: domain (required). Returns: Confirmation that the custom domain was removed / Confirmación de que el domini…
frihet_portal_domain_verifyVerify Custom Portal DomainARead-onlyIdempotent
Verify DNS propagation for a custom portal domain added via frihet_portal_domain_add. Returns verification status (pending/verified/failed) and any DNS errors. DNS propagation can take up to 48 hours — retry if status is 'pending'. Example: domain='portal.miempresa.com'. / Verifica la propagacion DNS de un dominio de portal personalizado. Devuelve estado (pending/verified/failed). La propagacion puede tardar hasta 48h.
Inputs: domain (required). Returns: Domain verification status (pending/verified/failed) and any DNS errors / Estad…
frihet_portal_onboard_link_generateGenerate Portal Self-Onboard LinkA
Generate a time-limited, single-use self-onboard invitation link for a prospective client. The client follows the link to register their company details (CIF, address, contact) without requiring manual data entry by the gestor. Requires gestor/admin role. Example: email='cliente@empresa.com', expiresInHours=72. / Genera un enlace de auto-registro para un cliente potencial. El cliente completa sus datos sin que el gestor tenga que introducirlos manualmente. Requiere rol gestor/admin.
Inputs: email (required), name, workspaceId, expiresInHours. Returns: Generated self-onboard link with expiry and token / Enlace de auto-registro gen…
frihet_tax_id_vies_lookupLookup Tax ID via VIES (EU VAT Validation)ARead-onlyIdempotent
Validate an EU VAT number (CIF intracomunitario) via the VIES (VAT Information Exchange System). Returns company name, address, and validity status from the official EU registry. Essential for intra-EU invoicing compliance — always validate before adding a EU client. Example: vatNumber='ES12345678A', countryCode='ES'. / Valida un numero de IVA intracomunitario (CIF) via el sistema VIES de la UE. Devuelve nombre, direccion y validez desde el registro oficial europeo.
Inputs: vatNumber (required), countryCode (required). Returns: VIES lookup result: company name, address and validity status / Resultado VIES:…
gestoria_aging_consolidatedConsolidated AR Aging (Gestoria)ARead-onlyIdempotent
Get a cross-client AR aging report for a gestor — totals bucketed by current / 30-60 / 60-90 / 90+ days overdue, a per-workspace breakdown, and the top overdue invoices. Defaults to the authenticated gestor; pass ownerUid to query a specific gestor (requires elevated scope). Useful for dunning prioritisation and end-of-month chase lists. / Obtiene un informe de antiguedad de saldos cruzando todos los clientes del gestor — totales por tramo (al dia / 30-60 / 60-90 / 90+ dias), desglose por espacio y top vencidas. Util para priorizar reclamaciones y listas de cobro de fin de mes.
Inputs: ownerUid. Returns: totals, topOverdue, byWorkspace, generatedAt
gestoria_message_sendSend Gestoria MessageA
Send a message in a contextual thread between a gestor (accountant) and a client. Threads attach to a document request, a filing item, or a fiscal obligation — context is preserved so both sides see what the message is about. Useful for chasing a missing document, replying to a client's question, or annotating a presentation. Example: workspaceId='ws_abc', parentType='documentRequest', parentId='dr_q3_iva', body='Falta el extracto bancario de septiembre'. / Envia un mensaje en un hilo contextual entre gestor y cliente. Los hilos se anclan a una solicitud de documento, presentacion o obligacion fiscal — ambas partes ven a que se refiere. Util para pedir documentos, responder dudas o anotar presentaciones.
Inputs: body (required), parentId (required), parentType (required), workspaceId (required). Returns: createdAt, messageId, unreadCounts
gestoria_messages_listList Gestoria MessagesARead-onlyIdempotent
List messages in a contextual gestor/cliente thread, newest first. Use before (message ID or ISO timestamp) to paginate backwards through history. Returns up to limit messages plus a hasMore flag so the agent knows when to stop. / Lista los mensajes de un hilo gestor/cliente, mas recientes primero. Usa before (ID o fecha) para paginar hacia atras. Devuelve hasta limit mensajes con flag hasMore.
Inputs: parentId (required), parentType (required), workspaceId (required), limit, +1 more. Returns: hasMore, messages
gestoria_template_bulk_sendBulk Send Gestoria TemplateA
Send the same document request template to up to 500 client workspaces in one call. Each spawned request triggers the per-client notification handler (email + in-app). Honours allowGestoriaCommunications=false on the client user doc (opt-out). Uses periodOverrides to plug runtime values (quarter/year/month) into template variables. Returns a per-client outcome with success count, failures, and total wall-clock duration. Trust Area: RGPD — recipients must already have granted accountant access. Example: templateId='tpl_iva_q', clientWorkspaceIds=['ws_a','ws_b','ws_c'], periodOverrides={quarter:3, year:2026}. / Envia la misma plantilla a hasta 500 espacios cliente en una sola operacion. Respeta opt-out allowGestoriaCommunications=false.
Inputs: templateId (required), clientWorkspaceIds (required), periodOverrides. Returns: failed, success, totalDuration
gestoria_template_createCreate Gestoria TemplateA
Create a reusable document request template that the gestor can bulk-send to many client workspaces. Template body supports plain-text variable interpolation (e.g. {{quarter}}, {{year}}). dueDateOffsetDays sets when the request is due relative to the bulk-send date. attachmentRequired=true enforces clients to upload a file before marking complete. Example: name='IVA trimestral', title='Documentacion IVA {{quarter}}/{{year}}', description='Adjunta extractos bancarios y facturas emitidas del {{quarter}}', dueDateOffsetDays=14, attachmentRequired=true. / Crea una plantilla de solicitud de documento reutilizable que el gestor puede enviar en masa a varios espacios cliente.
Inputs: name (required), title (required), description (required), dueDateOffsetDays (required), +2 more. Returns: templateId
get_bank_accountGet Bank AccountARead-onlyIdempotent
Get a single connected bank account by ID. Returns alias, IBAN (last 4 digits), currency, current balance, and last sync timestamp. / Obtiene una cuenta bancaria conectada por su ID. Devuelve alias, IBAN (ultimos 4 digitos), divisa, saldo actual y ultima sincronizacion.
Inputs: id (required). Returns: id, alias, balance, currency, +4 more
get_clientGet ClientARead-onlyIdempotent
Get a single client by their ID. Returns full contact details. / Obtiene un cliente por su ID. Devuelve todos los datos de contacto.
Inputs: id (required). Returns: id, name, email, phone, +4 more
get_depositGet DepositARead-onlyIdempotent
Get a single deposit by its ID. / Obtiene un deposito por su ID.
Inputs: id (required). Returns: id, date, notes, amount, +9 more
get_einvoice_statusGet E-Invoice StatusARead-onlyIdempotent
Poll the status of an e-invoice dispatch workflow. Returns current step, ack ID (network confirmation), and download URLs once complete. Poll every 5–10 seconds until status is 'succeeded', 'failed', or 'cancelled'.
If the status backend is not deployed for this workspace, returns an honest 'unavailable' response — never a fabricated status. / Consulta el estado de un flujo de envio de factura electronica.
Inputs: workflowRunId (required). Returns: step, ackId, error, status, +2 more
get_invoiceGet InvoiceARead-onlyIdempotent
Get a single invoice by its ID. Returns the full invoice including line items, totals, and status. / Obtiene una factura por su ID. Devuelve la factura completa con conceptos, totales y estado.
Inputs: id (required). Returns: id, items, notes, total, +7 more
get_invoice_pdfGet Invoice PDFARead-onlyIdempotent
Get the PDF for an invoice. Returns a URL to download the PDF or binary info. / Obtiene el PDF de una factura. Devuelve una URL de descarga o informacion del binario.
Inputs: id (required). Returns: id, url, contentType
get_kitchen_ticketGet Kitchen TicketARead-onlyIdempotent
Get a single kitchen ticket by ID. Returns full ticket details including all items, their individual statuses, station assignment, and table reference. / Obtiene un ticket de cocina por ID. Devuelve todos los detalles: items, estados individuales, estacion asignada y referencia de mesa.
Inputs: id (required). Returns: id, items, status, tableRef, +3 more
get_modelo_130_summaryGet Modelo 130 Summary (IRPF Estimated Payment)ARead-onlyIdempotent
Get IRPF estimated payment summary for Modelo 130 filing (freelancers/self-employed in Spain). Returns quarterly net income, deductible expenses, previous payments, and amount due. Example: period='2026-Q1' / Obtiene el resumen del pago fraccionado IRPF para el Modelo 130 (autonomos). Devuelve rendimiento neto, gastos deducibles, pagos previos y cuota a ingresar.
Inputs: period. Returns: note, model, months, period, +10 more
get_modelo_180_summaryGet Modelo 180 Summary (IRPF Rentals Annual)ARead-onlyIdempotent
Get IRPF annual informative summary for rental income withholdings (Modelo 180, Spain). Returns total retentions per tenant, property, and annual aggregate. Example: period='2025' / Obtiene el resumen anual de retenciones sobre alquileres para el Modelo 180. Devuelve retenciones totales por inquilino, inmueble y agregado anual.
Inputs: period. Returns: note, model, months, period, +10 more
get_modelo_303_summaryGet Modelo 303 Summary (IVA Quarterly)ARead-onlyIdempotent
Get IVA (VAT) quarterly summary for Modelo 303 filing in Spain. Returns aggregated totals by tax rate, deductible IVA, net amount due, and filing deadline. Example: period='2026-Q1' / Obtiene el resumen trimestral del IVA para el Modelo 303 en Espana. Devuelve totales por tipo impositivo, IVA deducible, cuota a ingresar y plazo.
Inputs: period. Returns: note, model, months, period, +10 more
get_modelo_347_summaryGet Modelo 347 Summary (Operations >€3,005 Annual Recap)ARead-onlyIdempotent
Get annual informative summary of operations exceeding €3,005 per counterparty (Modelo 347, Spain). Returns per-party totals for clients and vendors above the threshold. Example: period='2025' / Obtiene el resumen anual de operaciones con terceros superiores a 3.005€ (Modelo 347). Devuelve totales por cliente/proveedor que superen el umbral.
Inputs: period. Returns: note, model, months, period, +10 more
get_modelo_390_summaryGet Modelo 390 Summary (IVA Annual Recap)ARead-onlyIdempotent
Get IVA annual summary for Modelo 390 filing in Spain. Returns full-year totals by rate, total deductible IVA, and annual balance. Example: period='2025' / Obtiene el resumen anual del IVA para el Modelo 390. Devuelve totales anuales por tipo, IVA deducible total y resultado anual.
Inputs: period. Returns: note, model, months, period, +10 more
get_monthly_summaryGet Monthly SummaryARead-onlyIdempotent
Get complete monthly financial summary — revenue, expenses, profit, tax liability, invoice stats, expense breakdown by category. Defaults to current month. Use this to answer questions about financial performance, cash flow, or monthly P&L. / Resumen financiero mensual completo — ingresos, gastos, beneficio, impuestos, estadisticas de facturas, desglose de gastos por categoria. Por defecto el mes actual.
Inputs: month. Returns: Monthly P&L summary: revenue, expenses, profit, tax liability, invoice stats /…
get_productGet ProductARead-onlyIdempotent
Get a single product/service by its ID. / Obtiene un producto/servicio por su ID.
Inputs: id (required). Returns: id, name, taxRate, createdAt, +3 more
get_quoteGet QuoteARead-onlyIdempotent
Get a single quote/estimate by its ID. Returns the full quote with line items and totals. / Obtiene un presupuesto por su ID. Devuelve el presupuesto completo con conceptos y totales.
Inputs: id (required). Returns: id, items, notes, total, +5 more
get_recurring_invoiceGet Recurring InvoiceARead-onlyIdempotent
Get full details of a recurring invoice template by ID. Returns template name, frequency, next run date, recipient, line items, and active/paused status. / Obtiene los detalles completos de una plantilla de factura recurrente por ID. Devuelve nombre, frecuencia, proxima ejecucion, destinatario, lineas y estado.
Inputs: id (required). Returns: id, status, nextRun, createdAt, +5 more
get_reservationGet ReservationARead-onlyIdempotent
Get a single reservation by ID. Returns full booking details: guest, property, dates, channel, payment status, and notes. / Obtiene una reserva por ID. Devuelve todos los detalles de la reserva.
Inputs: id (required). Returns: id, notes, nights, status, +10 more
get_saleGet POS SaleARead-onlyIdempotent
Get a single POS sale by ID. Returns full sale details: terminal, items, payment method, amounts, and status. / Obtiene una venta POS por ID. Devuelve todos los detalles: terminal, articulos, metodo de pago, importes y estado.
Inputs: id (required). Returns: id, items, status, currency, +6 more
get_time_entryGet Time EntryARead-onlyIdempotent
Get full details of a single time tracking entry by ID. Returns project, user, hours, description, billable flag, date and status. / Obtiene los detalles completos de una entrada de tiempo por su ID. Devuelve proyecto, usuario, horas, descripcion, facturabilidad, fecha y estado.
Inputs: id (required). Returns: id, date, hours, status, +6 more
get_time_summaryGet Time SummaryARead-onlyIdempotent
Get aggregated time tracking summary for a workspace or specific team member. Returns total hours, billable hours, non-billable hours, and estimated cost for the period. Filter by date range and optionally by user ID for per-member breakdowns. / Obtiene el resumen agregado de seguimiento de tiempo para el espacio de trabajo o un miembro. Devuelve horas totales, facturables, no facturables y coste estimado del periodo. Filtra por rango de fechas y opcionalmente por usuario para desglose por miembro.
Inputs: to (required), from (required), userId, groupBy, +1 more. Returns: to, from, groups, totalHours, +3 more
get_vendorGet VendorARead-onlyIdempotent
Get a single vendor/supplier by their ID. Returns full contact details. / Obtiene un proveedor por su ID. Devuelve todos los datos de contacto.
Inputs: id (required). Returns: id, name, email, phone, +4 more
get_webhookGet WebhookARead-onlyIdempotent
Get a single webhook configuration by its ID. / Obtiene la configuracion de un webhook por su ID.
Inputs: id (required). Returns: id, url, active, events, +3 more
invite_team_memberInvite Team MemberA
Invite a new member to the workspace by email address. An invitation email is sent — the member must accept before gaining access. Roles: owner (full access), admin (manage account, no billing), member (operational access), viewer (read-only). Example: email='ana@example.com', role='member' / Invita a un nuevo miembro al espacio de trabajo por correo electronico. Se envia un email de invitacion — el miembro debe aceptar antes de acceder. Roles: owner (acceso total), admin (gestion sin facturacion), member (acceso operativo), viewer (solo lectura).
Inputs: role (required), email (required), name. Returns: id, name, role, email, +5 more
kitchen_flow_summaryKitchen Flow SummaryARead-onlyIdempotent
Slow-station detection: aggregates open kitchen tickets per station and flags the bottleneck (station with the highest open-ticket count). Returns per-station openTickets count, oldest wait time in seconds, and an isBottleneck flag. Call this first to diagnose kitchen throughput issues before drilling into individual tickets. / Deteccion de cuello de botella: agrega tickets abiertos por estacion y marca la mas saturada. Devuelve openTickets, tiempo de espera mas antiguo y flag isBottleneck por estacion. Llamar primero para diagnosticar problemas de rendimiento de cocina.
Inputs: no named parameters. Returns: stations, generatedAt, totalOpenTickets, bottleneckStationId
ksef_submitSubmit to KSeF (Poland)A
Submit an invoice to the Polish KSeF (Krajowy System e-Faktur) national e-invoicing system. Poland requires e-invoicing for B2B transactions (mandatory phase rolling out 2025).
Modes: • mock — local simulation (no network call, safe for dev/test) • sandbox — KSeF test environment (demo.ksef.mf.gov.pl) • production — live KSeF endpoint (ksef.mf.gov.pl)
NOTE: This tool is a forward-compatible stub. The KSeF transport is infra-ready in Frihet-ERP but not yet exposed as a live public endpoint (production gated on KSeF cert issuance). Until activated, all calls return a NotImplementedYet error with guidance. / NOTA: Este tool es un stub anticipatorio. El transporte KSeF está infra-ready en Frihet-ERP pero aún no expuesto como endpoint público (producción pendiente del certificado KSeF). Hasta su activación, todas las llamadas devuelven un error NotImplementedYet con instrucciones.
Inputs: invoiceId (required), mode. Returns: mode, _note, invoiceId, _notImplemented, +1 more
leave_approveApprove Leave RequestAIdempotent
TRUST AREA — HR DECISION. Approve a pending leave request. Logs decision with timestamp and approver. Idempotent: re-approving an already approved leave is a no-op. / AREA DE CONFIANZA — DECISION RRHH. Aprueba una solicitud de permiso pendiente. Registra la decision.
Inputs: leaveId (required), reason. Returns: id, type, reason, status, +9 more
leave_cancelCancel Leave RequestAIdempotent
Cancel a leave request. Typically used by the requesting employee before approval, or by HR after approval (which may trigger schedule rollback). / Cancela una solicitud de permiso (por el empleado o RRHH).
Inputs: leaveId (required). Returns: id, type, reason, status, +9 more
leave_listList Leave RequestsARead-onlyIdempotent
List leave/PTO requests with optional filters. Filter by employee, status (pending/approved/rejected/cancelled), or period (date range). Useful for HR dashboards, calendar views, balance tracking. / Lista solicitudes de permisos con filtros opcionales (empleado, estado, periodo).
Inputs: to, from, after, limit, +3 more. Returns: data, limit, total, offset, +1 more
leave_rejectReject Leave RequestAIdempotent
TRUST AREA — HR DECISION. Reject a pending leave request with a required reason. Reason is mandatory for transparency and labor-law compliance. / AREA DE CONFIANZA — DECISION RRHH. Rechaza una solicitud con motivo obligatorio.
Inputs: reason (required), leaveId (required). Returns: id, type, reason, status, +9 more
leave_request_createCreate Leave RequestA
Create a new leave/PTO request for an employee. Types: 'vacation', 'sick', 'personal', 'parental', 'unpaid', 'training'. Dates must be ISO 8601 (YYYY-MM-DD). Status starts as 'pending' awaiting manager approval. / Crea una nueva solicitud de vacaciones/permiso. Estado inicial 'pending' pendiente aprobacion.
Inputs: type (required), endDate (required), startDate (required), employeeId (required), +1 more. Returns: id, type, reason, status, +9 more
list_bank_accountsList Bank AccountsARead-onlyIdempotent
List all connected bank accounts for the workspace. Returns alias, IBAN (last 4 digits only for security), currency, balance, and last sync timestamp. / Lista todas las cuentas bancarias conectadas al espacio de trabajo. Devuelve alias, IBAN (solo ultimos 4 digitos por seguridad), divisa, saldo y ultima sincronizacion.
Inputs: limit, offset. Returns: data, limit, total, offset, +1 more
list_client_activitiesList Client ActivitiesARead-onlyIdempotent
List all CRM activities for a client with optional pagination. Returns calls, emails, meetings, and tasks logged against the client. / Lista todas las actividades CRM de un cliente con paginacion opcional.
Inputs: clientId (required), limit, offset. Returns: data, limit, total, offset, +1 more
list_client_contactsList Client ContactsARead-onlyIdempotent
List all contacts for a client with optional pagination. Returns name, email, phone, role, and primary flag. / Lista todos los contactos de un cliente con paginacion opcional.
Inputs: clientId (required), limit, offset. Returns: data, limit, total, offset, +1 more
list_client_notesList Client NotesBRead-onlyIdempotent
List all notes for a client with optional pagination. / Lista todas las notas de un cliente con paginacion opcional.
Inputs: clientId (required), limit, offset. Returns: data, limit, total, offset, +1 more
list_clientsList ClientsARead-onlyIdempotent
List all clients/customers with optional pagination. Returns contact info, tax IDs, and addresses. / Lista todos los clientes con paginacion opcional. Devuelve informacion de contacto, NIF/CIF y direcciones.
Inputs: q, after, limit, stage, +2 more. Returns: data, limit, total, offset, +1 more
list_depositsList DepositsARead-onlyIdempotent
List all deposits with optional pagination and date range filters. Returns deposits sorted by date (newest first). Example: from='2026-01-01', to='2026-03-31', clientId='abc', limit=50 / Lista todos los depositos con paginacion y filtros de fecha opcionales.
Inputs: to, from, after, limit, +4 more. Returns: data, limit, total, offset, +1 more
list_expensesList ExpensesARead-onlyIdempotent
List all expenses with optional pagination and date range filters. Returns expenses sorted by date (newest first). Example: from='2026-01-01', to='2026-03-31', limit=50 / Lista todos los gastos con paginacion y filtros de fecha opcionales.
Inputs: to, from, after, limit, +4 more. Returns: data, limit, total, offset, +1 more
list_invoicesList InvoicesBRead-onlyIdempotent
List all invoices with optional pagination and filters. Returns a paginated list sorted by issue date (newest first). Supports filtering by status (draft/sent/paid/overdue/cancelled) and date range. Example: status='paid', from='2026-01-01', to='2026-03-31', limit=20 / Lista facturas con paginacion y filtros opcionales. Soporta filtrado por estado y rango de fechas.
Inputs: to, from, after, limit, +5 more. Returns: data, limit, total, offset, +1 more
list_kitchen_stationsList Kitchen StationsARead-onlyIdempotent
List all kitchen stations. Returns station id, name, and active status. Use kitchen_flow_summary to see per-station ticket load and bottlenecks. / Lista todas las estaciones de cocina. Devuelve id, nombre y estado activo. Usa kitchen_flow_summary para ver carga por estacion y cuellos de botella.
Inputs: limit, offset. Returns: data, limit, total, offset, +1 more
list_kitchen_ticketsList Kitchen TicketsARead-onlyIdempotent
List all kitchen order tickets for the live order board, with optional filters by status or station. Returns ticket id, station, status, table ref, and items. / Lista todos los tickets de cocina del panel en vivo, con filtros opcionales por estado o estacion. Devuelve id, estacion, estado, mesa e items.
Inputs: after, limit, offset, status, +1 more. Returns: data, limit, total, offset, +1 more
list_productsList ProductsARead-onlyIdempotent
List all products/services with optional pagination. Products are reusable items that can be added to invoices and quotes. / Lista todos los productos/servicios con paginacion opcional. Los productos son conceptos reutilizables para facturas y presupuestos.
Inputs: q, after, limit, fields, +2 more. Returns: data, limit, total, offset, +1 more
list_propertiesList PropertiesBRead-onlyIdempotent
List all rental properties for the workspace. Returns name, address, capacity, owner info, and license number. / Lista todas las propiedades de alquiler vacacional. Devuelve nombre, direccion, capacidad, datos del propietario y numero de licencia.
Inputs: q, after, limit, fields, +2 more. Returns: data, limit, total, offset, +1 more
list_quotesList QuotesARead-onlyIdempotent
List all quotes/estimates with optional pagination and filters. Quotes are proposals sent to clients before they become invoices. Supports filtering by status (draft/sent/accepted/rejected/expired) and date range. Example: status='sent', from='2026-01-01', limit=20 / Lista todos los presupuestos con paginacion y filtros opcionales. Soporta filtrado por estado y rango de fechas.
Inputs: to, from, after, limit, +5 more. Returns: data, limit, total, offset, +1 more
list_recurring_invoicesList Recurring InvoicesARead-onlyIdempotent
List all recurring invoice templates. Returns template name, frequency, next scheduled run date, recipient, line items, and active/paused status. / Lista todas las plantillas de facturas recurrentes. Devuelve nombre de la plantilla, frecuencia, proxima fecha de ejecucion, destinatario, lineas y estado.
Inputs: limit, offset, status. Returns: data, limit, total, offset, +1 more
list_reservationsList ReservationsARead-onlyIdempotent
List all reservations for the workspace, with optional filters by property, status, or date range. Returns guest, dates, channel, and total. / Lista todas las reservas del espacio de trabajo, con filtros opcionales por propiedad, estado o rango de fechas.
Inputs: after, limit, fields, offset, +4 more. Returns: data, limit, total, offset, +1 more
list_salesList POS SalesARead-onlyIdempotent
List POS sales with optional filters by date range, terminal, or status. / Lista las ventas POS con filtros opcionales por fecha, terminal o estado.
Inputs: to, from, after, limit, +3 more. Returns: data, limit, total, offset, +1 more
list_team_membersList Team MembersARead-onlyIdempotent
List all members in the workspace. Returns member ID, name, email, role, and invite status (pending/active). Useful for access management and auditing who has access to the account. / Lista todos los miembros del espacio de trabajo. Devuelve ID, nombre, email, rol y estado de invitacion (pendiente/activo). Util para gestion de accesos y auditoria de quien tiene acceso a la cuenta.
Inputs: role, limit, offset, status. Returns: data, limit, total, offset, +1 more
list_terminalsList POS TerminalsARead-onlyIdempotent
List all configured POS terminals (Stripe Terminal readers) for the workspace. Returns terminal label, device type, location, and connection status. / Lista todos los terminales de punto de venta (lectores Stripe Terminal). Devuelve etiqueta, tipo de dispositivo, ubicacion y estado de conexion.
Inputs: limit, offset, locationId. Returns: data, limit, total, offset, +1 more
list_time_entriesList Time EntriesARead-onlyIdempotent
List time tracking entries with optional filters. Filter by user, project, date range, or billable status. Useful for generating timesheets, billing reports, and project cost analysis. / Lista entradas de tiempo con filtros opcionales. Filtra por usuario, proyecto, rango de fechas o facturabilidad. Util para partes de trabajo, informes de facturacion y analisis de costes por proyecto.
Inputs: to, from, after, limit, +4 more. Returns: data, limit, total, offset, +1 more
list_transactionsList Bank TransactionsARead-onlyIdempotent
List bank transactions with optional filters. Filter by account, date range, status (pending/posted/excluded), or category. Useful for reconciliation, expense matching, and cash flow analysis. / Lista movimientos bancarios con filtros opcionales. Filtra por cuenta, rango de fechas, estado (pendiente/contabilizado/excluido) o categoria. Util para conciliacion, asignacion de gastos y analisis de flujo de caja.
Inputs: to, from, after, limit, +4 more. Returns: data, limit, total, offset, +1 more
list_vendorsList VendorsARead-onlyIdempotent
List all vendors/suppliers with optional pagination and search. Returns contact info, tax IDs, and addresses. / Lista todos los proveedores con paginacion y busqueda opcional. Devuelve informacion de contacto, NIF/CIF y direcciones.
Inputs: q, after, limit, fields, +1 more. Returns: data, limit, total, offset, +1 more
list_webhooksList WebhooksBRead-onlyIdempotent
List all configured webhooks. Webhooks send HTTP POST notifications when events occur in Frihet. / Lista todos los webhooks configurados. Los webhooks envian notificaciones HTTP POST cuando ocurren eventos en Frihet.
Inputs: limit, offset. Returns: data, limit, total, offset, +1 more
log_client_activityLog Client ActivityB
Log a CRM activity against a client. Use to track calls, emails, meetings, or tasks. Example: clientId='abc123', type='call', title='Discussed Q2 proposal', description='Client interested in upgrade' / Registra una actividad CRM para un cliente. Usa para rastrear llamadas, emails, reuniones o tareas.
Inputs: type (required), title (required), clientId (required), date, +1 more. Returns: id, date, type, title, +3 more
match_transaction_to_invoiceMatch Transaction to InvoiceAIdempotent
TRUST AREA — RECONCILIATION. Link a bank transaction to an invoice or expense document. This affects fiscal reconciliation records. Requires confirm=true to proceed. Idempotent: re-matching to same document is a no-op. Example: transactionId='tx_abc', documentId='inv_xyz', documentType='invoice', confirm=true / AREA DE CONFIANZA — CONCILIACION. Vincula un movimiento bancario a una factura o gasto. Afecta registros de conciliacion fiscal. Requiere confirm=true para ejecutar.
Inputs: confirm (required), documentId (required), documentType (required), transactionId (required), +1 more. Returns: id, amount, status, category, +7 more
onboarding_persona_setSet Onboarding PersonaAIdempotent
Set the workspace persona. Drives module visibility, default chart-of-accounts, and onboarding checklist. Personas:
'autonomo' — self-employed (autonomo Spain)
'empresa' — small/medium business
'agencia' — agency / consultancy
'gestoria' — accounting firm (manages multiple client workspaces)
Idempotent: setting the same persona again is a no-op. / Define la persona del workspace. Determina modulos visibles, plan contable y checklist.
Inputs: persona (required). Returns: persona, updatedAt, workspaceId
onboarding_statusOnboarding StatusARead-onlyIdempotent
Return the current workspace onboarding state — persona, completed steps, pending steps, percent complete. Useful to drive in-app guidance, sales follow-up triggers, and partner program tracking. / Devuelve el estado actual del onboarding del workspace (persona, pasos completados/pendientes).
Inputs: no named parameters. Returns: persona, startedAt, completedAt, workspaceId, +3 more
overtime_reportOvertime ReportARead-onlyIdempotent
Generate an overtime report for a period. Aggregates regular vs overtime hours per employee + total estimated cost in EUR. Useful for payroll prep and labor-law audits. Period format: 'YYYY-MM' (monthly) or 'YYYY-QN' (quarterly) or 'YYYY' (annual). / Informe de horas extra por periodo. Agrega horas regulares vs extra por empleado + coste estimado.
Inputs: period (required), employeeId. Returns: period, byEmployee, generatedAt, estimatedCostEur, +2 more
pause_recurring_invoicePause Recurring InvoiceAIdempotent
Pause an active recurring invoice template. No new invoices are generated while paused. The template is preserved — use resume_recurring_invoice to restart. / Pausa una plantilla de factura recurrente activa. No se generan nuevas facturas mientras esta pausada. Usa resume_recurring_invoice para reanudarla.
Inputs: id (required). Returns: id, data, meta, message, +1 more
payroll_checklistPayroll Readiness ChecklistARead-onlyIdempotent
List all employees for a given month with their payroll readiness status. Status values:
'ready' — all required data present, ready to export
'missing_data' — some required fields missing (see missingFields[])
'blocked' — manually blocked or data inconsistency detected
Use BEFORE payroll_export to identify gaps. Month format: 'YYYY-MM'. / Lista empleados con estado de preparacion para nomina. Usar antes de payroll_export.
Inputs: month (required). Returns: month, employees, generatedAt, readyEmployees, +2 more
payroll_exportExport Payroll (Gestoria Format)ARead-onlyIdempotent
Export payroll data for a month in gestoria-compatible format. Supported formats:
'a3' — Wolters Kluwer A3 (CSV with Spanish payroll columns)
'contasol' — Sage Contasol
'sage' — Sage 50/200
'holded' — Holded import format
'siltra' — SILTRA Seguridad Social XML
Frihet does NOT calculate payroll — it exports staged data for the gestoria. Month format: 'YYYY-MM'. / Exporta datos de nominas en formato compatible con gestoria. Mes en formato 'YYYY-MM'.
Inputs: month (required), format (required). Returns: month, format, fileUrl, filename, +2 more
period_closeClose Accounting PeriodADestructiveIdempotent
TRUST AREA — FISCAL CLOSE. Close a monthly or quarterly accounting period. Freezes invoices, expenses, journal entries and bank reconciliations for the period. Requires confirm=true. Idempotent: re-closing an already closed period is a no-op. Closed periods can be reopened with period_reopen + audit reason. / AREA DE CONFIANZA — CIERRE FISCAL. Cierra un periodo contable mensual o trimestral. Congela facturas, gastos, asientos. Requiere confirm=true.
Inputs: type (required), confirm (required). Returns: id, type, status, endDate, +7 more
period_close_statusPeriod Close StatusARead-onlyIdempotent
Get the current accounting period state (open / closing / closed / reopened). Without periodId returns the current open or most recently closed period. / Devuelve el estado del periodo contable actual (abierto/cerrando/cerrado/reabierto).
Inputs: periodId. Returns: id, type, status, endDate, +7 more
period_reopenReopen Accounting PeriodADestructive
TRUST AREA — FISCAL REOPEN. Reopen a closed accounting period. Requires a compliance reason (audit log) and confirm=true. Reopening allows backdated edits to invoices/expenses — use with extreme caution. / AREA DE CONFIANZA — REAPERTURA FISCAL. Reabre un periodo cerrado. Requiere motivo (auditoria) y confirm=true.
Inputs: reason (required), confirm (required), periodId (required). Returns: id, type, status, endDate, +7 more
permissions_matrixPermissions MatrixARead-onlyIdempotent
Return the full role-to-permission matrix for the workspace. Lists every role with the permissions it grants and every protected resource. Useful for security audits, role design, and compliance reporting. / Devuelve la matriz completa de roles y permisos del workspace.
Inputs: no named parameters. Returns: roles, resources, generatedAt
permissions_meMy PermissionsARead-onlyIdempotent
Return the caller's effective role + permissions in the current workspace. Useful for client-side UI gating, debugging access errors, and capability discovery. / Devuelve el rol efectivo y los permisos del llamante en el workspace actual.
Inputs: no named parameters. Returns: role, userId, permissions, workspaceId
refund_depositRefund DepositBIdempotent
Refund a deposit back to the client. Transitions the deposit status to 'refunded'. Example: id='dep_abc123', reason='Project cancelled' / Devuelve un deposito al cliente.
Inputs: id (required), notes, reason. Returns: id, data, meta, message, +1 more
refund_saleRefund POS SaleADestructiveIdempotent
Refund a POS sale in full or partially. This action is irreversible — the customer will receive a refund to their original payment method. You MUST pass confirm=true to proceed. Optionally specify amountCents for a partial refund (defaults to full refund). / Reembolsa una venta POS total o parcialmente. Accion irreversible. Debes pasar confirm=true. Pasa amountCents para reembolso parcial.
Inputs: id (required), confirm (required), reason, amountCents. Returns: id, reason, saleId, status, +3 more
remove_team_memberRemove Team MemberADestructiveIdempotent
Remove a member from the workspace. The member immediately loses access. Their created records (invoices, expenses) are preserved. Cannot remove the workspace owner — transfer ownership first. Requires confirm=true to prevent accidental removal. / Elimina un miembro del espacio de trabajo. El miembro pierde acceso inmediatamente. Sus registros creados (facturas, gastos) se conservan. No se puede eliminar al propietario — transfiere la propiedad primero. Requiere confirm=true para evitar eliminaciones accidentales.
Inputs: confirm (required), memberId (required). Returns: id, data, meta, message, +1 more
resume_recurring_invoiceResume Recurring InvoiceAIdempotent
Resume a paused recurring invoice template. The next invoice will be generated on the next scheduled cycle date after resumption. / Reanuda una plantilla de factura recurrente pausada. La proxima factura se generara en el siguiente ciclo programado tras la reanudacion.
Inputs: id (required). Returns: id, data, meta, message, +1 more
run_recurring_nowRun Recurring Invoice NowA
Manually trigger immediate generation of the next invoice instance from a recurring template. Useful for billing ahead of schedule or recovering from a missed automated run. The generated invoice is created as a draft; review and send separately. Example: templateId='rec_abc123' / Genera manualmente la siguiente instancia de una factura recurrente. Util para facturar antes de lo programado o recuperar un ciclo perdido. La factura generada se crea como borrador; revisar y enviar por separado.
Inputs: templateId (required), draftOnly. Returns: id, data, meta, message, +1 more
search_invoicesSearch InvoicesARead-onlyIdempotent
Search and filter invoices. Supports filtering by status and date range. The query parameter searches across client names and invoice content. Example: query='Acme', status='paid', from='2026-01-01', to='2026-03-31' / Busca y filtra facturas. Soporta filtrado por estado y rango de fechas. El parametro query busca en nombres de clientes y contenido de facturas.
Inputs: to, from, after, limit, +4 more. Returns: data, limit, total, offset, +1 more
send_einvoiceSend E-InvoiceA
Dispatch an e-invoice to the recipient via the selected transport channel. Returns immediately with a workflowRunId — use get_einvoice_status to poll until completion.
Supported formats (11 total): • xrechnung-cii — XRechnung CII syntax (Germany B2G mandatory) • xrechnung-ubl — XRechnung UBL 2.1 syntax (Germany B2G alternative) • facturx-en16931 — Factur-X EN16931 PDF/A-3 (France, EU) • facturx-extended — Factur-X Extended with trade/logistics fields (France, EU) • facturx-basic — Factur-X Basic reduced field set (France, EU) • facturx-minimum — Factur-X Minimum for summary invoices (France, EU) • fatturapa — FatturaPA XML via SDI hub (Italy mandatory) • ubl — Generic UBL 2.1 XML (EU/global) • cii — Generic CII Cross Industry Invoice (EU/global) • peppol-bis-3 — PEPPOL BIS Billing 3.0 network (EU/Nordic/AU/SG) • facturae — Facturae 3.2.x (Spain B2G via FACe/AEAT mandatory)
Dispatch modes: • email — attach XML/PDF and send via Resend to client email on file • chorus_pro — submit to French Chorus Pro portal (facturx-* only) • sdi — submit to Italian SDI hub (fatturapa only) • peppol — transmit via PEPPOL access point (peppol-bis-3 only) • download — generate and return a signed download URL only
If the dispatch backend is not deployed for this workspace, returns an honest 'unavailable' response — never fabricated workflow data. / Envia una factura electronica al destinatario mediante el canal de transporte seleccionado. Devuelve de forma asincrona — consultar get_einvoice_status para seguimiento.
Inputs: format (required), invoiceId (required), dispatchMode (required). Returns: status, workflowRunId, estimatedCompletionSec
send_invoiceSend InvoiceAIdempotent
Send an invoice to the client via email. Optionally override the recipient email address. The invoice must exist and should not already be cancelled. / Envia una factura al cliente por email. Opcionalmente se puede cambiar el email destinatario.
Inputs: id (required), to. Returns: id, data, meta, message, +1 more
send_quoteSend QuoteAIdempotent
Send a quote/estimate to the client via email. Optionally override the recipient email address. The quote must exist and should not already be expired or rejected. / Envia un presupuesto al cliente por email. Opcionalmente se puede cambiar el email destinatario.
Inputs: id (required), to. Returns: id, data, meta, message, +1 more
sync_channelSync ChannelAIdempotent
Trigger a manual sync of a booking channel (Airbnb, Booking.com, etc.). Pulls new reservations and/or pushes calendar updates. Returns sync status and counts. / Dispara sincronizacion manual de un canal de reservas. Importa reservas nuevas y/o envia actualizaciones de calendario.
Inputs: channelId (required), direction. Returns: errors, status, channelId, lastSyncAt, +2 more
test_webhookTest WebhookA
Fire a synthetic test event to the webhook endpoint and return the delivery result. Useful to verify endpoint reachability, signature validation, and TLS configuration. Optionally specify the eventType to simulate (default: 'webhook.test'). Example: id='wh_abc', eventType='invoice.paid' / Envia un evento de prueba sintetico al endpoint del webhook. Util para verificar accesibilidad, validacion de firma y configuracion TLS.
Inputs: id (required), eventType. Returns: error, delivered, eventType, webhookId, +3 more
ticketbai_statusGet TicketBAI Submission StatusARead-onlyIdempotent
Poll the hacienda acknowledgement status for a TicketBAI submission. Returns the TBAI identifier, territory, and hacienda's confirmation or rejection state.
Common status values: • submitted — sent, awaiting hacienda response (check again in 30-60s) • accepted — hacienda confirmed the submission (AEAT/foral treasury received) • rejected — hacienda rejected (check rejectionReason for correction guidance) • error — internal processing error (see error field)
/ Consulta el estado de acuse de recibo de la hacienda foral para un envío TicketBAI. Devuelve el identificador TBAI, territorio y estado de confirmación o rechazo.
Inputs: invoiceId (required). Returns: csv, qrUrl, errors, estado, +3 more
ticketbai_submitSubmit TicketBAI (Basque Country)A
Submit an invoice to the Basque Country TicketBAI e-invoicing system. Territory is auto-detected from the workspace address (Bizkaia → BATUZ/LROE, Gipuzkoa → Gipuzkoa TicketBAI, Araba → Araba TicketBAI). Returns the submission TicketBAI ID (TBAI identifier) and QR code URL for printing on the invoice.
Use sandbox=true for test submissions against the hacienda test endpoints. Production submissions require a valid TicketBAI certificate configured in workspace settings.
/ Envía una factura al sistema TicketBAI del País Vasco. El territorio se detecta automáticamente (Bizkaia→BATUZ/LROE, Gipuzkoa, Álava). Devuelve el identificador TBAI y URL del código QR para imprimir en la factura.
Inputs: invoiceId (required), sandbox. Returns: csv, qrUrl, accepted, idempotent, +1 more
update_clientUpdate ClientAIdempotent
Update an existing client using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', email='new@acme.com', phone='+34600123456' / Actualiza un cliente existente. Solo se modifican los campos proporcionados.
Inputs: id (required), name, email, phone, +2 more. Returns: id, name, email, phone, +4 more
update_depositUpdate DepositAIdempotent
Update an existing deposit using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', amount=750, notes='Updated retainer amount' / Actualiza un deposito existente. Solo se modifican los campos proporcionados.
Inputs: id (required), date, notes, amount, +7 more. Returns: id, date, notes, amount, +9 more
update_expenseUpdate ExpenseAIdempotent
Update an existing expense using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', amount=75.00, category='travel' / Actualiza un gasto existente. Solo se modifican los campos proporcionados.
Inputs: id (required), date, amount, vendor, +3 more. Returns: id, date, amount, vendor, +5 more
update_invoiceUpdate InvoiceAIdempotent
Update an existing invoice using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', status='paid' to mark an invoice as paid. / Actualiza una factura existente. Solo se modifican los campos proporcionados.
Inputs: id (required), items, notes, status, +16 more. Returns: id, items, notes, total, +7 more
update_kitchen_ticketUpdate Kitchen TicketAIdempotent
Advance a kitchen ticket through the workflow — update its status (e.g. queued → preparing → ready → served) or reassign it to a different station. / Avanza un ticket de cocina en el flujo: actualiza estado (queued → preparing → ready → served) o reasigna a otra estacion.
Inputs: id (required), status, stationId. Returns: id, items, status, tableRef, +3 more
update_productUpdate ProductAIdempotent
Update an existing product using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', unitPrice=2000, taxRate=21 / Actualiza un producto existente. Solo se modifican los campos proporcionados.
Inputs: id (required), name, taxRate, unitPrice, +1 more. Returns: id, name, taxRate, createdAt, +3 more
update_quoteUpdate QuoteAIdempotent
Update an existing quote using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', status='accepted' to mark a quote as accepted. / Actualiza un presupuesto existente. Solo se modifican los campos proporcionados.
Inputs: id (required), items, notes, status, +11 more. Returns: id, items, notes, total, +5 more
update_recurring_invoiceUpdate Recurring InvoiceAIdempotent
Update an existing recurring invoice template using PATCH semantics. Only provided fields are changed. Changing lineItems or taxRate affects future generated invoices only, not already-created ones. / Actualiza una plantilla de factura recurrente existente. Solo se modifican los campos proporcionados. Cambiar lineas o tipo impositivo afecta solo a futuras facturas generadas.
Inputs: id (required), notes, taxRate, frequency, +2 more. Returns: id, status, nextRun, createdAt, +5 more
update_team_member_roleUpdate Team Member RoleAIdempotent
Change the role of an existing team member. Only workspace admins or owners can change roles. Cannot change the owner's role — use a dedicated ownership transfer flow. Example: memberId='mbr_abc123', role='admin' / Cambia el rol de un miembro existente del espacio de trabajo. Solo administradores o propietarios pueden cambiar roles. No se puede cambiar el rol del propietario — usa el flujo de transferencia de propiedad.
Inputs: role (required), memberId (required). Returns: id, data, meta, message, +1 more
update_time_entryUpdate Time EntryAIdempotent
Update an existing time entry using PATCH semantics. Only provided fields are changed. Example: id='te_abc123', hours=3.0, description='Frontend review + testing' / Actualiza una entrada de tiempo existente. Solo se modifican los campos proporcionados.
Inputs: id (required), date, hours, billable, +2 more. Returns: id, date, hours, status, +6 more
update_vendorUpdate VendorAIdempotent
Update an existing vendor using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', email='new@supplier.com', phone='+34600123456' / Actualiza un proveedor existente. Solo se modifican los campos proporcionados.
Inputs: id (required), name, email, phone, +2 more. Returns: id, name, email, phone, +4 more
update_webhookUpdate WebhookAIdempotent
Update an existing webhook configuration using PATCH semantics. Only provided fields change. Example: id='abc123', active=false to disable a webhook. / Actualiza la configuracion de un webhook. Solo se modifican los campos proporcionados.
Inputs: id (required), url, active, events, +1 more. Returns: id, url, active, events, +3 more
validate_einvoice_xmlValidate E-Invoice XMLARead-onlyIdempotent
Validate an e-invoice XML document against the specified format's schema and schematron rules. Returns a list of errors with severity, XPath location, message, and rule ID. Runs KOSIT validator (XRechnung), Mustang (EN16931), XSD, or Schematron depending on format.
Use before dispatch to catch errors early without incurring network transmission costs. A valid=true response means the document passes all schema + business rule checks.
If the validation backend is not deployed for this workspace, returns an honest 'unavailable' response — never a fabricated valid=true. / Valida un documento XML de factura electronica contra el esquema y reglas schematron del formato especificado.
Inputs: xml (required), format (required). Returns: valid, errors, validator, durationMs
verifactu_resubmitRe-submit VeriFactu SubmissionAIdempotent
TRUST AREA — COMPLIANCE. Re-submit a failed or rejected VeriFactu submission to AEAT. Idempotent: uses the same hash chain; AEAT deduplicates by hash. Creates an audit trail entry for every resubmission attempt. Requires confirm=true. Only use on invoices with status='failed'. / AREA DE CONFIANZA — COMPLIANCE. Reenvio de una factura VeriFactu fallida a AEAT. Idempotente: misma cadena hash. Registra entrada de auditoria en cada intento. Requiere confirm=true. Solo para facturas con status='failed'.
Inputs: confirm (required), invoiceId (required). Returns: csv, hash, qrUrl, status, +8 more
verifactu_statusGet VeriFactu Submission StatusARead-onlyIdempotent
Get the VeriFactu (AEAT Spanish e-invoice chain) submission status for a specific invoice. Returns last submission timestamp, hash, AEAT response code, and QR verification URL. / Obtiene el estado de envio VeriFactu (AEAT) para una factura especifica. Devuelve timestamp del ultimo envio, hash, respuesta AEAT y URL del codigo QR.
Inputs: invoiceId (required). Returns: csv, hash, qrUrl, status, +8 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 148 tools
Most tools have distinct purposes, but with 148 tools, some overlap exists (e.g., send_invoice vs send_einvoice, list_invoices vs search_invoices). Overall, the actions and targets differentiate tools sufficiently.
Many tools follow verb_noun pattern, but there are inconsistencies like 'leave_request_create' (noun_noun_verb) and prefixes (frihet_, gestoria_) that break uniformity. Still readable overall.
148 tools is excessive for an MCP server. While the server covers a broad ERP scope, the count is far beyond the typical 3-15 range, making the surface overwhelming.
Covers many domains comprehensively (invoicing, e-invoicing, tax models, HR), but missing basic CRUD for clients (no create_client or delete_client), which is a notable gap in the client lifecycle.
Maintenance
Related MCP Connectors
Create EU-compliant invoices, manage clients and download PDFs from your AI assistant.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Create invoices, clients, and Stripe payment links from any agent. 7 tools. No email or deletes.
Quotes, contracts and invoices per client. Your AI drafts, sends and follows up.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with the Finizi B4B platform through 15 comprehensive tools for managing business entities, invoices, vendors, and products. Features secure JWT authentication, automatic retries, and full business-to-business workflow integration through natural language commands.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with the Finizi B4B platform through 15 comprehensive tools for managing business entities, invoices, vendors, and products. Features secure JWT authentication, automatic retries, and comprehensive business data operations through natural language commands.MIT
- AlicenseNot gradedqualityAmaintenanceComplete Swiss accounting integration for Bexio via MCP. Works with Claude Desktop, n8n, and any MCP client. 221 tools for invoices, contacts, projects & more. Created by Lukas Hertig.42MIT
- AlicenseAqualityCmaintenanceAI-powered freelance business manager for Claude Code. Proposals, invoices, time tracking, scope management, and follow-ups - 37 tools, 5 coaching skills.3722 npmMIT