auxilab-mcp-finance-recon

# auxilab-mcp-finance-recon **MCP Server for Month-End Close Reconciliation** Finance Shared Services · GBS/SSC · Auxiliobits > Automate the most manual, error-prone activities in a shared services team: > bank reconciliation, GL close, intercompany matching, and month-end close tracking. --- ## What it does | MCP Tool | Description | |---|---| | `match_bank_statement` | Match bank CSV vs GL cash ledger — ±3 day date proximity, exact amount | | `reconcile_gl_accounts` | Compare prior vs current GL extract — new entries, reversals, variances | | `check_intercompany_balances` | Entity A vs Entity B — gross mismatch, FX component, risk flag | | `classify_reconciliation_breaks` | Rules-based break classification with recommended next actions | | `track_month_end_close` | 12-task close tracker with overdue detection and risk rating | --- ## Quick Start ### 1. Install ```bash git clone https://github.com/auxiliobits/auxilab-mcp-finance-recon cd auxilab-mcp-finance-recon pip install -e ".[dev]" ``` ### 2. Generate test data ```bash python data/generate_test_data.py ``` This creates `data/sample_data/` with 7 synthetic CSV files — no real data required. ### 3. Run the standalone demo ```bash python demo.py ``` Expected output: full 5-step reconciliation flow ending with a Month-End Readiness Report. ### 4. Start the MCP server (for Claude Desktop / agent use) ```bash python src/server.py ``` --- ## MCP Server Config (claude_desktop_config.json) ```json { "mcpServers": { "finance-recon": { "command": "python", "args": ["/path/to/auxilab-mcp-finance-recon/src/server.py"] } } } ``` --- ## Tool Reference ### `match_bank_statement` ```json { "bank_csv": "<CSV string>", "gl_csv": "<CSV string>", "opening_balance": 500000.00 } ``` **Returns:** `reconciliation_summary`, `matched_pairs`, `unmatched_bank_items`, `unmatched_gl_items` **Matching logic:** - Amount match: exact within ±$0.01 - Date proximity: ±3 calendar days -…