Uses Pydantic-AI framework to build the math agent with structured data validation and AI model integration
Implements mathematical computation tools including basic arithmetic operations (add, subtract, multiply, divide), power, and logarithm functions through MCP protocol
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Math MCP Server calculate 15% of 250"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Agent: built with pydantic-ai, connected via MCP stdio
MCP Server: powered by fastmcp, exposing math tools
add
subtract
multiply
divide
power
log
Coming soon:
modulus
Related MCP server: Calculator MCP Server
Python 3.13+
uv (Python package/dependency manager)
A Groq API key (for the LLM model)
A Logfire token (for instrumentation)
Clone the repository
Create your environment file
Set these keys:
groq_key — your Groq API key
logfire_key — your Logfire token
Run with uv so dependencies are resolved and the MCP server is launched as a toolset:
uv run agent.pyNotes:
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.
Contributions are welcome—feel free to open issues or submit pull requests.
Adds two integer numbers together.
Inputs: a (required), b (required). Returns: result
Divide two numbers. Raises an error if dividing by zero.
Inputs: a (required), b (required). Returns: result
Calculate the logarithm of a number with the specified base (default base 10).
Args: a: The number to calculate logarithm for (must be positive) base: The base of the logarithm (must be positive and not equal to 1, default is 10)
Inputs: a (required), base. Returns: result
Multiply two numbers together.
Inputs: a (required), b (required). Returns: result
Raise a number to the power of another number (a^b).
Inputs: a (required), b (required). Returns: result
subtract two integer numbers together.
Inputs: a (required), b (required). Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool has a clearly distinct mathematical operation: addition, division, logarithm, multiplication, exponentiation, and subtraction. There is no overlap in purpose, making it easy for an agent to select the correct tool based on the desired calculation.
All tool names follow a consistent verb-only pattern (e.g., add, divide, log, multiply, power, subtract) without mixing conventions. This simplicity and uniformity make the naming highly predictable and readable.
With 6 tools, this server is well-scoped for a math utility, covering core arithmetic and basic mathematical functions. Each tool earns its place without feeling excessive or insufficient for the domain.
The tool set covers essential operations like addition, subtraction, multiplication, division, exponentiation, and logarithms, providing a solid foundation. However, minor gaps exist, such as missing trigonometric functions (e.g., sine, cosine) or advanced operations like square roots, which agents might need to work around for broader mathematical tasks.
Loan & mortgage calculator, compound interest, ROI, crypto prices, FX conversion for AI agents.
500+ deterministic tools for AI agents: math, conversion, validation, hashing, encoding, date/time.
AI-callable calculators and engineering models with real formulas. No hallucinated math.
High-precision finance & business calculations for AI agents — exact decimals, never floats.
