@frihet/mcp-server

Servidor MCP nativo con IA para gestión empresarial.
Works with Claude · ChatGPT · Cursor · Windsurf · Cline · Antigravity · Codex · Copilot · Gemini CLI — and any MCP-compatible client.
=20">
---
Distribution
| Channel | Status | Install |
|---------|--------|---------|
| **npm** | Live | npx @frihet/mcp-server |
| **Remote endpoint** | Live | https://mcp.frihet.io/mcp (zero install, OAuth or API key) |
| **Smithery** | Live | smithery.ai/servers/frihet/frihet-mcp |
| **MCP Registry** | Live | registry.modelcontextprotocol.io |
| **GitHub MCP Registry** | Live | github.com/mcp/io.frihet/erp |
| **Glama** | Live | glama.ai/mcp/servers/Frihet-io/frihet-mcp |
| **mcp.so** | Auto-index (unverified) | mcp.so — indexes from npm + GitHub |
| **PulseMCP** | Auto-index (unverified) | pulsemcp.com — indexes from npm + GitHub |
| **Cursor Marketplace** | Coming soon | cursor.com/marketplace |
| **ChatGPT Apps** | Coming soon | chatgpt.com |
| **Anthropic Claude Directory** | Coming soon | claude.ai/settings/connectors |
> **Surface truth:** the catalogue contains 156 canonical operations. The local full profile serves 161 tool names, 11 resources, and 10 prompts (156 canonical operations plus 5 fiscal aliases). The hosted grouped profile serves 164 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. Catalogue membership is not a promise that a backing API is enabled for every workspace.
---
What is this
An MCP server that connects your AI assistant to Frihet. Create invoices by talking. Query expenses in natural language. Manage your entire business from your IDE.
156 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.
---
Try it instantly (no signup)
Kick the tires with zero setup — no account, no API key:
In demo mode the server answers from realistic **example fixtures** (Spanish invoices with IVA/IGIC, expenses, clients, products, a bank account, and more) — every record uses demo_-prefixed IDs and the server prints a DEMO MODE banner on startup. **Nothing is persisted** and no network call is ever made. Writes are simulated and fiscal actions (e-invoice, VeriFactu, TicketBAI, FACe, payroll) return a clearly-labeled simulation — never a real submission to any tax authority.
When you're ready for your real data, drop the flag and add your key (app.frihet.io → Settings → API keys). See Install below.
---
For AI agents
If you are an agent reading this repository rather than a person reading a page, everything you need is machine-readable and generated from the running server — you do not have to parse this README.
| What | Where |
|------|-------|
| Onboarding contract: quickstart per client, auth, safe workflow, human-authority tool lists, error recovery | docs/agent-onboarding.json — also shipped inside 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 — your client hands it to you automatically |
Three rules the contract encodes, in short:
1. **Orient before acting.** get_business_context and the frihet://tax/rates resource decide the correct fiscal treatment. Do not recall a Spanish tax rate from memory.
2. **Draft, show, stop.** create_invoice, create_quote and create_credit_note all default to status=draft — no fiscal number, no hash, nothing sent to a tax authority. Present the draft and hand back.
3. **Human authority is not yours to assume.** Any tool with a non-empty externalSideEffects reaches a client's inbox, a webhook, money, or AEAT / VeriFactu / TicketBAI / FACe. Several also take confirm=true; that flag records a human decision — never set it to satisfy your own plan.
docs/agent-onboarding.json is regenerated from the live surface by npm run generate:agent-onboarding and gated in CI by npm run gate:agent-onboarding, so its tool lists and counts cannot drift from the server.
---
Install
One-line (Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, and more)
Claude Code plugin (skill + MCP server in one install)
This repository is also a Claude Code plugin (frihet-erp): installing it wires up both the business-management skill and the MCP server.