GullakAI MCP Server

A lightweight MCP server for personal finance assistance, expense tracking, financial news simplification, and local purchasing power comparisons across Indian cities.

Features

Core Finance Q&A
Conversational AI that answers personal finance questions clearly and simply in multiple languages.
Financial News Simplifier
Summarizes and explains complex financial news and jargon in easy-to-understand language.
Expense & Budget Monitor
Manage budgets, record expenses, track debts and bills using simple chat commands.
Purchasing Power Checker
Compare salary affordability and cost of living across cities using local purchasing power parity data.

Setup Instructions

Clone the repository and install dependencies:
```
uv .venv
uv sync
source .venv/activate
```
Configure environment variables: Create a .env file in the root folder with:

AUTH_TOKEN=your_secure_token_here
MY_NUMBER=your_whatsapp_number_here

Add purchasing power data: Ensure the file purchasingpower.json is present with the structure:

{
  "cities": [
    {"city": "Hyderabad, India", "local_purchasing_power_index": 154.1},
    {"city": "Bangalore, India", "local_purchasing_power_index": 149.7}
    // ... more cities
  ]
}

Run the MCP server:

python server.py

Usage

Interact with the MCP tools through your WhatsApp bot or other MCP-compatible clients.

Expense commands supported:

set budget ...

spent on

owe <person/description>

bill due YYYY-MM-DD

summary [month]

Ask natural language finance questions or purchasing power comparisons.

Notes

Expense and budget data is cached in memory with a 7-day expiration.

Designed for asynchronous operation suitable for WhatsApp and browser-based chatbot integration.

License

This project is licensed under the MIT License.

Let me know if you want it expanded or more examples included!