How to integrate Financial Datasets MCP with Hermes

Connect Hermes to Financial Datasets MCP. Summarize apple q2 earnings highlights, get historical price series for tsla, and more using natural language, with authentication handled for you.

Financial Datasets logoFinancial Datasets
Api Key

Financial Datasets is a service providing company fundamentals, financial statements, SEC filings, ownership, macro series, and analytics. Use it to access normalized financial and market data for research, reporting, and automation.

30 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 Financial Datasets 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.

Also integrate Financial Datasets with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ 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 Financial Datasets 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 Financial Datasets

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

4. Done. You're all set with a new Financial Datasets 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 Financial Datasets or request any Financial Datasets-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Financial Datasets MCP server, and what's possible with it?

The Financial Datasets MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Financial Datasets account. It provides structured and secure access so your agent can perform Financial Datasets operations on your behalf.

Way Forward

With Financial Datasets 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 Financial Datasets action and event your agent gets out of the box.

Get As-Reported Financials

Return one page of issuer-reported financial statement fields without normalization for one statement family or all statements.

Get Beneficial Ownership

Return one page of current or historical SEC Schedule 13D and 13G stakes by subject ticker or beneficial-owner CIK.

Get Company Facts

Return a company's identity, classification, exchange, and active-status facts by ticker or SEC CIK.

Get Company KPIs

Return one page of reported operating KPIs, forward guidance, or non-GAAP metrics for a company, including source provenance.

Get Earnings

Return one page of recent company earnings filings with quarterly and annual financial metrics, detected signals, and a continuation cursor.

Get Financial Metrics

Return a company's current metrics snapshot or one historical page of valuation, profitability, efficiency, liquidity, leverage, growth, and per-share metrics by ticker or SEC CIK.

Get Financial Statements

Return one provider page of normalized income statements, balance sheets, cash-flow statements, or all three for a company.

Get GPU Prices

Return today's GPU rental price index or one page of historical daily prices for a GPU model, including provider spread, changes, and source attribution.

Get Index Fund Holdings

Return one page of a fund's constituents by fund ticker, or one page of funds containing a security by holding ticker.

Get Inflation

Return the latest CPI values for all or one inflation series, or monthly history for one series.

Get Insider Ownership

Return one page of company insider holdings reported on SEC Forms 3 and 5, including common and derivative positions.

Get Institutional Holdings

Return one page of SEC 13F holdings by institution CIK or held-company ticker.

Get Interest Rates

Return a central bank's current policy rate or one newest-first page of historical daily rates for a date range.

Get Labor Market

Return the latest print for all or one US labor series, or one page of historical monthly or weekly observations for one series.

Get Price History

Return one page of historical OHLCV stock prices for an inclusive date range at a daily, weekly, monthly, or yearly interval.

Get Price Snapshot

Return a real-time price snapshot for one ticker or snapshots for the broad market.

Get SEC Filing Items

Extract selected sections from a 10-K, 10-Q, or 8-K, optionally including 8-K exhibits, and wait for asynchronous preparation when needed.

Get Segmented Financials

Return one page of company-reported business or product segments for one statement family or all statements.

Get Treasury Yield Curve

Return the latest US Treasury par yield curve or historical daily curves for a date range.

List Dataset Identifiers

List every ticker, CIK, or sector returned by one selected Financial Datasets data-family catalog.

List Filing Options

List supported SEC filing types or the documented section-selector catalog for filing extraction.

List Insider Trades

Return one page of reported insider purchases, sales, gifts, awards, and other transactions for a company.

List IPO Filings

Return one page of IPO, SPAC, shell-company, resale, or other SEC offering filings with optional company and filing-date filters.

List Macro Options

List valid central-bank codes or inflation, GPU price, and labor series IDs and metadata for macroeconomic queries.

List News

Return one page of recent company-specific or broad-market news articles.

List Screener Filters

List all financial fields, company classifications, and comparison operators currently accepted by the company screener.

List SEC Filings

Return one page of SEC filing metadata and source URLs with optional company and form filters.

Screen Companies

Find companies whose financial fields, ticker, CIK, sector, or industry satisfy structured comparison filters.

Search Financial Line Items

Return selected financial line items for one or more company tickers and a reporting period type.

Search Institutional Investors

Find institutional investor names and SEC CIKs by a case-insensitive name prefix, or omit name to return the provider's discovery list.

FAQ

Frequently asked questions

With a standalone Financial Datasets MCP server, the agents and LLMs can only access a fixed set of Financial Datasets tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Financial Datasets and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Financial Datasets tools.

Yes, absolutely. You can configure which Financial Datasets scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Financial Datasets data and credentials are handled as safely as possible.

Start with Financial Datasets.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Financial Datasets tool your agent needs.Free to start.

Start building