Metadata-Version: 2.4
Name: currency-mcp
Version: 0.2.0
Summary: A Model Context Protocol (MCP) server for currency conversion using the Frankfurter API
Project-URL: Homepage, https://github.com/yourusername/currency-mcp
Project-URL: Repository, https://github.com/yourusername/currency-mcp
Project-URL: Issues, https://github.com/yourusername/currency-mcp/issues
Project-URL: Documentation, https://github.com/yourusername/currency-mcp#readme
Author-email: Van-Loc Nguyen <vanloc1808@gmail.com>
License: MIT
License-File: LICENSE
Keywords: ai-tools,currency,exchange-rate,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: fastmcp
Requires-Dist: httpx
Requires-Dist: mcp[cli]
Requires-Dist: pydantic
Description-Content-Type: text/markdown

# Currency MCP Server

A Model Context Protocol (MCP) server for currency conversion using the reliable [Frankfurter API](https://api.frankfurter.app/).

## Features

- **Real-time Exchange Rates**: Get current exchange rates for 31+ currencies
- **Historical Data**: Convert currencies using historical rates
- **MCP Integration**: Seamlessly integrates with MCP-compatible AI tools
- **No API Keys Required**: Free and reliable service
- **Async Support**: Built with modern async Python

## Installation

```bash
pip install currency-mcp
```

## Quick Start

```python
from currency_mcp_server import mcp

# The server is now ready to handle MCP requests
# Use with any MCP-compatible client
```

## Available Tools

### `list_currencies`
Lists all supported currencies with descriptions.

### `convert_currency`
Converts amounts between currencies with support for:
- Current exchange rates
- Historical rates (with date parameter)
- Input validation
- Error handling

## Development

```bash
# Clone the repository
git clone https://github.com/yourusername/currency-mcp.git
cd currency-mcp

# Install dependencies
uv sync

# Run tests
python tests/client.py
```

## License

MIT License - see LICENSE file for details.