[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_128":129},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@frihet-io/frihet-mcp' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":61,"_62":63,"_64":65,"_66":48,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_77":-5,"_78":-5,"_79":-5,"_80":48,"_81":-5,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","frihet-io","moduleId","frihet-mcp","@frihet-io/frihet-mcp","displayName","Frihet ERP","tagline","AI-native ERP MCP: ES/EU fiscal compliance (VeriFactu/TicketBAI/Facturae), invoicing, tax, banking","iconKey","https://avatars.githubusercontent.com/u/261349571?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.frihet.io/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363298000,"updatedAt",1781583616000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.frihet%2Ferp","sourceVerified",false,"importedAt","upstreamStars",6,"upstreamUpdatedAt",1781581919000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/Frihet-io/frihet-mcp","githubRepoFullName","Frihet-io/frihet-mcp","releaseId","ext-frihet-io-frihet-mcp","version","1.14.0","descriptionMarkdown","

\n \n \n \n $\"frihet-mcp\"$ \n \n

\n\n

\n AI-native MCP server for business management.
\n Servidor MCP nativo con IA para gestión empresarial.\n

\n\n

\n $\"npm$ \n $\"npm$ \n $\"Smithery$ \n $\"MCP$ \n $\"license\"$ \n $\"157$ \n $\"node$ =18\">\n $\"TypeScript\"$ \n

\n\n---\n\n## Distribution\n\n| Channel | Status | Install |\n|---------|--------|---------|\n| **npm** | Live | `npx @frihet/mcp-server` |\n| **Remote endpoint** | Live | `https://mcp.frihet.io/mcp` (zero install, OAuth or API key) |\n| **Smithery** | Live | [smithery.ai/server/frihet/frihet-mcp](https://smithery.ai/server/frihet/frihet-mcp) |\n| **MCP Registry** | Live | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/?q=io.frihet) |\n| **Glama** | Live | [glama.ai/mcp/servers/@Frihet-io/frihet-mcp](https://glama.ai/mcp/servers/@Frihet-io/frihet-mcp) |\n| **mcp.so** | Auto-index (unverified) | [mcp.so](https://mcp.so) — indexes from npm + GitHub |\n| **PulseMCP** | Auto-index (unverified) | [pulsemcp.com](https://pulsemcp.com) — indexes from npm + GitHub |\n| **Cursor Marketplace** | Coming soon | [cursor.com/marketplace](https://cursor.com/marketplace) |\n| **ChatGPT Apps** | Coming soon | [chatgpt.com](https://chatgpt.com) |\n| **Anthropic Claude Directory** | Coming soon | [claude.ai/settings/connectors](https://claude.ai/settings/connectors) |\n\n> **Tool count:** npm `latest` (1.14.0) ships all 157 tools, same as the remote endpoint (`mcp.frihet.io`).\n\n---\n\n## What is this\n\nAn MCP server that connects your AI assistant to [Frihet](https://frihet.io). Create invoices by talking. Query expenses in natural language. Manage your entire business from your IDE.\n\n```\nYou: \"Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/hour, due March 1st\"\nClaude: Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,630.00 EUR.\n```\n\n157 tools. 11 resources. 10 prompts. Structured output on every tool. Zero boilerplate.\n\n\n\n---\n\n## Install\n\n### One-line (Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, and more)\n\n```bash\nnpx skills add Frihet-io/frihet-mcp\n```\n\n### Claude Code / Claude Desktop\n\n```json\n{\n \"mcpServers\": {\n \"frihet\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@frihet/mcp-server\"],\n \"env\": {\n \"FRIHET_API_KEY\": \"fri_your_key_here\"\n }\n }\n }\n}\n```\n\n| Tool | Config file |\n|------|------------|\n| Claude Code | `~/.claude/mcp.json` |\n| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Cursor | `.cursor/mcp.json` or `~/.cursor/mcp.json` |\n| Windsurf | `~/.windsurf/mcp.json` |\n| Cline | VS Code settings or `.cline/mcp.json` |\n| Codex CLI | `~/.codex/config.toml` (MCP section) |\n\nThe JSON config is identical for all tools. Only the file path changes.\n\n### Remote (no install)\n\nUse the hosted endpoint at `mcp.frihet.io` -- zero local dependencies, runs on Cloudflare Workers.\n\n**With API key:**\n\n```json\n{\n \"mcpServers\": {\n \"frihet\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://mcp.frihet.io/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer fri_your_key_here\"\n }\n }\n }\n}\n```\n\n**With OAuth 2.0 + PKCE** (browser-based login, no API key needed):\n\nClients that support OAuth (Claude Desktop, Smithery, etc.) can connect directly to `https://mcp.frihet.io/mcp` and authenticate via browser. The server implements the full OAuth 2.1 authorization code flow with PKCE.\n\n### Get your API key\n\n1. Log into [app.frihet.io](https://app.frihet.io)\n2. Go to **Settings > API**\n3. Click **Create API key**\n4. Copy the key (starts with `fri_`) -- it's only shown once\n\n---\n\n## What you can do\n\nTalk to your ERP. These are real prompts, not marketing copy.\n\n### Invoicing\n\n```\n\"Show me all unpaid invoices\"\n\"Create an invoice for Acme SL with 10h of consulting at 95/hour\"\n\"Mark invoice abc123 as paid\"\n\"How much has ClientName been invoiced this year?\"\n```\n\n### Expenses\n\n```\n\"Log a 59.99 EUR expense for Adobe Creative Cloud, category: software, tax-deductible\"\n\"List all expenses from January\"\n\"What did I spend on travel last quarter?\"\n```\n\n### Clients\n\n```\n\"Add a new client: TechStart SL, NIF B12345678, email admin@techstart.es\"\n\"Show me all my clients\"\n\"Update ClientName's address to Calle Mayor 1, Madrid 28001\"\n```\n\n### CRM\n\n```\n\"Add a contact to Acme SL: Ana Garcia, CTO, ana@acme.es\"\n\"Log a call with TechStart: discussed Q2 proposal, they're interested in upgrade\"\n\"Add a note to ClientName: prefers invoices in English, payment NET 30\"\n\"Show me all activities for Acme SL\"\n```\n\n### Quotes\n\n```\n\"Create a quote for Design Studio: logo design (2000 EUR) + brand guidelines (3500 EUR)\"\n\"Show me all pending quotes\"\n```\n\n### Webhooks\n\n```\n\"Set up a webhook to notify https://my-app.com/hook when invoices are paid\"\n\"List all my active webhooks\"\n```\n\n---\n\n## What to expect\n\nThis 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. All 157 tools are CRUD operations over the REST API.\n\n**Works great:**\n\n```\n\"Create an invoice for TechStart SL, 40h consulting at 75 EUR/h\" --> creates the invoice\n\"Show unpaid invoices over 1,000 EUR\" --> queries and filters\n\"Log a 120 EUR expense for the Madrid train, category: travel\" --> records the expense\n\"Update client Acme's email to billing@acme.es\" --> modifies the record\n```\n\n**Does not do:**\n\n- OCR or PDF scanning -- you cannot upload an invoice image and have it read\n- File upload or attachment handling\n- Image processing of any kind\n\nIf you need to digitize paper invoices or receipts, extract the data first (e.g., Claude Vision API, a dedicated OCR service, or manual entry), then use the MCP to create the record:\n\n```\n1. Scan/photograph the invoice\n2. Use Claude Vision: \"Read this invoice image and extract the vendor, items, amounts, and dates\"\n3. Then: \"Create an expense in Frihet for [extracted data]\"\n```\n\n---\n\n## Tools (157)\n\n### Invoices (12)\n\n| Tool | What it does |\n|------|-------------|\n| `list_invoices` | List invoices with pagination |\n| `get_invoice` | Get full invoice details by ID |\n| `create_invoice` | Create a new invoice with line items |\n| `update_invoice` | Update any invoice field |\n| `delete_invoice` | Permanently delete an invoice |\n| `search_invoices` | Find invoices by client name, date, or status |\n| `send_invoice` | Email invoice to client (PDF attachment) |\n| `mark_invoice_paid` | Mark an invoice as paid with optional payment date |\n| `get_invoice_pdf` | Get a download URL for the invoice PDF |\n| `get_invoice_einvoice` | Get the e-invoice XML for a given invoice ID |\n| `create_credit_note` | Create a credit note linked to an existing invoice |\n| `apply_late_fee` | Apply a late payment fee to an overdue invoice |\n\n### Expenses (5)\n\n| Tool | What it does |\n|------|-------------|\n| `list_expenses` | List expenses with pagination |\n| `get_expense` | Get expense details |\n| `create_expense` | Record a new expense |\n| `update_expense` | Modify an expense |\n| `delete_expense` | Delete an expense |\n\n### Clients (5)\n\n| Tool | What it does |\n|------|-------------|\n| `list_clients` | List all clients |\n| `get_client` | Get client details |\n| `create_client` | Register a new client |\n| `update_client` | Update client info |\n| `delete_client` | Remove a client |\n\n### CRM: Contacts (3)\n\n| Tool | What it does |\n|------|-------------|\n| `list_client_contacts` | List all contacts for a client |\n| `create_client_contact` | Add a contact person to a client |\n| `delete_client_contact` | Remove a contact from a client |\n\n### CRM: Activities (2)\n\n| Tool | What it does |\n|------|-------------|\n| `list_client_activities` | List CRM activities (calls, emails, meetings, tasks) |\n| `log_client_activity` | Log a call, email, meeting, or task against a client |\n\n### CRM: Notes (3)\n\n| Tool | What it does |\n|------|-------------|\n| `list_client_notes` | List all notes for a client |\n| `create_client_note` | Add a free-form note to a client |\n| `delete_client_note` | Remove a note from a client |\n\n### Products (5)\n\n| Tool | What it does |\n|------|-------------|\n| `list_products` | List products and services |\n| `get_product` | Get product details |\n| `create_product` | Add a product or service |\n| `update_product` | Update pricing or details |\n| `delete_product` | Remove a product |\n\n### Quotes (6)\n\n| Tool | What it does |\n|------|-------------|\n| `list_quotes` | List all quotes |\n| `get_quote` | Get quote details |\n| `create_quote` | Draft a new quote |\n| `update_quote` | Modify a quote |\n| `delete_quote` | Delete a quote |\n| `send_quote` | Email quote to client for acceptance |\n\n### Webhooks (6)\n\n| Tool | What it does |\n|------|-------------|\n| `list_webhooks` | List configured webhooks |\n| `get_webhook` | Get webhook details |\n| `create_webhook` | Register a new webhook endpoint |\n| `update_webhook` | Modify events or URL |\n| `delete_webhook` | Remove a webhook |\n| `test_webhook` | Send a test payload to a configured webhook endpoint |\n\n### Intelligence (4)\n\n| Tool | What it does |\n|------|-------------|\n| `get_business_context` | Full snapshot: profile, plan, recent activity, top clients, current month |\n| `get_monthly_summary` | Monthly P&L: revenue, expenses, profit, tax liability, top clients by revenue |\n| `get_quarterly_taxes` | Quarterly tax prep: Modelo 303/130 fields, collected vs deductible, liability |\n| `duplicate_invoice` | Clone an invoice for recurring billing (copies items/client/tax, starts as draft) |\n\n### E-Invoicing (10)\n\n> **Status: beta.** Tools call `api.frihet.io/v1/einvoice/*` directly. If an endpoint is not yet deployed (404), the tool falls back to `{ _stub: true, _note: \"CF endpoint pending deploy\", _plannedEndpoint: \"...\" }` so the server remains usable while transport ships.\n\n| Tool | What it does |\n|------|-------------|\n| `send_einvoice` | Dispatch an invoice in 11 formats (XRechnung, Factur-X, FatturaPA, PEPPOL, Facturae, UBL, CII) via email / Chorus Pro / SDI / PEPPOL / download |\n| `get_einvoice_status` | Poll Hatchet workflow run status until succeeded/failed — returns ackId, XML URL, PDF/A-3 URL |\n| `validate_einvoice_xml` | Validate raw XML against format schema + schematron rules (KOSIT / Mustang / XSD / Schematron) |\n| `export_datev` | Export accounting data as DATEV EXTF (Buchungsstapel / Debitoren / Kreditoren) in CP1252 encoding |\n| `einvoice_export` | Export e-invoice data in machine-readable formats (JSON/XML) for archival or integration |\n| `face_submit` | Submit invoice to FACe (Spain B2G government e-invoicing platform) |\n| `face_status` | Poll submission status from FACe for a submitted invoice |\n| `ticketbai_submit` | Submit TicketBAI fiscal record to Basque Country tax authority (Hacienda) |\n| `ticketbai_status` | Poll TicketBAI submission status from the Basque tax authority |\n| `ksef_submit` | Submit invoice to KSeF (Poland national e-invoicing system — stub) |\n\n### Time Tracking (6)\n\n> **Status: stub** — `/v1/time/*` endpoints planned. Tools surface 404 until backend ships.\n\n| Tool | What it does |\n|------|-------------|\n| `list_time_entries` | List time entries with filter by user, project, date range, billable status |\n| `get_time_entry` | Get full details of a single time entry by ID |\n| `create_time_entry` | Log hours for a project (billable flag, description, date) |\n| `update_time_entry` | Update any field on an existing time entry (PATCH semantics) |\n| `delete_time_entry` | Soft-delete a time entry (confirm=true required) |\n| `get_time_summary` | Aggregate total/billable/non-billable hours for a period, with optional groupBy (user/project/day) |\n\n### Recurring Invoices (8)\n\n> **Status: stub** — `/v1/recurring/*` endpoints planned. Tools surface 404 until backend ships.\n\n| Tool | What it does |\n|------|-------------|\n| `list_recurring_invoices` | List all recurring invoice templates (filter by active/paused) |\n| `get_recurring_invoice` | Get full details of a recurring template by ID |\n| `create_recurring_invoice` | Create a new recurring invoice template (daily/weekly/monthly/quarterly/yearly) |\n| `update_recurring_invoice` | Update template fields — affects future generated invoices only |\n| `pause_recurring_invoice` | Pause an active template — no invoices generated while paused |\n| `resume_recurring_invoice` | Resume a paused template — next invoice on next scheduled cycle |\n| `delete_recurring_invoice` | Permanently delete a template (confirm=true required) |\n| `run_recurring_now` | Manually trigger immediate generation of the next invoice instance |\n\n### Team Management (4)\n\n> **Status: stub** — `/v1/team/*` endpoints planned. Tools surface 404 until backend ships.\n\n| Tool | What it does |\n|------|-------------|\n| `list_team_members` | List all workspace members with role and invite status |\n| `invite_team_member` | Invite a new member by email with role (admin/member/viewer) |\n| `update_team_member_role` | Change an existing member's role |\n| `remove_team_member` | Remove a member from the workspace (confirm=true required) |\n\n### Gestoria — Accountants (5)\n\n> **Status: stub** — `/v1/gestoria/*` REST surface lands with Wave Fase 1 closure (PRs #383 bulk send, #384 aging, #385 messaging). Tools surface 404 until the backend ships.\n\n| Tool | What it does |\n|------|-------------|\n| `gestoria_message_send` | Send a message in a contextual thread (documentRequest / filingItem / obligation) |\n| `gestoria_messages_list` | List messages in a thread, newest first; paginate backwards with `before` |\n| `gestoria_template_create` | Create a reusable document request template with variables + due-date offset |\n| `gestoria_template_bulk_send` | Bulk send a template to up to 500 client workspaces in one call |\n| `gestoria_aging_consolidated` | Cross-client AR aging report (buckets, per-workspace breakdown, top overdue) |\n\n### Audit GL (3)\n\n> **Status: stub** — `/v1/gl/*` proxies callables `approveGLEntry`, `rejectGLEntry`, `getGLEntryAuditLog` (PR #395). Tools surface 404 until backend ships.\n\n| Tool | What it does |\n|------|-------------|\n| `frihet_gl_entry_approve` | Approve a GL journal entry (gestor/admin only — TRUST AREA) |\n| `frihet_gl_entry_reject` | Reject a GL entry with a mandatory reason (TRUST AREA) |\n| `frihet_gl_entry_audit_log` | Retrieve full audit trail for a GL entry |\n\n### White-label Portal Domain (3)\n\n> **Status: stub** — `/v1/portal/domain/*` proxies callables `addCustomPortalDomain`, `verifyCustomPortalDomain`, `removeCustomPortalDomain` (PR #397).\n\n| Tool | What it does |\n|------|-------------|\n| `frihet_portal_domain_add` | Add a custom domain to the client portal (returns DNS CNAME records) |\n| `frihet_portal_domain_verify` | Verify DNS propagation for a custom portal domain |\n| `frihet_portal_domain_remove` | Remove a custom portal domain (reverts to default Frihet subdomain) |\n\n### Self-onboard & VIES (2)\n\n> **Status: stub** — `/v1/portal/onboard/*` proxies callables `generatePortalOnboardLink`, `lookupTaxIdViaVIES` (PR #398). Public portal flows excluded from MCP.\n\n| Tool | What it does |\n|------|-------------|\n| `frihet_portal_onboard_link_generate` | Generate a time-limited self-onboard link for a prospective client |\n| `frihet_tax_id_vies_lookup` | Validate an EU VAT number (CIF intracomunitario) via VIES |\n\n### IGIC — Canary Islands Indirect Tax (4)\n\n> **Status: stub** — `/v1/igic/*` service-layer reads (PR #390). ATC SOAP excluded (internal infra).\n\n| Tool | What it does |\n|------|-------------|\n| `frihet_modelo_415_summary` | M415 annual operations >€3,005 (Canarias equivalent of M347) |\n| `frihet_modelo_425_summary` | M425 annual IGIC recap for Canary Islands businesses |\n| `frihet_modelo_418_summary` | M418 monthly IGIC return for large enterprises (grandes empresas) |\n| `frihet_aiem_calculate` | Calculate AIEM (Arbitrio Importación) for imported/produced goods in Canarias |\n\n### Impuesto sobre Sociedades — Corporate Tax (2)\n\n> **Status: stub** — `/v1/is/*` service-layer reads for Spanish SLs/SAs (PR #392).\n\n| Tool | What it does |\n|------|-------------|\n| `frihet_modelo_200_summary` | Modelo 200 annual IS return (taxable base, deductions, net payable) |\n| `frihet_modelo_202_summary` | Modelo 202 installment payments (1P April, 2P October, 3P December) |\n\n### Bank Categorization Rules (2)\n\n> **Status: stub** — `/v1/banking/rules` Q3-flagged (PR #394). Webhook handlers excluded.\n\n| Tool | What it does |\n|------|-------------|\n| `frihet_bank_rules_list` | List all bank auto-categorization rules (conditions + actions + status) |\n| `frihet_bank_rule_create` | Create a new rule to auto-categorize transactions by description, amount, counterparty |\n\n### Deposits (7)\n\n| Tool | What it does |\n|------|-------------|\n| `list_deposits` | List deposits with pagination |\n| `get_deposit` | Get deposit details by ID |\n| `create_deposit` | Record a new client deposit |\n| `update_deposit` | Update deposit fields |\n| `delete_deposit` | Delete a deposit (confirm=true required) |\n| `apply_deposit` | Apply a deposit balance against an invoice |\n| `refund_deposit` | Issue a refund for a deposit |\n\n### Vendors (5)\n\n| Tool | What it does |\n|------|-------------|\n| `list_vendors` | List all vendors/suppliers |\n| `get_vendor` | Get vendor details |\n| `create_vendor` | Add a new vendor |\n| `update_vendor` | Update vendor info |\n| `delete_vendor` | Remove a vendor |\n\n### Banking (5)\n\n| Tool | What it does |\n|------|-------------|\n| `list_bank_accounts` | List connected bank accounts |\n| `get_bank_account` | Get details for a bank account |\n| `list_transactions` | List bank transactions with filters |\n| `categorize_transaction` | Assign a category and expense/income type to a transaction |\n| `match_transaction_to_invoice` | Link a bank transaction to an existing invoice |\n\n### Fiscal — Spanish Tax Models (8)\n\n| Tool | What it does |\n|------|-------------|\n| `get_modelo_303_summary` | Quarterly IVA return (Modelo 303) — collected vs deductible, net payable |\n| `get_modelo_130_summary` | Quarterly IRPF installment for self-employed (Modelo 130) |\n| `get_modelo_390_summary` | Annual IVA summary (Modelo 390) |\n| `get_modelo_180_summary` | Annual withholding summary for rentals (Modelo 180) |\n| `get_modelo_347_summary` | Annual third-party transactions >€3,005 (Modelo 347) |\n| `verifactu_status` | Get VeriFactu submission status for a fiscal record |\n| `verifactu_resubmit` | Resubmit a rejected VeriFactu fiscal record |\n| `ticketbai_status` | Poll TicketBAI submission status (also available in E-Invoicing section) |\n\n### Vacation Rentals / Stay (5)\n\n| Tool | What it does |\n|------|-------------|\n| `list_reservations` | List rental reservations with filters |\n| `get_reservation` | Get reservation details |\n| `create_reservation` | Create a new reservation |\n| `list_properties` | List all rental properties |\n| `sync_channel` | Trigger OTA channel sync (Airbnb, Booking.com, etc.) |\n\n### POS — Point of Sale (4)\n\n| Tool | What it does |\n|------|-------------|\n| `list_terminals` | List registered POS terminals |\n| `get_sale` | Get details for a POS sale transaction |\n| `list_sales` | List POS sales with pagination |\n| `refund_sale` | Issue a refund for a POS sale |\n\n### HR — Human Resources (9)\n\n| Tool | What it does |\n|------|-------------|\n| `leave_request_create` | Create a leave request (vacation, sick, personal) |\n| `leave_approve` | Approve a pending leave request |\n| `leave_reject` | Reject a leave request with a reason |\n| `leave_cancel` | Cancel an approved or pending leave request |\n| `leave_list` | List leave requests with filters (user, status, date range) |\n| `attendance_clock_in` | Record clock-in for an employee |\n| `attendance_clock_out` | Record clock-out for an employee |\n| `overtime_report` | Generate overtime report for a period |\n| `anomaly_list` | List attendance anomalies (missing punches, excessive overtime) |\n\n### Payroll (2)\n\n| Tool | What it does |\n|------|-------------|\n| `payroll_export` | Export payroll data for a period (CSV/PDF for gestoría) |\n| `payroll_checklist` | Generate pre-payroll checklist: pending leaves, anomalies, overtime |\n\n### Onboarding (2)\n\n| Tool | What it does |\n|------|-------------|\n| `onboarding_status` | Get onboarding completion status for the current workspace |\n| `onboarding_persona_set` | Set or update the business persona (freelancer, SME, gestoría, etc.) |\n\n### Permissions (2)\n\n| Tool | What it does |\n|------|-------------|\n| `permissions_matrix` | Get the full permissions matrix for all roles in the workspace |\n| `permissions_me` | Get the current API key's effective permissions |\n\n### Period Close (3)\n\n| Tool | What it does |\n|------|-------------|\n| `period_close_status` | Get the close status for an accounting period |\n| `period_close` | Close an accounting period (gestor/admin only — TRUST AREA) |\n| `period_reopen` | Reopen a closed period with a mandatory reason (TRUST AREA) |\n\nAll 157 tools return **structured output** via `outputSchema` -- typed JSON, not raw text. List tools return paginated results (`{ data, total, limit, offset }`).\n\n---\n\n## Resources (11)\n\nContext the AI can read to make smarter decisions.\n\n**Static** (reference data, no API calls):\n\n| Resource | URI | What it provides |\n|----------|-----|-----------------|\n| API Schema | `frihet://api/schema` | OpenAPI summary: endpoints, auth, rate limits, pagination, error codes |\n| Tax Rates | `frihet://tax/rates` | Tax rates by Spanish fiscal zone: IVA, IGIC, IPSI, EU reverse charge, IRPF |\n| Tax Calendar | `frihet://tax/calendar` | Quarterly filing deadlines: Modelo 303, 130, 390, 420, VeriFactu timeline |\n| Expense Categories | `frihet://config/expense-categories` | 8 categories with deductibility rules, IVA treatment, amortization |\n| Invoice Statuses | `frihet://config/invoice-statuses` | Status flow (draft > sent > paid/overdue > cancelled), transition rules, webhook events |\n| Currencies | `frihet://config/currencies` | 40 supported currencies with ISO codes, symbols, decimal places, locale formatting |\n| Countries | `frihet://config/countries` | 61 supported countries with fiscal zones, default tax rates, currencies, invoice prefixes |\n\n**Dynamic** (live data from your account):\n\n| Resource | URI | What it provides |\n|----------|-----|-----------------|\n| Business Profile | `frihet://business-profile` | Your business info, plan, defaults, recent activity, top clients |\n| Monthly Snapshot | `frihet://monthly-snapshot` | Current month P&L, revenue, expenses, tax liability |\n| Overdue Invoices | `frihet://overdue-invoices` | All invoices past due date (up to 100) |\n| Plan Limits | `frihet://status/plan-limits` | Live plan tier, usage counters, invoices/month, API rate limits |\n\n---\n\n## Prompts (10)\n\nPre-built workflows the AI can execute as guided multi-step operations.\n\n| Prompt | What it does | Arguments |\n|--------|-------------|-----------|\n| `monthly-close` | Close the month: review unpaid invoices, categorize expenses, check tax obligations, generate summary | `month?` (YYYY-MM) |\n| `onboard-client` | Set up a new client with correct tax rates by location, optionally create a welcome quote | `clientName`, `country?`, `region?` |\n| `quarterly-tax-prep` | Prepare quarterly tax filing: calculate IVA/IGIC, identify deductibles, preview Modelo 303/130/420 | `quarter?`, `fiscalZone?` |\n| `overdue-followup` | Find overdue invoices, draft follow-up messages, suggest payment reminders | -- |\n| `new-client-invoice` | Create a client + first invoice in one workflow with tax rate lookup | `clientName`, `country?` |\n| `expense-report` | Generate expense report grouped by category with deductible totals | `month?` (YYYY-MM) |\n| `year-end-close` | Full annual closing: quarterly review, pending invoices, uncategorized expenses, year-end checklist | `year` (YYYY) |\n| `cash-flow-forecast` | Project cash flow for coming months: recurring income, expenses, overdue receivables, tax deadlines | `months?` (default: 3) |\n| `invoice-aging-review` | AR aging analysis: group unpaid invoices by bucket (0-30/31-60/61-90/90+ days), top debtors, collection actions | -- |\n| `expense-batch` | Process expenses in bulk: categorize, apply tax rates, flag missing receipts | `fiscalZone?` |\n\n---\n\n## How it works\n\n```mermaid\ngraph LR\n AI[\"Your AI assistant\"]\n MCP[\"frihet-mcp\"]\n API[\"api.frihet.io\"]\n DB[\"Frihet ERP\"]\n\n AI -- \"create_invoice()\" --> MCP\n MCP -- \"POST /v1/invoices\" --> API\n API --> DB\n DB -- \"201 + invoice data\" --> API\n API -- \"structured JSON\" --> MCP\n MCP -- \"typed response + suggestions\" --> AI\n\n style AI fill:#09090b,stroke:#4ade80,color:#fafafa\n style MCP fill:#09090b,stroke:#fafafa,color:#fafafa\n style API fill:#09090b,stroke:#3f3f46,color:#a1a1aa\n style DB fill:#09090b,stroke:#3f3f46,color:#a1a1aa\n```\n\nThe server translates tool calls into REST API requests. It handles authentication, rate limiting (automatic retry with backoff on 429), pagination, and error mapping.\n\nTwo transports:\n- **stdio** (local) -- `npx @frihet/mcp-server` with `FRIHET_API_KEY`\n- **Streamable HTTP** (remote) -- `https://mcp.frihet.io/mcp` with Bearer token or OAuth 2.0+PKCE\n\n### Environment variables\n\n| Variable | Required | Default |\n|----------|----------|---------|\n| `FRIHET_API_KEY` | Yes (stdio) | -- |\n| `FRIHET_API_URL` | No | `https://api.frihet.io/v1` |\n| `FRIHET_TOOL_MODE` | No | `full` |\n\n---\n\n## Tool exposure: depth served on demand\n\nFrihet's differentiator is **depth** — full ES/EU fiscal coverage plus native compliance (VeriFactu, TicketBAI, Facturae/FACe/KSeF), banking, CRM, HR/payroll, stay/PMS and POS. But a flat list of every tool, loaded into an agent's context up front, is the 2026 context-rot problem: it crowds out the task and degrades tool selection before any work begins.\n\n`FRIHET_TOOL_MODE` lets you choose how that depth is exposed.\n\n| Mode | Behavior |\n|------|----------|\n| `full` (default) | All tools are exposed with their full descriptions and schemas. **Unchanged from previous releases** — existing setups are unaffected. |\n| `grouped` | **Progressive disclosure.** Each tool's description collapses to a one-line `[group] summary — full schema via describe_tool('name')`, and three lightweight discovery tools are added. The agent loads depth only for the tools it actually needs. |\n\nIn `grouped` mode the tools are unchanged — same names, same input schemas, same behavior. Only the *up-front context cost* changes. Discovery flows through three meta-tools:\n\n- **`list_tool_groups()`** — the domain map (invoicing, expenses, fiscal/compliance, banking, CRM, HR/payroll, stay/PMS, POS, intelligence, products, platform) with a one-line blurb and tool count for each.\n- **`search_tools(query)`** — free-text search across tool name, title, summary and group; returns matching tools with their group, summary, read-only flag and input fields. Optional `group` filter and `limit`.\n- **`describe_tool(name)`** — the full original description and input fields for one tool, on demand, before you call it.\n\n```jsonc\n// claude_desktop_config.json — opt in to grouped mode\n{\n \"mcpServers\": {\n \"frihet\": {\n \"command\": \"npx\",\n \"args\": [\"@frihet/mcp-server\"],\n \"env\": {\n \"FRIHET_API_KEY\": \"fri_...\",\n \"FRIHET_TOOL_MODE\": \"grouped\"\n }\n }\n }\n}\n```\n\n> This is an opt-in exposure layer only — it never changes a tool's logic, name or behavior, and `full` mode is byte-identical to before. The same interceptor pattern powers the OpenAI-safe profile (`FRIHET_OPENAI_MODE`).\n\n---\n\n## API limits\n\n| Limit | Value |\n|-------|-------|\n| Requests per minute | 100 per API key |\n| Results per page | 100 max (50 default) |\n| Request body | 1 MB max |\n| Webhook payload | 100 KB max |\n| Webhooks per account | 20 max |\n\nRate limiting is handled automatically with exponential backoff.\n\n---\n\n## Claude Code Skill\n\nBeyond raw MCP tools, this repo includes a **Claude Code skill** that adds business context: Spanish tax rules, workflow recipes, financial reports, and natural language commands.\n\n### Install the skill\n\n```bash\ngit clone https://github.com/Frihet-io/frihet-mcp.git\nln -s \"$(pwd)/frihet-mcp/skill\" ~/.claude/skills/frihet\n```\n\nOr with the universal installer:\n\n```bash\nnpx skills add Frihet-io/frihet-mcp\n```\n\n### Commands\n\n| Command | What it does |\n|---------|-------------|\n| `/frihet status` | Account overview, recent activity, pending payments |\n| `/frihet invoice` | Create, list, search invoices |\n| `/frihet expense` | Log and query expenses |\n| `/frihet clients` | Manage client database |\n| `/frihet quote` | Create and manage quotes |\n| `/frihet report` | Financial summaries (P&L, quarterly, overdue) |\n| `/frihet webhooks` | Configure automation triggers |\n| `/frihet setup` | Guided setup and connection test |\n\nThe skill knows about IVA rates, IRPF retention, Modelo 303 prep, expense deductibility rules, and VeriFactu compliance.\n\nFull documentation: [docs.frihet.io/desarrolladores/skill-claude-code](https://docs.frihet.io/desarrolladores/skill-claude-code)\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/Frihet-io/frihet-mcp.git\ncd frihet-mcp\nnpm install\nnpm run build\n```\n\nRun locally:\n\n```bash\nFRIHET_API_KEY=fri_xxx node dist/index.js\n```\n\nTest with the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector):\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n---\n\n## Contributing\n\nContributions are welcome. Please open an issue first to discuss what you'd like to change.\n\n```bash\ngit clone https://github.com/Frihet-io/frihet-mcp.git\ncd frihet-mcp\nnpm install\nnpm run build # must pass before submitting\n```\n\n---\n\n## Current limitations\n\n- **No OCR or file upload** -- the MCP works with structured data, not images or PDFs. Planned for a future release.\n- **Single company** -- one API key maps to one Frihet workspace. Multi-company support is not yet available.\n- **Frihet account required** -- you need an active account at [app.frihet.io](https://app.frihet.io) and an API key (starts with `fri_`).\n\n---\n\n## Ecosystem\n\n| Package | What it is |\n|---------|-----------|\n| [`@frihet/mcp-server`](https://www.npmjs.com/package/@frihet/mcp-server) | This MCP server (157 tools, 11 resources, 10 prompts) |\n| [`@frihet/sdk`](https://github.com/Frihet-io/frihet-sdk) | TypeScript SDK (`frihet.invoices.create()`) |\n| [`frihet`](https://www.npmjs.com/package/frihet) | CLI (`frihet invoices list --status overdue`) |\n| [`n8n-nodes-frihet`](https://www.npmjs.com/package/n8n-nodes-frihet) | n8n community node for workflow automation |\n| [REST API](https://docs.frihet.io/desarrolladores/api-rest) | OpenAPI 3.1 at `api.frihet.io/v1` |\n| [Remote MCP](https://mcp.frihet.io) | Hosted endpoint on Cloudflare Workers (zero install) |\n| [Webhooks](https://docs.frihet.io/desarrolladores/webhooks) | Real-time events with HMAC-SHA256 |\n\n## Links\n\n- [Frihet](https://frihet.io) -- The product\n- [Documentation](https://docs.frihet.io) -- Full docs\n- [API reference](https://docs.frihet.io/desarrolladores/api-rest) -- REST API\n- [MCP server docs](https://docs.frihet.io/desarrolladores/mcp-server) -- Setup guides, troubleshooting\n- [npm](https://www.npmjs.com/package/@frihet/mcp-server) -- Package registry\n- [Smithery](https://smithery.ai/server/frihet/frihet-mcp) -- Smithery marketplace\n- [MCP Registry](https://registry.modelcontextprotocol.io/?q=io.frihet) -- Anthropic official registry\n- [Remote endpoint](https://mcp.frihet.io) -- Hosted MCP server (Cloudflare Workers)\n- [OpenAPI spec](https://api.frihet.io/openapi.yaml) -- Machine-readable API definition\n\n---\n\n## License\n\nMIT. See [LICENSE](https://github.com/Frihet-io/frihet-mcp/blob/main/LICENSE).\n\nBuilt by [Frihet](https://frihet.io).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_96":83,"_97":83},"ratingAvg","reviewCount","topics",[108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127],"license","MIT","language","TypeScript","registryName","io.frihet/erp","homepage","https://frihet.io","accounting","ai","ai-native","automation","billing","business-management","claude","claude-code-plugin","claude-code-skill","cloudflare-workers","erp","fintech","invoicing","llm","mcp","mcp-server","model-context-protocol","saas","tax-compliance","typescript","ENV",{"_130":131,"_132":133,"_134":135},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]