FinLedger Developer Platform & Integration Guide

Expose your financial tools (`get_spending_by_category`, `get_net_worth`, `check_budget_status`, `get_rest_money`, `add_transaction`, `compare_monthly_performance`) to Claude Desktop, Cursor, or any MCP client via Server-Sent Events (SSE).

{
  "mcpServers": {
    "finledger": {
      "url": "https://api.finledger.co.in/api/v1/mcp/sse",
      "headers": {
        "Authorization": "Bearer sk_live_your_api_key_here"
      }
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_rest_money",
    "arguments": {}
  }
}

Generate versioned API keys under Settings > Developer API & Webhooks in the web dashboard. Pass your key in the `Authorization` HTTP header:

Ledger dispatches real-time webhooks for `transaction.created`, `budget.exceeded`, and `goal.completed`. Each HTTP POST contains an `X-Ledger-Signature` header signed with your webhook secret.

import hmac
import hashlib

def verify_ledger_webhook(payload_bytes: bytes, signature_header: str, secret: str) -> bool:
    expected_sig = hmac.new(
        secret.encode('utf-8'),
        payload_bytes,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected_sig}", signature_header)

Connect a user's whole application account in 1 step — no account selection. Generate a 6-character linking code via `POST /api/integrations/telegram/connect` and send `/link YOURCODE` in Telegram.

FinLedger uses the Orchestra pattern (`GuardrailNode` > `CategorizerAgent` > `QueryResolutionAgent` > `InsightAdvisorAgent`) with automatic multi-provider failover (Groq, Ollama, NVIDIA, Gemini, Rule Engine).