# MathAgent

A minimal math agent that delegates all calculations to an MCP (Model Context Protocol) server. The agent uses MCP tools for every operation—no mental math—so you get consistent, inspectable results.

## What’s inside
- Agent: built with pydantic-ai, connected via MCP stdio
- MCP Server: powered by fastmcp, exposing math tools

### Available MCP tools
- add
- subtract
- multiply
- divide
- power
- log

Coming soon:
- modulus

## Requirements
- Python 3.13+
- uv (Python package/dependency manager)
- A Groq API key (for the LLM model)
- A Logfire token (for instrumentation)

## Setup
1) Clone the repository
2) Create your environment file
	 - Set these keys:
		 - `groq_key` — your Groq API key
		 - `logfire_key` — your Logfire token

## Run the agent
Run with uv so dependencies are resolved and the MCP server is launched as a toolset:

```bash
uv run agent.py
```

Notes:
- The agent is configured to use the Groq model `qwen/qwen3-32b` (see `agent.py`). You can swap models as needed.
- The agent will reject non-math questions by design.
- All calculations route through the MCP tools defined in `mcp-server.py`.

## Contributing
Contributions are welcome—feel free to open issues or submit pull requests.