Powered by LangGraph Multi-Agent Orchestration & Model Context Protocol

Autonomous Personal Finance OS Built for Humans & AI Agents

Track aggregate Net Worth, spendable Rest Money post SIPs & Rent, category budget capacity, and automated Telegram audit reports. Connect Claude Desktop, Cursor, or your custom workflows via hosted Model Context Protocol (MCP).

Developer API & MCP Docs
ledger-mcp-server :: agent_orchestrator.py
LIVE MCP SERVER ON PORT 8000
> Claude Desktop invoking MCP Tool:get_rest_money()
{
"formatted": "₹42,500.00",
"monthly_income": "₹1,20,000.00",
"committed_expenses": "₹77,500.00",
"status": "Safe cash after SIPs, rent, & EMIs are funded"
}
> Telegram Assistant Intent Classified:"I spent ₹450 on Swiggy dinner"
⚡ Logged expense ₹450.00 under Food & Dining (HDFC Bank). Capacity remaining: 82%.

How FinLedger Works

A unified intelligence layer over your personal finances — accessible at finledger.co.in, Telegram, mobile app, Claude Desktop, or your own API clients.

01

Connect via Telegram or Web

Register your account, link Telegram, or use the web dashboard. All data syncs in real time.

02

AI Agents Parse & Categorize

LangGraph pipeline classifies expenses, budgets, currencies, and financial queries with multi-LLM fallback.

03

Insights & Reports Generated

Monthly comparisons, net worth snapshots, category budgets, and PDF statements generated on demand.

04

AI Agents Access via MCP

Claude Desktop or Cursor query your finances directly via hosted SSE/JSON-RPC Model Context Protocol.

AI-Powered Telegram Chatbot Assistant

Your Finance Assistant Lives in Telegram

No app to install. No dashboard to open. Just message @ledger_copilot_bot in Telegram and your AI finance agent handles the rest.

All 13 Native Bot Commands

/startInitialize account & get welcome guide
/registerLink your FinLedger web account via unique code
/expenseLog expenses in any language or currency
/incomeRecord salary, freelance, or passive income
/reportGet full monthly HTML financial audit report
/compareMonth-over-month spending & savings comparison
/networthReal-time net worth across all accounts
/restmoneySpendable cash after SIPs, rent & EMIs
/budgetsCheck category budget utilization & warnings
/billsView upcoming recurring bills & due dates
/profileManage currency preference, timezone & limits
/currencySet default currency (INR, USD, EUR, GBP, AED)
/helpFull command guide with examples & tips

AI Natural Language Examples

"spent 2000 on groceries"

✅ Logged ₹2,000 under Groceries.

"paid $120 for Adobe CC"

💱 Converted $120 → ₹10,020. Logged under Subscriptions.

"how much can I spend this week?"

🤖 Rest Money: ₹42,500 (after SIPs, rent, EMIs).

Ledger AI Telegram BotLive Demo

Natural language AI expense & inquiry logging

⚡ Try: /expense 450 Swiggy in Telegram100% Instant Sync

Enterprise-Grade Financial Features

Designed for effortless tracking, deep analytical security, and AI agent integration.

Spendable Rest Money Engine

Calculates true spendable cash remaining after fixed rent, SIP mutual funds, and recurring bill commitments are funded.

Hosted MCP Server Protocol

Exposes 6 financial tools to Claude Desktop & Cursor via hosted SSE (/api/v1/mcp/sse) and JSON-RPC with zero DB credential exposure.

Telegram AI Assistant Bot

Multi-user Telegram assistant with 13 native commands, natural language parsing, budget alerts, and multi-currency support.

API Keys & Signed Webhooks

Issue scoped developer keys (sk_live_...) and receive HMAC SHA-256 signed webhooks for real-time transaction and budget alerts.

Financial Statement PDF Generator

Generate official HTML & PDF financial statements for bank loans, CA audits, and wealth advisors with 1-click tokenized sharing.

Multi-Agent LangGraph Evals

Tested against 100% prompt injection safety benchmarks with multi-provider failover (Groq, Ollama, NVIDIA, Gemini, Rule Engine).

Month-over-Month Comparisons

Track spending trends, savings rate improvements, and category breakdowns with intelligent AI-generated insights.

Multi-Currency Support

Set base currency and auto-convert INR, USD, EUR, GBP, AED transactions using live exchange rates on every log.

Budget Capacity Warnings

Receive instant Telegram alerts when category spending hits 90% of budget. Configure thresholds per category.

Recurring Bills & SIP Tracker

Track all fixed monthly commitments — rent, SIPs, EMIs, subscriptions — automatically deducted from Rest Money calculation.

Scoped Advisor Share Links

Generate time-limited, read-only /share/[token] links for your CA or financial advisor. Auto-expire and fully revocable.

AI Insight Advisor

Ask natural language questions — 'should I invest more this month?' — powered by multi-agent RAG over your actual financial data.

Multi-Agent AI Architecture

Powered by LangGraph Multi-Agent Orchestration

Every request — Telegram message, web query, or MCP tool call — passes through a deterministic safety pipeline before any LLM is invoked.

GuardrailNode

Filters prompt injection, PII exposure, and off-topic queries

CategorizerAgent

Classifies intent: expense log, income, report, query, AI question

QueryResolutionAgent

Fetches relevant financial data, runs calculations, formats response

InsightAdvisorAgent

Generates AI-powered financial insights with RAG over user data

# LLM Provider Fallback Chain
1. Groq (llama-3.3-70b-versatile) — Primary
2. Ollama (local llama3.2) — Local fallback
3. NVIDIA NIM (meta/llama-3.1-70b) — Cloud fallback
4. Gemini (gemini-1.5-flash) — Extended fallback
5. Intelligent Rule Engine — Always-available fallback

MCP Server Tool Inventory

6 financial tools exposed via JSON-RPC & Server-Sent Events at /api/v1/mcp/sse

get_rest_money()

Returns spendable cash after all commitments are funded

get_net_worth()

Aggregate net worth across all linked accounts

check_budget_status()

Category budget utilization and remaining capacity

get_spending_by_category()

Breakdown of expenses by category for a given period

add_transaction()

Log income or expense with auto-categorization

compare_monthly_performance()

Month-over-month spending, savings, and net difference

Frequently Asked Questions

Want to Connect Your App or AI Client?

Read our complete interactive developer documentation. Learn how to configure Claude Desktop, Cursor, Webhooks, API keys, and Telegram integration in minutes.

Explore Developer Docs