<div align="center">

# 📈 Finance Tracker MCP Server

**A lightweight, AI-agent compatible Model Context Protocol (MCP) server for real-time market data retrieval and financial calculations.**

![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)
![FastMCP](https://img.shields.io/badge/FastMCP-latest-green.svg)
![License](https://img.shields.io/badge/license-MIT-blue.svg)
![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)

[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [MCP Client Configuration](#-mcp-client-configuration) • [Available Tools](#-available-tools)

</div>

---

## 🌟 Overview

The **Finance Tracker MCP Server** extends LLM capabilities by enabling real-time stock price lookup and inline financial calculations via standard HTTP protocol. Built on **FastMCP** and powered by **Yahoo Finance (`yfinance`)**, it exposes micro-services that allow AI agents (such as Claude, Cursor, or custom MCP hosts) to execute live market analytics seamlessly.

---

## ✨ Features

- ⚡ **Real-Time Data**: Instant stock price retrieval using `yfinance` fast info headers.
- 🧮 **Safe Arithmetic**: Native precision math execution directly within agent execution loops.
- 🚀 **FastMCP Native**: Supercharged development cycle using standard SSE/HTTP transport protocol.
- 🌐 **Container & Host Ready**: Binds to `0.0.0.0:8000` for effortless Docker or local deployment.

---

## 🛠️ Installation

### Prerequisites

Ensure you have **Python 3.10+** and [uv](https://github.com/astral-sh/uv) (or `pip`) installed.

1. **Clone the repository:**
   ```bash
   git clone [https://github.com/your-username/finance-tracker-mcp.git](https://github.com/your-username/finance-tracker-mcp.git)
   cd finance-tracker-mcp