How to integrate Open Exchange Rates MCP with Hermes

Connect Hermes to Open Exchange Rates MCP. Get latest usd rates for eur, convert 1,000 usd to eur today, and more using natural language, with authentication handled for you.

Open Exchange Rates logoOpen Exchange Rates
Api Key

Open Exchange Rates is a foreign exchange data service for current and historical currency rates, conversions, and market data. It provides reliable currency insights through simple API access.

7 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Open Exchange Rates account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Open Exchange Rates with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Open Exchange Rates with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Open Exchange Rates

Ask your agent to connect to Open Exchange Rates, or simply request any Open Exchange Rates-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Open Exchange Rates connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Open Exchange Rates or request any Open Exchange Rates-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Open Exchange Rates MCP server, and what's possible with it?

The Open Exchange Rates MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Open Exchange Rates account. It provides structured and secure access to current and historical exchange rates, currency conversion, currency details, market data, and usage information, so your agent can convert amounts, retrieve current rates, look up historical values, analyze rate trends, and check available currencies and usage on your behalf.

  • Currency conversion: Have your agent convert a specific monetary amount between two currencies using the latest available rate.
  • Current exchange rates: Let the agent retrieve the latest rates for a chosen base currency and selected currencies.
  • Historical rate lookup: Direct your agent to find end-of-day exchange rates for a specific date, including dates going back to 1999.
  • Trend and market analysis: Instruct your agent to review daily rates across a date range or examine open, high, low, close, and average rates for an aggregation period.
  • Currency and usage information: Have your agent list available currencies, including optional alternative or inactive currencies, and check plan details, refresh frequency, and current-month request usage.

Way Forward

With Open Exchange Rates connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Open Exchange Rates action and event your agent gets out of the box.

Convert Currency

Convert a monetary amount between two currencies at the latest available rate.

Get Historical Rates

Get end-of-day midpoint exchange rates for one UTC date on or after 1999-01-01.

Get Latest Rates

Get the latest midpoint exchange rates for a base currency, optionally limited to selected currency symbols.

Get OHLC Rates

Get open, high, low, close, and average exchange rates for one aggregation period.

Get Time Series

Get daily exchange rates for an inclusive UTC date range of at most one month.

Get Usage

Get the connected App ID's plan features, exchange-rate data refresh frequency, and current-month request usage.

List Currencies

List available currency symbols and display names, optionally including alternative or inactive currencies.

FAQ

Frequently asked questions

Start with Open Exchange Rates.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Open Exchange Rates tool your agent needs.Free to start.

Start building