fatturafacile-mcp-server
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
fatturafacile-mcp-server
Official Model Context Protocol (MCP) AI Gateway for the Fattura Facile ERP ecosystem.
Overview
fatturafacile-mcp-server is an enterprise-grade AI Gateway enabling LLMs, Autonomous Agents, and Copilots to safely, reliably, and auditably interact with the Fattura Facile ERP backend via the standard Model Context Protocol (MCP).
It exposes comprehensive ERP operations across invoicing, CRM, quotation, catalog management, payments, and analytics, backed by strict multi-tenancy isolation, role-based access control (RBAC), OpenTelemetry distributed tracing, Redis caching, and transactional multi-step workflows.
Related MCP server: HiveDesk
Architectural Highlights
OpenAPI Single Source of Truth: All ERP communication is performed strictly via SDK client interfaces with no duplicate DTOs or handwritten HTTP models.
Multi-Tenancy & Zero Leakage: Every execution is scoped by explicit
TenantContext,UserContext,CompanyContext, andPermissionContext. Cache keys and audit trails are completely partitioned.Unified Tool Framework: Centralized lifecycle incorporating Zod schema validation, RBAC checks, OpenTelemetry spans, exponential backoff retries, structured error handling, and multi-tenant Redis caching.
Pluggable MCP Transports: Native support for
stdio,streamable-http, and legacyssetransports.Agentic Workflow Engine: Multi-step business workflows with automated compensation actions and transaction rollback support.
Vendor-Neutral Semantic Search: Abstracted vector storage and retrieval layer for future RAG and knowledge graph capabilities.
Capabilities Overview
1. 39 MCP Tools (Actions)
Category | Available Tools |
Customers |
|
Invoices |
|
Quotes |
|
Payments |
|
Products & Services |
|
Companies & Contacts |
|
Projects & Tasks |
|
Files & Documents |
|
2. 22 Dynamic MCP Resources (Context)
Company:
company://profile,company://settings,company://statistics,company://subscriptionsCustomers:
customer://recent,customer://top,customer://inactive,customer://vipProducts:
product://catalog,product://top-selling,product://low-stockQuotes:
quote://recent,quote://drafts,quote://expiringInvoices:
invoice://latest,invoice://drafts,invoice://paid,invoice://overdue,invoice://unpaidPayments:
payment://recent,payment://reconciliationProjects:
project://recent,project://activeDashboards:
dashboard://summary,dashboard://sales,dashboard://customers,dashboard://cashflow,dashboard://invoices
3. 20 Pre-Engineered Prompts (Guided Interactions)
Sales:
CreateQuotePrompt,CreateInvoicePrompt,SendInvoicePrompt,InvoiceReminderPrompt,SalesSummaryPrompt,SalesForecastPrompt,RevenueAnalysisPromptCustomers:
CustomerLookupPrompt,CustomerAnalysisPrompt,CustomerRiskPrompt,CustomerHealthPromptFinance:
FinancialOverviewPrompt,CashFlowPrompt,ProfitabilityPrompt,OverdueInvoicesPrompt,RevenueForecastPromptProductivity:
DailySummaryPrompt,WeeklySummaryPrompt,ManagementReportPrompt,ExecutiveReportPrompt
4. Agentic Workflows
Customer Onboarding & Quote Generation: Multi-step client onboarding with automatic commercial quotation and compensation on failure.
Quote-to-Invoice Conversion & Dispatch: Converts accepted customer quotes to official invoices and automatically transmits them.
Overdue Invoice Recovery: Scans outstanding balances, calculates dunning terms, and dispatches compliant reminders.
Monthly Executive Reporting: Aggregates P&L metrics, cashflow projections, and customer health for board briefings.
Getting Started
Prerequisites
Node.js >= 22.x LTS
pnpm>= 9.x (v12 supported)Redis (optional, in-memory cache fallback is active by default)
Installation
# Clone the repository
git clone https://github.com/FatturaFacile/fatturafacile-mcp-server.git
cd fatturafacile-mcp-server
# Install dependencies
pnpm install --frozen-lockfile
# Configure environment
cp .env.example .envRunning the Server
# Development mode with hot-reload
pnpm run dev
# Compile TypeScript to dist/
pnpm run build
# Start production server (stdio by default)
pnpm start
# Start with Streamable HTTP / SSE transport on port 3000
MCP_TRANSPORT=streamable-http PORT=3000 pnpm startClient Integration Examples
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"fattura-facile": {
"command": "node",
"args": ["C:/dev/fattura-facile/mcp-server/dist/index.js"],
"env": {
"MCP_TRANSPORT": "stdio",
"FATTURA_FACILE_API_URL": "https://api.fatturafacile.eu",
"FATTURA_FACILE_API_KEY": "your_api_key_here"
}
}
}
}Cursor & Windsurf
In .cursor/mcp.json or Windsurf's mcp_config.json:
{
"mcpServers": {
"fattura-facile": {
"command": "node",
"args": ["C:/dev/fattura-facile/mcp-server/dist/index.js"],
"env": {
"MCP_TRANSPORT": "stdio"
}
}
}
}Testing & Quality Assurance
# Run unit and integration tests (Vitest)
pnpm test
# Run tests with code coverage
pnpm run test:coverage
# Typecheck with TypeScript strict mode
pnpm run typecheck
# Code linting
pnpm run lint
# Code style check
pnpm run format:checkDocker Deployment
# Build and run containerized server with Redis
docker-compose up --build -d
# Check service health
curl http://localhost:3000/healthDocumentation
License
This project is open-source software licensed under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceGoverned MCP bridge that lets AI clients query live ERP data via SuiteQL, saved searches, and records, with role-based permissions and full audit logging.-
- AlicenseNot gradedqualityDmaintenanceMCP server that exposes an in-browser AI ERP (CRM, stock, invoices, HR) with role-aware agents, enabling natural language chat and confirm-before-write actions.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants like Claude, ChatGPT, and Copilot to access SAP Business One, S/4HANA Cloud, and Concur data through MCP tools for partners, orders, invoices, expense reports, and more.AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents such as ChatGPT, Claude, and local LLMs to operate an enterprise digital-operations platform through MCP, exposing 19 model tools and 3 app-only tools for identity, data, workflow, files, and PII-controlled operations with role-based permissions and two-phase confirmations.Apache 2.0