KoltonG/Lunch-Money-MCP

---

🎯 Repository Goal

This repository builds a Model Context Protocol (MCP) server that provides seamless access to Lunch Money financial data via standard IO (stdio) transport.

Goal 1: Enable AI assistants to interact directly with Lunch Money's API through standardized MCP tools using stdio (not remote), allowing users to:

• Query transaction data with flexible filtering
• Access spending categories and budget information
• Retrieve transaction tags and organizational data
• Perform financial analysis through natural language

🚧 Work in Progress

This project is actively under development using a systematic agent execution approach. Every line of code, configuration, and documentation is implemented through LLM agents following structured workflows.

🤖 LLM Agent-Driven Development

This repository showcases a novel development methodology where:

• LLM agents execute all coding tasks following predefined rules and validation checkpoints
• No manual coding - agents handle implementation, testing, and documentation
• Systematic validation ensures quality through mandatory human approval at each step
• Structured task management breaks complex features into validated sub-tasks

Agent Execution Framework

Significant engineering effort has been invested in creating comprehensive rules and processes that enable:

• Self-executing agents that can autonomously implement features
• Clear validation marks with mandatory human approval between sub-tasks
• Quality assurance through structured TDD and testing requirements
• Systematic progression from PRD → TDD → Tasks → Implementation

The agent execution rules in /rules/ define:

• Task breakdown and dependency management
• Validation checkpoints and quality gates
• Branch management and PR generation
• Error handling and feedback loops

📁 Project Structure

├── docs/                    # Project documentation and planning
├── rules/                   # Agent execution rules and specifications
├── src/                     # MCP server implementation
└── README.md               # This file

🔧 Technology Stack

• Runtime: Bun (fast TypeScript execution)
• Framework: Model Context Protocol SDK
• Validation: Zod schemas
• HTTP Client: Axios
• Testing: Built-in bun test runner

---

This README will be updated as the project progresses through agent-driven development milestones.