MCP Economic

🚀 MCP Economic Integration

This is a server implementation of the Model Context Protocol (MCP) for e-conomic. It serves as a bridge between the MCP protocol and the e-conomic API, enabling standardized access to e-conomic's accounting and business functions through Claude Desktop.

🚀 Quick Start

This is a server implementation of the Model Context Protocol (MCP) for e-conomic. It provides a bridge between the MCP protocol and the e-conomic API, allowing standardized access to e-conomic's accounting and business functions via Claude Desktop.

✨ Features

• Robust Authentication: Secure token-based authentication using APP_SECRET_TOKEN and AGREEMENT_GRANT_TOKEN.
• Comprehensive Financial Management:
  • Account directory access with filtering and categorization capabilities.
  • Invoice lifecycle management (draft, recorded, paid, unpaid).
  • Customer and supplier relationship management.
  • Entry creation and management.

Table of Contents

• Prerequisites
• Installation
• Configuring Your e-conomic Developer Account
• Configuration
• Security
• Available MCP Commands

📦 Prerequisites

Before you begin, ensure you meet the following requirements:

• Python 3.12.2 or higher is installed.
• You are using a macOS, Linux, or Windows operating system.
• A dependency management tool (such as pip) is installed.

📦 Installation

To install MCP Economic Integration, follow these steps:

Install using pip

pip install mcp-economic-integration

Install from source

git clone https://github.com/your-organization/mcp-economic-integration.git
cd mcp-economic-integration
python setup.py install

📚 Configuring Your e-conomic Developer Account

To use MCP Economic Integration, you need to configure your e-conomic developer account first:

1. Visit the e-conomic Developer Portal.
2. Create a new application and obtain the following credentials:
   • Client ID
   • Client Secret
3. Configure the MCP Economic Integration library using these credentials.

Example Configuration

from mcp_economic_integration import configure

configure(
    client_id="your_client_id",
    client_secret="your_client_secret"
)

📚 Configuration

After installation, you can configure the following as needed:

Set up logging

logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)
logger = logging.getLogger(__name__)

Set up a proxy (optional)

If you need to access e-conomic services through a proxy, configure the following environment variables:

export HTTP_PROXY=http://your-proxy-server:port
export HTTPS_PROXY=https://your-proxy-server:port

🔧 Security

Please note the following security best practices:

• Do not run this code in a production environment.
• Protect your credentials to avoid leakage.
• Regularly update dependencies to prevent known vulnerabilities.

💻 Available MCP Commands

MCP Economic Integration provides the following tools, organized by category:

Account Management

• get_accounts: Get a list of accounts in the account directory with filtering options:
  • Filter by type (profit and loss, status, total amount from, title, etc.).
  • Filter by blocking status.
  • Filter by debit/credit type.
  • Filter by blocking direct booking status.
• get_account: Get detailed information about a specific account by account number.

Invoice Management

• get_booked_invoices: Get all recorded (final) invoices.
• get_draft_invoices: Get all draft (unfinalized) invoices.
• get_paid_invoices: Get all paid invoices.
• get_unpaid_invoices: Get all unpaid invoices.
• get_invoice_totals: Get a summary total of all invoices.
• create_draft_invoice: Create a new draft invoice with detailed customer and payment information.

Entry Management

• create_supplier_invoice_entry: Create a supplier invoice entry.
• create_supplier_payment_entry: Create a supplier payment entry.
• create_customer_payment_entry: Create a customer payment entry.
• create_customer_invoice_entry: Create a customer invoice entry.

Supplier Management

• get_suppliers: Get a list of all suppliers.
• get_supplier_groups: Get a list of all supplier groups.

Customer Management

• get_customers: Get a list of all customers.
• get_customer_totals: Get the account totals for a specific customer.
• get_customer_groups: Get a list of all customer groups.

Each tool returns a standardized JSON response, including:

• Success/error status
• Relevant data or error details
• Pagination information (if applicable)
• Additional context and metadata

Error handling is consistent across all tools, providing detailed error messages and suggestions for resolving issues.