GullakAI MCP Server

A lightweight MCP server for personal finance assistance, expense tracking, financial news simplification, and local purchasing power comparisons across South Asian 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!

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables personal finance management through conversational AI, including expense tracking, budget monitoring, financial news simplification, and purchasing power comparisons across South Asian cities. Designed for WhatsApp integration with natural language commands for financial assistance.

Related MCP Servers

MCP Calc Tools
nbiish
A
security
F
license
A
quality
A server that provides advanced mathematical and financial calculation capabilities for AI code assistants, enabling them to perform complex calculations like symbolic calculus, numerical methods, and financial analysis without implementing algorithms directly.
Last updated -
18
3
JavaScript
You Need A Budget (YNAB) MCP
Jtewen
A
security
A
license
A
quality
An MCP to give AI agents extensive knowledge of your personal finances and control of your budgeting.
Last updated -
14
3
Python
MIT License
freee会計 MCP Server
tsurutan
-
security
A
license
-
quality
Enables AI assistants to access and manage accounting data through the freee accounting API, supporting operations like transaction management, financial analysis, and account item management.
Last updated -
701
1
TypeScript
MIT License
Lunch Money MCP Server
MatiasL13
-
security
A
license
-
quality
A Model Context Protocol server that allows AI assistants to interact with Lunch Money accounts, enabling management of transactions, categories, budgets, and other financial data through natural language commands.
Last updated -
Python
MIT License

View all related MCP servers

GullakAI MCP Server