Official MCP server for Frihet ERP — 157 tools for AI-powered invoicing, tax & e-invoicing compliance (VeriFactu, TicketBAI, Facturae), banking, CRM, HR/payroll & POS. Works with Claude, Cursor, Windsurf, Cline, ChatGPT.
SaferSkills independently audited frihet-mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Business assistant inside Claude Code. Manage invoices, expenses, clients, products, and quotes in plain language — with built-in Spanish tax intelligence.
Requires: Frihet account with API access + @frihet/mcp-server configured as MCP server.
Add to your Claude Code MCP config (~/.claude/mcp.json or project .mcp.json):
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_your_api_key_here"
}
}
}
}Get your API key at app.frihet.io > Settings > API.
Run /frihet status — if you see your account info, you're ready.
| Command | What it does | Example |
|---|---|---|
/frihet status | Account overview: recent invoices, pending payments, month's expenses | /frihet status |
/frihet invoice | Create, list, search invoices | /frihet invoice "Acme 3500 EUR consulting enero" |
/frihet expense | Log and query expenses | /frihet expense "47.50 gasolina 15 feb" |
/frihet clients | Manage client database | /frihet clients "Acme" |
/frihet quote | Create and manage quotes | /frihet quote create |
/frihet report | Financial summaries and P&L | /frihet report quarterly |
/frihet webhooks | Configure automation triggers | /frihet webhooks |
/frihet setup | Guided connection setup | /frihet setup |
| Resource | Tools | Operations |
|---|---|---|
| Intelligence | 4 | get_business_context, get_monthly_summary, get_quarterly_taxes, duplicate_invoice |
| Invoices | 6 | list, get, create, update, delete, search |
| Expenses | 5 | list, get, create, update, delete |
| Clients | 5 | list, get, create, update, delete |
| Products | 5 | list, get, create, update, delete |
| Quotes | 5 | list, get, create, update, delete |
| Webhooks | 5 | list, get, create, update, delete |
| Banking | 5 | list_bank_accounts, get_bank_account, list_transactions, categorize_transaction, match_transaction_to_invoice |
| Fiscal | 8 | modelo_303/130/390/180/347, verifactu_status, verifactu_resubmit, ticketbai_status |
| Stay | 5 | list_reservations, get_reservation, create_reservation, list_properties, sync_channel |
| POS | 4 | list_terminals, get_sale, list_sales, refund_sale |
| Time Tracking | 4 | list_time_entries, create_time_entry, update_time_entry, delete_time_entry |
| Recurring Invoices | 2 | list_recurring_invoices, run_recurring_now |
Determine the correct tax based on the client's fiscal zone:
| Fiscal Zone | Tax | General Rate | Reduced | Super-reduced |
|---|---|---|---|---|
peninsula | IVA | 21% | 10% | 4% |
canarias | IGIC | 7% | 3% | 0% |
ceuta_melilla | IPSI | 10% | — | — |
eu | Reverse charge | 0% | — | — |
world | Exempt | 0% | — | — |
Decision flow for invoices:
peninsula → apply IVA at the rate matching the product/service typecanarias → apply IGIC instead of IVAeu → 0% with "Inversión del sujeto pasivo" / "Reverse charge" noteworld → 0% exempt, no tax lineIRPF retention (professional services only):
For full tax details including quarterly models, deadlines, and expense deductibility rules, see references/tax-guide.md.
Auto-categorize expenses by matching keywords in the description:
| Category | Keywords (ES/EN) |
|---|---|
office | oficina, papelería, material, supplies, stationery |
technology | software, SaaS, hosting, dominio, hardware, cloud |
travel | viaje, vuelo, tren, hotel, parking, flight, train |
food | comida, restaurante, café, meal, lunch, dinner |
vehicle | gasolina, combustible, fuel, peaje, toll, mantenimiento |
professional | asesoría, gestoría, abogado, notario, consulting |
marketing | publicidad, ads, diseño, campaign, SEO, social |
general | anything that doesn't match above |
draft → sent → paid
→ overdue → paid
→ cancelledRectificativa (credit note) types: R1 (error), R2 (insolvency), R3 (discount), R4 (other), R5 (simplified).
draft → sent → accepted → (convert to invoice)
→ rejected
→ expiredBrief workflow outlines — for detailed step-by-step recipes, see references/workflows.md.
Monthly close ("cierre mensual"): List month's invoices + expenses → calculate income, expenses, IVA collected vs paid, net result → flag unpaid invoices.
Tax prep 303 ("IVA trimestral", "303"): Sum quarter's IVA repercutido (invoices) - IVA soportado (deductible expenses) → present pre-filled 303 data.
Client onboarding: Create client → optionally create product → create invoice → confirm.
Expense batch ("gastos del mes"): Parse multiple expenses → create each with auto-categorized category → summary table with deductible split.
Overdue follow-up ("morosos"): List overdue invoices → sort by amount → suggest follow-up actions.
Quote to invoice: Get accepted quote → create invoice copying client/items/notes → mark quote as accepted.
| Error | What to tell the user | Action |
|---|---|---|
| 401 Unauthorized | "API key inválida o expirada. Revisa tu configuración en app.frihet.io > Settings > API." | Guide to /frihet setup |
| 404 Not Found | "No encontré ese recurso. Comprueba el ID o busca por nombre." | Suggest search tool |
| 429 Rate Limited | "Demasiadas peticiones. Esperando {retryAfter}s..." | Auto-retry with backoff |
| Network Error | "No puedo conectar con Frihet. Verifica tu conexión." | Check MCP server status |
| No MCP Server | "El servidor MCP de Frihet no está configurado. Ejecuta /frihet setup." | Guide setup |
For full error code reference and pagination patterns, see references/api-patterns.md.
1,234.56 EUR (dot for decimals, comma for thousands)references/tax-guide.md — Full Spanish tax knowledge: IVA/IGIC/IRPF rates, fiscal zones, quarterly calendar, expense deductibility, VeriFactu, Crea y Crecereferences/workflows.md — Detailed workflow recipes with step-by-step MCP tool calls and response formatting templatesreferences/api-patterns.md — API rate limits, pagination, error codes, response formatting conventions~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.