English Français العربية

io.github.Eqvitta/eqvitta-mcp

السجل الرسمي المالية والمدفوعات

Eqvitta MCP: GST billing, ledgers, invoices, stock and financial reports for Claude.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.Eqvitta/eqvitta-mcp؟

  • GST Invoicing:
  • Ledgers & Account Groups:
  • Vouchers & Transactions:
  • Real-Time Financial Reports:
  • Role-Based Security:

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package eqvitta-mcp
Claude Code 
claude mcp add eqvitta-mcp -e 'EQVITTA_API_KEY=<your eqvitta_api_key>' -- npx -y eqvitta-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "eqvitta-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "eqvitta-mcp@1.0.1"
            ],
            "env": {
                "EQVITTA_API_KEY": "<your eqvitta_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • EQVITTA_API_KEY إلزامي سري Your Eqvitta API key (generated in Eqvitta Settings > API Keys)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Eqvitta Accounting MCP Server
  2. ⚡ Quick Start with Claude Desktop
  3. 🚀 Key Features
  4. 🛠️ Available MCP Tools
  5. 🔒 Security & Architecture
  6. 📄 License

Eqvitta Accounting MCP Server

Official Model Context Protocol (MCP) server for Eqvitta Cloud Accounting & GST Billing.

Connect Claude Desktop, Claude Code, and any MCP-compliant AI client directly to your Eqvitta accounting records. Seamlessly generate GST sales & purchase invoices, manage ledgers, post receipts & payments, query trial balances, and reconcile financial statements with strict role-based data isolation.

⚡ Quick Start with Claude Desktop

Automatic 1-Click Install (Smithery)

If using Smithery:

npx -y @smithery/cli install eqvitta-mcp --client claude
Manual Configuration

Add the server to your claude_desktop_config.json:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "eqvitta": {
      "command": "npx",
      "args": ["-y", "github:Eqvitta/eqvitta-mcp"],
      "env": {
        "EQVITTA_API_KEY": "YOUR_EQVITTA_API_KEY_HERE"
      }
    }
  }
}

How to get your API Key: Log in to Eqvitta > Settings > API Keys > Generate a new Key.

🚀 Key Features

  • GST Invoicing:
    • Automatically calculates CGST, SGST, IGST, and rounding off.
    • Automatically assigns the next sequential invoice number (e.g. NR/2627/005).
    • Creates balanced double-entry ledger postings instantly.
  • Ledgers & Account Groups:
    • Look up ledgers, outstanding balances, party contact details, and account group structures.
  • Vouchers & Transactions:
    • Record Bank / Cash receipts and payments against customers, suppliers, and expense ledgers.
    • Record outward and inward service invoices.
  • Real-Time Financial Reports:
    • Instant Trial Balance, Profit & Loss summaries, and Ledger Account Statements.
  • Role-Based Security:
    • Multi-tenant tenant isolation. All actions are scoped to companies the API key user is assigned to.
    • Destructive operations (edits and deletions) are strictly disabled over MCP.
    • Internal ledger transfers and financial adjustments require elevated administrative privileges (financialreporteditor or company_admin).

🛠️ Available MCP Tools

CategoryToolsDescription
Companies & Ledgerslist_companies, search_ledgers, get_ledger_balance, get_ledger_statement, update_ledger_contactExplore companies, query balances, and view statement entries.
Inventory & Catalogssearch_stocks, get_stock_detail, search_account_groupsSearch stock items, quantities, HSN/SAC codes, and accounting groups.
Invoicingcreate_sales_invoice, create_purchase_invoice, create_service_outward, create_service_inward, create_logistic_invoiceGenerate GST-compliant sales, purchase, service, and freight vouchers.
Receipts & Paymentscreate_receipt_voucher, create_payment_voucherRecord customer payments and supplier payouts against bank/cash accounts.
Financial Reportsget_trial_balance, get_financial_statementRetrieve structured balance sheet and profit & loss figures.
Challanssearch_challans, get_challan_detailTrack delivery and transport challans.
Admin Transfers (Gated)transfer_ledger_journal, transfer_group_balances_journal, bulk_transfer_transactions_ledgerShift ledger entries and transfer balances (only visible to authorized roles).

🔒 Security & Architecture

The eqvitta-mcp CLI connects to Eqvitta's high-availability remote engine (https://chatapi.eqvitta.com/webhook/mcp).

  • Zero Local Maintenance: All schema changes and accounting rule updates are managed on the cloud engine. Your client never requires manual version updates.
  • Encrypted Communication: All traffic is encrypted over TLS 1.3.
  • Least Privilege: Only tools authorized by the user's role are exposed to the AI model.

📄 License

MIT License. Copyright (c) 2026 Eqvitta Software Solutions.

الأسئلة الشائعة

ما هو io.github.Eqvitta/eqvitta-mcp؟

Eqvitta MCP: GST billing, ledgers, invoices, stock and financial reports for Claude.

كيف أثبّت io.github.Eqvitta/eqvitta-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add eqvitta-mcp -e 'EQVITTA_API_KEY=<your eqvitta_api_key>' -- npx -y eqvitta-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Eqvitta/eqvitta-mcp إلى مفتاح API؟

نعم. يتطلب EQVITTA_API_KEY، وتضبطها في إعداداته.

هل io.github.Eqvitta/eqvitta-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Eqvitta/eqvitta-mcp؟

ينشره Eqvitta. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.