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.

Related MCP server: freee会計 MCP Server

Setup Instructions

1. Clone the repository and install dependencies:

   uv .venv
   uv sync
   source .venv/activate

2. Configure environment variables: Create a .env file in the root folder with:

AUTH_TOKEN=your_secure_token_here
MY_NUMBER=your_whatsapp_number_here

3. 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
  ]
}

4. Run the MCP server:

python server.py

Usage

1. 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]

2. 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!