MCP FacturaScripts

Version 1.0.1 - A comprehensive Model Context Protocol (MCP) server that integrates with FacturaScripts ERP system, providing seamless access to business, accounting, and administrative data through the MCP protocol.

Features

• 56 MCP Resources: Complete coverage of FacturaScripts entities including business transactions, accounting accounts, contacts, inventory, system administration, and more
• 57 Interactive Tools: Including specialized business analytics tools for advanced data analysis
• Full Accounting Integration: Access to accounting accounts, entry concepts, bank accounts, and financial data
• Business Analytics: Best-selling products analysis, invoice search by tax ID, and comprehensive business intelligence
• Contact & CRM Management: Comprehensive contact management with customer and supplier relationships
• Business Operations: Orders, invoices, quotes, delivery notes, products, suppliers, and inventory
• System Administration: API access control, scheduled jobs, attachments, and configuration
• MCP Protocol: Full compatibility with Model Context Protocol for AI integration
• RESTful Integration: Connects to FacturaScripts REST API v3
• TypeScript: Built with TypeScript for type safety and better development experience
• Advanced Filtering: Support for filters, sorting, and pagination on all resources
• Claude Desktop Integration: Interactive tools for seamless AI assistant integration
• Comprehensive Testing: 374 unit and integration tests with Test-Driven Development approach and modular test organization
• TypeScript SDK Examples: Production-ready code samples and comprehensive developer documentation
• MCP Inspector Compatible: Auto-building entry point ensuring compatibility with MCP Inspector and development tools

Prerequisites

• Node.js 18 or higher
• FacturaScripts installation with API access
• Valid API token for FacturaScripts

Installation

1. Clone the repository:

git clone https://github.com/cristotodev/MCP_Facturascripts.git
cd MCP_Facturascripts

2. Install dependencies:

npm install

3. Configure environment variables:

cp .env.example .env

Edit .env with your FacturaScripts configuration:

FS_BASE_URL=http://your-facturascripts-domain.com
FS_API_VERSION=3
FS_API_TOKEN=your-api-token-here

Usage

Development

npm run dev

Production

npm run build
npm start

Testing with MCP Inspector

npx @modelcontextprotocol/inspector npm run mcp

Important: Use npm run mcp (not npm run dev) to ensure JavaScript execution for MCP Inspector compatibility.

MCP Resources

All 56 resources support pagination with limit, offset, filter, and order parameters and return data in a consistent format with metadata.

📊 Business Core Resources

Clientes (Clients)