Currency Exchange

You set up this Currency Exchange MCP Server to obtain real-time fiat and cryptocurrency prices, perform conversions, and fetch historical rates without needing API keys. It supports batch conversions, multi-source failover, and smart currency resolution to simplify your financial tooling.

How to use

You interact with the MCP server through a client that can send tool requests to the MCP endpoint. Use it to convert between fiat currencies and cryptocurrencies, fetch current exchange rates for multiple targets, perform batch conversions, and look up historical rates. The system automatically handles source selection, caching, and basic validation so you can focus on building financial workflows.

How to install

Prerequisites: Ensure you have Node.js installed on your machine. You will also need an environment capable of running MCP endpoints and, for deployment, an account on Apify if you intend to publish and host the server.

Step 1: Install dependencies locally.

Step 2: Run the development server to test MCP locally.

# Install dependencies
npm install

# Start the MCP server in development mode
npm run start:dev

Additional sections

Configuration and hosting details include multiple deployment options. You can run a local development server or deploy to a cloud actor that exposes an MCP URL for client access.

Connecting a client: Use the MCP URL exposed by your deployment to connect your client configuration. For local testing, the server typically serves the MCP endpoint at the default route, and you can access it via your client with the provided endpoint.

Deployment guidance: When you are ready to publish, follow your hosting platform’s steps to publish an actor or service that exposes an MCP endpoint. After deployment, use the assigned URL as the endpoint in your MCP client configuration.

Available tools

convert_currency

Convert an amount between any supported fiat or cryptocurrency pair.

batch_convert

Convert an amount from one currency to multiple targets in a single call, up to 50 targets per request.

get_exchange_rates

Get current exchange rates for a base currency against multiple targets.

get_historical_rate

Get historical exchange rates for a single date or a date range (up to 365 days).