Overview
What is Eltoque?
An MCP (Model Context Protocol) server that fetches real-time USD and EUR exchange rates from the Cuban parallel market via eltoque.com. It provides two tools—usd-price and eur-price—for developers building financial or monitoring applications.
How to use Eltoque?
Use with Docker: build the image with npm run docker:build and run with npm run docker:run, or use docker build -t eltoque-mcp . and docker run -it --rm eltoque-mcp. Integrate with MCP clients by adding the Docker command to your mcpServers configuration. For local development, install dependencies with npm install, run in dev mode with npm run dev, build with npm run build, and start with npm start.
Key features of Eltoque
- Provides two tools:
usd-priceandeur-price - Extracts real-time prices from eltoque.com
- Robust error handling for network and HTML parsing
- Dockerized for easy deployment with Alpine-based images
- Uses Node.js 20 and TypeScript
Use cases of Eltoque
- Get the current USD to CUP exchange rate for financial dashboards
- Fetch the current EUR to CUP rate for multi-currency tracking
- Automate currency rate monitoring without manual website checks
- Integrate Cuban parallel market data into budgeting or trading bots
FAQ from Eltoque
What tools does the server provide?
It offers usd-price (returns USD in CUP) and eur-price (returns EUR in CUP), both requiring no parameters.
What are the runtime and dependencies?
The server runs on Node.js 20 Alpine and uses the @modelcontextprotocol/sdk, native fetch, and RegExp for HTML scraping. The transport is stdio.
How do I integrate this server with an MCP client?
Add the following to your MCP client configuration: a server named eltoque with command docker and args ["run", "-i", "--rm", "eltoque-mcp"].
Where does the price data come from?
All exchange rates are scraped in real time from the website eltoque.com. No local data storage is involved.
Can I run the server without Docker?
Yes. Install dependencies with npm install, then run npm start after building with npm run build.
