How to integrate Financial Datasets AI MCP with Atomic Agent

Connect Atomic Agent to Financial Datasets AI MCP. Retrieve latest sec filings for aapl, list company fundamentals for s&p500 firms, and more using natural language, with authentication handled for you.

Financial Datasets AI MCP logoFinancial Datasets AI MCP
Dcr Oauth

Financial Datasets AI MCP is a financial data platform providing company fundamentals, SEC filings, stock prices, ownership, KPIs, news, and macro data. Use it to let AI agents query, screen, and analyze market and company metrics with reliable, structured data.

28 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Financial Datasets AI.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Financial Datasets AI account. See the Atomic Agent documentation for installation instructions.

Also integrate Financial Datasets AI MCP with

How Atomic Agent connects to Financial Datasets AI

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Financial Datasets AI to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Financial Datasets AI. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Financial Datasets AI account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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

The Financial Datasets AI 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 AI account. It provides structured and secure access so your agent can perform Financial Datasets AI operations on your behalf.

Use Financial Datasets AI from Atomic Agent

With your account connected, ask Atomic Agent to work with Financial Datasets AI in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Financial Datasets AI MCP action and event your agent gets out of the box.

Get balance sheet

Retrieves a company's balance sheet, which provides a snapshot of its assets, liabilities, and shareholders' equity at a specific point in time.

Get beneficial owners

Lists beneficial owners (holders of more than 5% of a company's shares, from SEC Schedules 13D/13G) with their filer CIK and reporting-person name.

Get beneficial ownership

Retrieves beneficial-ownership stakes (holders of more than 5% of a class of shares) from SEC Schedules 13D and 13G.

Get cash flow statement

Provides a company's cash flow statement, showing how cash is generated and used across operating, investing, and financing activities.

Get company facts

Get comprehensive company facts data for a stock ticker or CIK from Financial Datasets.

Get earnings

Retrieves earnings data from SEC filings.

Get filing items

Retrieves specific sections (items) from a company's SEC filings (10-K, 10-Q, or 8-K).

Get filings

Get SEC filings data for a stock ticker or CIK.

Get financial metrics

Retrieves historical financial metrics for a company, such as P/E ratio, revenue per share, and enterprise value, over a specified period.

Get financial metrics snapshot

Fetches a snapshot of the most current financial metrics for a company, including key indicators like market capitalization, P/E ratio, and dividend yield.

Get income statement

Fetches a company's income statement, detailing its revenues, expenses, and net income over a reporting period.

Get index fund

Get an ETF or index fund's holdings and each position's weight (percent of net assets) for a fund ticker (e.

Get insider ownership

Retrieves insider ownership statements for a company: what officers, directors, and 10% owners actually HOLD (common shares, options, RSUs), sourced from SEC Form 3 (an insider's initial statement of ownership) and Form 5 (the annual statement).

Get insider trades

Retrieves insider trading transactions for a company, including purchases, sales, and other transactions by company officers, directors, and major shareholders.

Get institutional holdings

Retrieves SEC 13F institutional holdings sourced directly from EDGAR.

Get institutional investors

Lists institutional investors (SEC 13F filers) with their CIK and most recent reported name.

Get interest rates

Retrieves the latest policy interest rates from major central banks (e.

Get kpi guidance

Retrieves forward-looking KPI guidance items issued by company management in earnings releases and SEC filings.

Get kpi metrics

Retrieves historical KPI taxonomy metrics extracted from SEC filings for a company (e.

Get kpi non gaap

Retrieves non-GAAP KPIs reported by a company (e.

Get macro data

Retrieves macroeconomic datasets.

Get news

Fetches recent news articles for a specific company or the broad market.

Get segmented financials

Retrieves segment breakdowns from all three financial statement types (income statement, balance sheet, cash flow) in a single call.

Get stock price

Fetches the most recent price snapshot for a specific stock, including the latest price, trading volume, and other open, high, low, and close price data.

Get stock prices

Retrieves historical price data for a stock over a specified date range, including open, high, low, close prices, and volume.

List filing item types

Provides a list of all available item names that can be extracted from 10-K, 10-Q, and 8-K reports, grouped by filing type.

List stock screener filters

Retrieves all available filter fields and operators for the stock screener, grouped by category (income statement, balance sheet, cash flow statement, financial metrics, and company attributes like sector and industry).

Screen stocks

Screens and filters stocks by financial metrics, valuation ratios, and company attributes.

FAQ

Frequently asked questions

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

Yes, you can. Atomic Agent 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 AI tools.

Yes, absolutely. You can configure which Financial Datasets AI 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 AI data and credentials are handled as safely as possible.

Start with Financial Datasets AI MCP.It takes 30 seconds.

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

Start building