Skip to main content
Glama
Frihet MCP Server

Frihet MCP Server


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-server

No account yet? Try demo mode. It answers from example data, persists nothing and makes no network calls:

FRIHET_DEMO=1 npx -y @frihet/mcp-server

Local 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

@frihet/mcp-server · npx -y @frihet/mcp-server

Remote MCP

Live, OAuth or API key

https://mcp.frihet.io/mcp (running version at /health)

ChatGPT app

Live

Frihet in ChatGPT

Raycast

Coming to the Raycast Store

Submission

Official MCP Registry

Listed

io.frihet/erp

GitHub MCP Registry

Listed

Frihet ERP

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 ✓ Connected

Or 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-server

Codex 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

~/Library/Application Support/Claude/claude_desktop_config.json

Cursor

.cursor/mcp.json or ~/.cursor/mcp.json

Windsurf

~/.windsurf/mcp.json

Cline

VS Code settings or .cline/mcp.json

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

Installs 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

  1. Log into app.frihet.io

  2. Go to Settings > API

  3. Click Create API key

  4. 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

docs/agent-onboarding.json, also shipped in the npm package

Per-tool capability truth: callability, writesFrihet, externalInteraction, externalSideEffects

_meta["io.frihet/capability"] on every entry of tools/list

How to behave once connected

the instructions string returned by initialize

  1. Orient before acting. get_business_context and the frihet://tax/rates resource decide the correct fiscal treatment. Do not recall a tax rate from memory.

  2. Draft, show, stop. create_invoice, create_quote and create_credit_note default to status=draft: no fiscal number, no hash, nothing sent to a tax authority.

  3. Human authority is not yours to assume. Any tool with a non-empty externalSideEffects reaches a client's inbox, a webhook, money, or a tax authority. Several also take confirm=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

List invoices with pagination

get_invoice

Get full invoice details by ID

create_invoice

Create a new invoice with line items

update_invoice

Update any invoice field

delete_invoice

Delete a draft invoice; a sent/paid one is cancelled, not destroyed (confirm=true required)

search_invoices

Find invoices by client name, date, or status

send_invoice

Email invoice to client (PDF attachment) — reaches a third party, confirm=true required

mark_invoice_paid

Mark an invoice as paid with optional payment date

get_invoice_pdf

Get bounded invoice PDF bytes as base64

get_invoice_einvoice

Get bounded XML or Factur-X PDF bytes for an invoice

create_credit_note

Create a credit note linked to an existing invoice

apply_late_fee

Apply a late payment fee to an overdue invoice

Expenses (5)

Tool

What it does

list_expenses

List expenses with pagination

get_expense

Get expense details

create_expense

Record a new expense

update_expense

Modify an expense

delete_expense

Delete an expense

Clients (5)

Tool

What it does

list_clients

List all clients

get_client

Get client details

create_client

Register a new client

update_client

Update client info

delete_client

Remove a client

CRM: Contacts (3)

Tool

What it does

list_client_contacts

List all contacts for a client

create_client_contact

Add a contact person to a client

delete_client_contact

Remove a contact from a client

CRM: Activities (2)

Tool

What it does

list_client_activities

List CRM activities (calls, emails, meetings, tasks)

log_client_activity

Log a call, email, meeting, or task against a client

CRM: Notes (3)

Tool

What it does

list_client_notes

List all notes for a client

create_client_note

Add a free-form note to a client

delete_client_note

Remove a note from a client

Products (5)

Tool

What it does

list_products

List products and services

get_product

Get product details

create_product

Add a product or service

update_product

Update pricing or details

delete_product

Remove a product

Quotes (6)

Tool

What it does

list_quotes

List all quotes

get_quote

Get quote details

create_quote

Draft a new quote

update_quote

Modify a quote

delete_quote

Delete only a clean draft with no delivery, response, attachment, or conversion evidence; refuse protected drafts; cancel non-drafts (confirm=true required)

send_quote

Email quote to client for acceptance

Webhooks (6)

Tool

What it does

list_webhooks

List configured webhooks

get_webhook

Get webhook details

create_webhook

Register a new webhook endpoint

update_webhook

Modify events or URL

delete_webhook

Remove a webhook

test_webhook

Send a test payload to a configured webhook endpoint

Intelligence (4)

Tool

What it does

get_business_context

Full snapshot: profile, plan, recent activity, top clients, current month

get_monthly_summary

Monthly P&L: revenue, expenses, profit, tax liability, top clients by revenue

get_quarterly_taxes

Quarterly tax prep: Modelo 303/130 fields, collected vs deductible, liability

duplicate_invoice

Clone an invoice for recurring billing (copies items/client/tax, starts as draft)

E-Invoicing (10)

Tool

What it does

send_einvoice

Dispatch an invoice in 11 formats (XRechnung, Factur-X, FatturaPA, PEPPOL, Facturae, UBL, CII) via email / Chorus Pro / SDI / PEPPOL / download

get_einvoice_status

Poll an e-invoice dispatch until it succeeds or fails; returns ackId, XML URL and PDF/A-3 URL

validate_einvoice_xml

Validate raw XML against format schema + schematron rules (KOSIT / Mustang / XSD / Schematron)

export_datev

Export accounting data as DATEV EXTF (Buchungsstapel / Debitoren / Kreditoren) in CP1252 encoding

einvoice_export

Export e-invoice data in machine-readable formats (JSON/XML) for archival or integration

face_submit

Submit invoice to FACe (Spain B2G government e-invoicing platform)

face_status

Poll submission status from FACe for a submitted invoice

ticketbai_submit

Submit TicketBAI fiscal record to Basque Country tax authority (Hacienda)

ticketbai_status

Poll TicketBAI submission status from the Basque tax authority

ksef_submit

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

List time entries with filter by user, project, date range, billable status

get_time_entry

Get full details of a single time entry by ID

create_time_entry

Log hours for a project (billable flag, description, date)

update_time_entry

Update any field on an existing time entry (PATCH semantics)

delete_time_entry

Soft-delete a time entry (confirm=true required)

get_time_summary

Aggregate total/billable/non-billable hours for a period, with optional groupBy (user/project/day)

Recurring Invoices (8)

Tool

What it does

list_recurring_invoices

List all recurring invoice templates (filter by active/paused)

get_recurring_invoice

Get full details of a recurring template by ID

create_recurring_invoice

Create a new recurring invoice template (daily/weekly/monthly/quarterly/yearly)

update_recurring_invoice

Update template fields — affects future generated invoices only

pause_recurring_invoice

Pause an active template — no invoices generated while paused

resume_recurring_invoice

Resume a paused template — next invoice on next scheduled cycle

delete_recurring_invoice

Permanently delete a template (confirm=true required)

run_recurring_now

Generate the next recurring invoice with explicit confirm=true in full and grouped modes; workspace settings may trigger fiscal issuance, submission and webhooks

Team Management (4)

Tool

What it does

list_team_members

List active members + pending invites (owner excluded)

invite_team_member

Invite a new member by email with role (admin/editor/accountant/viewer)

update_team_member_role

Change an existing member's role (admin/editor/accountant/viewer)

remove_team_member

Remove a member from the workspace (confirm=true required)

Gestoria — Accountants (5)

Tool

What it does

gestoria_message_send

Send a message in a contextual thread (documentRequest / filingItem / obligation)

gestoria_messages_list

List messages in a thread, newest first; paginate backwards with before

gestoria_template_create

Create a reusable document request template with variables + due-date offset

gestoria_template_bulk_send

Bulk send a template to up to 500 client workspaces in one call

gestoria_aging_consolidated

Cross-client AR aging report (buckets, per-workspace breakdown, top overdue)

Audit GL (3)

Tool

What it does

frihet_gl_entry_approve

Approve a GL journal entry (gestor/admin only, restricted)

frihet_gl_entry_reject

Reject a GL entry with a mandatory reason (restricted)

frihet_gl_entry_audit_log

Retrieve full audit trail for a GL entry

White-label Portal Domain (3)

Tool

What it does

frihet_portal_domain_add

Add a custom domain to the client portal (returns DNS CNAME records)

frihet_portal_domain_verify

Verify DNS propagation for a custom portal domain

frihet_portal_domain_remove

Remove a custom portal domain (reverts to default Frihet subdomain)

Self-onboard & VIES (2)

Tool

What it does

frihet_portal_onboard_link_generate

Generate a time-limited self-onboard link for a prospective client

frihet_tax_id_vies_lookup

Validate an EU VAT number (CIF intracomunitario) via VIES

IGIC — Canary Islands Indirect Tax (4)

Tool

What it does

frihet_modelo_415_summary

M415 annual operations >€3,005 (Canarias equivalent of M347) — not deployed, returns NOT_DEPLOYED

frihet_modelo_425_summary

M425 annual IGIC recap for Canary Islands businesses — not deployed, returns NOT_DEPLOYED

frihet_modelo_418_summary

M418 monthly individual IGIC return, régimen especial del grupo de entidades — not deployed, returns NOT_DEPLOYED

frihet_aiem_calculate

AIEM (Arbitrio Importación) calculation for Canarias — not deployed, returns NOT_DEPLOYED

Impuesto sobre Sociedades — Corporate Tax (2)

Tool

What it does

frihet_modelo_200_summary

Modelo 200 annual IS return — not deployed, returns NOT_DEPLOYED

frihet_modelo_202_summary

Modelo 202 installment payments (1P/2P/3P) — not deployed, returns NOT_DEPLOYED

Bank Categorization Rules (2)

Tool

What it does

frihet_bank_rules_list

List all bank auto-categorization rules (conditions + actions + status)

frihet_bank_rule_create

Create a new rule to auto-categorize transactions by description, amount, counterparty

Deposits (7)

Tool

What it does

list_deposits

List deposits with pagination

get_deposit

Get deposit details by ID

create_deposit

Record a new client deposit

update_deposit

Update deposit fields

delete_deposit

Delete a deposit (confirm=true required)

apply_deposit

Apply a deposit balance against an invoice

refund_deposit

Record a deposit refund in Frihet bookkeeping with confirm=true; optional amount records that portion, omission records the remaining refundable balance. Does not transfer money

Vendors (5)

Tool

What it does

list_vendors

List all vendors/suppliers

get_vendor

Get vendor details

create_vendor

Add a new vendor

update_vendor

Update vendor info

delete_vendor

Remove a vendor

Banking (5)

Tool

What it does

list_bank_accounts

List connected bank accounts

get_bank_account

Get details for a bank account

list_transactions

List bank transactions with filters

categorize_transaction

Assign a category and expense/income type to a transaction

match_transaction_to_invoice

Link a bank transaction to an existing invoice

Fiscal — Spanish Tax Models (7)

Tool

What it does

get_modelo_303_summary

Quarterly IVA return (Modelo 303) — collected vs deductible, net payable

get_modelo_130_summary

Quarterly IRPF installment for self-employed (Modelo 130)

get_modelo_390_summary

Annual IVA summary (Modelo 390)

get_modelo_180_summary

Annual withholding summary for rentals (Modelo 180) — not deployed, returns NOT_DEPLOYED

get_modelo_347_summary

Annual third-party transactions >€3,005 (Modelo 347)

verifactu_status

Get VeriFactu submission status for a fiscal record

verifactu_resubmit

Resubmit a rejected VeriFactu fiscal record

Vacation Rentals / Stay (5)

Tool

What it does

list_reservations

List rental reservations with filters

get_reservation

Get reservation details

create_reservation

Create a new reservation

list_properties

List all rental properties

sync_channel

Trigger OTA channel sync (Airbnb, Booking.com, etc.)

POS — Point of Sale (4)

Tool

What it does

list_terminals

List registered POS terminals

get_sale

Get details for a POS sale transaction

list_sales

List POS sales with pagination

refund_sale

Issue a refund for a POS sale

Kitchen / Restaurant (6)

Tool

What it does

list_kitchen_tickets

List kitchen order tickets for the live board, filtered by status or station

get_kitchen_ticket

Get a single kitchen ticket by ID with all items and their individual statuses

update_kitchen_ticket

Advance a ticket's status (queued → preparing → ready → served) or reassign it to another station

list_kitchen_stations

List all kitchen stations with id, name, and active status

list_menu_items

List the kitchen menu catalog with free-text search and active/inactive filter

kitchen_flow_summary

Slow-station detection: aggregate open tickets per station and flag the bottleneck

HR — Human Resources (9)

Tool

What it does

leave_request_create

Create a leave request (vacation, sick, personal)

leave_approve

Approve a pending leave request

leave_reject

Reject a leave request with a reason

leave_cancel

Cancel an approved or pending leave request

leave_list

List leave requests with filters (user, status, date range)

attendance_clock_in

Record clock-in for an employee

attendance_clock_out

Record clock-out for an employee

overtime_report

Read daily/weekly overtime, aggregate minutes/hours, and compliance alerts computed over the selected YYYY or YYYY-MM records

anomaly_list

List attendance anomalies (missing punches, excessive overtime)

Payroll (2)

Tool

What it does

payroll_export

Read normalized payroll-ready employee data; the format value is an echoed destination label, not a generated file

payroll_checklist

List payable employees with payroll-profile readiness, missing fields, and monthly review state

Permissions (2)

Tool

What it does

permissions_matrix

Get the documented RBAC-model snapshot (not a runtime authorization guarantee)

permissions_me

Compare RBAC-model fields with actual API-key scopes and known scope denials (non-exhaustive)

Period Close (3)

Tool

What it does

period_close_status

Get the current or selected YYYY fiscal-year range, open/closed state, and nullable closing details

period_close

Close an accounting period (gestor/admin only, restricted)

period_reopen

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"]:

  • registered means the name and handler exist in this server build;

  • callability is api_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, or local—never an unconditional “available” claim;

  • writesFrihet, externalInteraction, and externalSideEffects distinguish 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

frihet://api/schema

OpenAPI summary: endpoints, auth, rate limits, pagination, error codes

Tax Rates

frihet://tax/rates

Tax rates by Spanish fiscal zone: IVA, IGIC, IPSI, EU reverse charge, IRPF

Tax Calendar

frihet://tax/calendar

Quarterly and annual filing deadlines for the listed Spanish tax models

Expense Categories

frihet://config/expense-categories

8 categories with deductibility rules, IVA treatment, amortization

Invoice Statuses

frihet://config/invoice-statuses

Status flow (draft > sent > paid/overdue > cancelled), transition rules, webhook events

Currencies

frihet://config/currencies

40 supported currencies with ISO codes, symbols, decimal places, locale formatting

Countries

frihet://config/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

frihet://business-profile

Your business info, plan, defaults, recent activity, top clients

Monthly Snapshot

frihet://monthly-snapshot

Current month P&L, revenue, expenses, tax liability

Overdue Invoices

frihet://overdue-invoices

All invoices past due date (up to 100)

Plan Limits

frihet://status/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

monthly-close

Close the month: review unpaid invoices, categorize expenses, check tax obligations, generate summary

month? (YYYY-MM)

onboard-client

Set up a new client with correct tax rates by location, optionally create a welcome quote

clientName, country?, region?

quarterly-tax-prep

Prepare quarterly tax filing: calculate IVA/IGIC, identify deductibles, preview Modelo 303/130/420

quarter?, fiscalZone?

overdue-followup

Find overdue invoices, draft follow-up messages, suggest payment reminders

--

new-client-invoice

Create a client + first invoice in one workflow with tax rate lookup

clientName, country?

expense-report

Generate expense report grouped by category with deductible totals

month? (YYYY-MM)

year-end-close

Full annual closing: quarterly review, pending invoices, uncategorized expenses, year-end checklist

year (YYYY)

cash-flow-forecast

Project cash flow for coming months: recurring income, expenses, overdue receivables, tax deadlines

months? (default: 3)

invoice-aging-review

AR aging analysis: group unpaid invoices by bucket (0-30/31-60/61-90/90+ days), top debtors, collection actions

--

expense-batch

Process expenses in bulk: categorize, apply tax rates, flag missing receipts

fiscalZone?


Configuration

Variable

Required

Default

FRIHET_API_KEY

Yes (stdio)

--

FRIHET_API_URL

No

https://api.frihet.io/v1

FRIHET_TOOL_MODE

No

full

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.js

Test 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

@frihet/mcp-server

This MCP server (158 canonical operations + 5 alias names; 11 local resources; 10 prompts)

@frihet/sdk

TypeScript SDK (frihet.invoices.create())

frihet

CLI (frihet invoices list --status overdue)

n8n-nodes-frihet

n8n community node for workflow automation

REST API

OpenAPI 3.1 at api.frihet.io/v1

Webhooks

Real-time events with HMAC-SHA256

Frihet · Documentation · MCP server docs · OpenAPI spec

License

MIT. See LICENSE.

Built by Frihet.

Available Tools

148 tools
anomaly_listList AnomaliesA
Read-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 DepositA
Idempotent

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)A
Idempotent

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 TransactionA
Idempotent

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 ContactA
DestructiveIdempotent

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 NoteA
DestructiveIdempotent

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 DepositB
DestructiveIdempotent

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 ExpenseA
DestructiveIdempotent

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 InvoiceA
DestructiveIdempotent

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 ProductA
DestructiveIdempotent

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 QuoteA
DestructiveIdempotent

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 InvoiceA
DestructiveIdempotent

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 EntryA
DestructiveIdempotent

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 VendorA
DestructiveIdempotent

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 WebhookA
DestructiveIdempotent

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 XMLA
Read-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 DATEVA
Read-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 StatusA
Read-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)A
Read-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 RulesA
Read-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 EntryA
Idempotent

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 LogA
Read-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 EntryA
Idempotent

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)A
Read-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)A
Read-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)A
Read-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)A
Read-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)A
Read-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 DomainA
DestructiveIdempotent

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 DomainA
Read-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_tax_id_vies_lookupLookup Tax ID via VIES (EU VAT Validation)A
Read-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)A
Read-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 MessagesA
Read-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 AccountA
Read-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 ClientA
Read-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 DepositA
Read-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 StatusA
Read-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 InvoiceA
Read-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 PDFA
Read-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 TicketA
Read-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)A
Read-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)A
Read-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)A
Read-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)A
Read-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)A
Read-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 SummaryA
Read-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 ProductA
Read-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 QuoteA
Read-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 InvoiceA
Read-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 ReservationA
Read-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 SaleA
Read-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 EntryA
Read-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 SummaryA
Read-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 VendorA
Read-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 WebhookA
Read-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 SummaryA
Read-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 RequestA
Idempotent

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 RequestA
Idempotent

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 RequestsA
Read-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 RequestA
Idempotent

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 AccountsA
Read-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 ActivitiesA
Read-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 ContactsA
Read-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 NotesB
Read-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 ClientsA
Read-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 DepositsA
Read-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 ExpensesA
Read-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 InvoicesB
Read-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 StationsA
Read-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 TicketsA
Read-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_menu_itemsList Menu ItemsA
Read-onlyIdempotent

List the kitchen menu catalog. Supports free-text search and active/inactive filter. Returns item id, name, description, price, category, and active status. / Lista el catálogo de menu de cocina. Admite búsqueda de texto y filtro activo/inactivo. Devuelve id, nombre, descripcion, precio, categoria y estado activo.

Inputs: q, after, limit, offset, +1 more. Returns: data, limit, total, offset, +1 more

list_productsList ProductsA
Read-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 PropertiesB
Read-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 QuotesA
Read-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 InvoicesA
Read-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 ReservationsA
Read-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 SalesA
Read-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 MembersA
Read-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 TerminalsA
Read-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 EntriesA
Read-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 TransactionsA
Read-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 VendorsA
Read-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 WebhooksB
Read-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 InvoiceA
Idempotent

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 PersonaA
Idempotent

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 StatusA
Read-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 ReportA
Read-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 InvoiceA
Idempotent

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 ChecklistA
Read-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)A
Read-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 PeriodA
DestructiveIdempotent

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 StatusA
Read-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 PeriodA
Destructive

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 MatrixA
Read-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 PermissionsA
Read-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 DepositB
Idempotent

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 SaleA
DestructiveIdempotent

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 MemberA
DestructiveIdempotent

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 InvoiceA
Idempotent

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 InvoicesA
Read-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 InvoiceA
Idempotent

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 QuoteA
Idempotent

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 ChannelA
Idempotent

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 StatusA
Read-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 ClientA
Idempotent

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 DepositA
Idempotent

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 ExpenseA
Idempotent

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 InvoiceA
Idempotent

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 TicketA
Idempotent

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 ProductA
Idempotent

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 QuoteA
Idempotent

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 InvoiceA
Idempotent

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 RoleA
Idempotent

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 EntryA
Idempotent

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 VendorA
Idempotent

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 WebhookA
Idempotent

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 XMLA
Read-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 SubmissionA
Idempotent

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 StatusA
Read-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

    B3.4/5.0

    Scored across 148 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness3/5

    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

    ActivityActive
    ResponsivenessUsually handled

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      A
      maintenance
      Complete 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.
      42
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      AI-powered freelance business manager for Claude Code. Proposals, invoices, time tracking, scope management, and follow-ups - 37 tools, 5 coaching skills.
      37
      22 npm
      MIT