FinFeedAPI MCP

Financial Data for AI Agents with FinFeedAPI MCP

Connect AI agents, copilots, research systems, and developer tools directly to financial data through hosted Model Context Protocol servers.

Access stocks, SEC filings, currencies, prediction markets, and historical datasets through structured, self-describing tools.

Give AI Systems Direct Access to Financial Data

FinFeedAPI supports Model Context Protocol across multiple financial data products, giving MCP-compatible applications a structured way to discover and query financial information.

Self-describing tools instead of hardcoded endpoints

Instead of teaching an agent individual REST endpoints, request formats, and parameter rules, MCP exposes available operations as self-describing tools.

Your application can inspect the available tools, understand their parameters, and call the appropriate financial data service directly.

Hosted MCP access for

  • Stock Historical API
  • SEC Filings API
  • Currencies API
  • Prediction Markets API
  • Flat Files

One MCP Layer Across Multiple Financial Datasets

FinFeedAPI MCP is not limited to one type of financial information. Each product exposes its own dedicated hosted MCP endpoint.

MCP ServiceAvailable Data
Stock HistoricalExchanges, symbols, OHLCV, IEX trades, L1, L2, L3 and market events
SEC FilingsFiling search, full-text search, extracted filing content, attachments and XBRL
Currencies RealtimeAssets and current exchange rates
Currencies HistoricalHistorical rates, supported periods and OHLC exchange-rate timeseries
Prediction MarketsExchanges, markets, activity, OHLCV, order books and historical event data
Flat FilesBucket, exchange, dataset and object discovery

From Tool Discovery to Financial Data

MCP gives AI systems a structured workflow for interacting with FinFeedAPI. This makes it possible to build agent workflows without creating a custom wrapper for every API operation.

Typical MCP workflow

  1. 1Connect an MCP-compatible client to a FinFeedAPI MCP endpoint.
  2. 2Authenticate using your existing FinFeedAPI API key.
  3. 3Let the client discover the tools exposed by that server.
  4. 4Inspect the tool schema and required parameters.
  5. 5Call the appropriate tool.
  6. 6Receive structured financial data for analysis or downstream processing.

Explore Historical Stock Data and Market Microstructure

The Stock Historical MCP server exposes tools for both market discovery and historical analysis. Agents can discover supported exchanges and symbols, inspect available OHLCV periods, and retrieve latest or historical candles.

Native IEX datasets

For IEX data, MCP also provides access to native datasets including:

  • system events
  • administrative messages
  • Level 1 quotes
  • Level 2 price levels
  • Level 3 order book events
  • trades

This makes the Stock MCP server suitable for workflows ranging from simple historical charting to detailed market microstructure research. The Stock Historical MCP server currently exposes 11 tools.

Endpoint

mcp
https://api-historical.stock.finfeedapi.com/mcp

Search, Extract, and Structure SEC Filings

FinFeedAPI SEC MCP allows AI applications to move from filing discovery to targeted document extraction. Agents can search filings by ticker, CIK, form type, filing date, report date, or document content.

Once a filing is identified

  • retrieve classified filing content
  • extract individual filing items
  • preserve content as text or HTML
  • download original EDGAR attachments
  • convert XBRL into JSON

For example, an agent can search recent 8-K filings for a specific phrase and then retrieve only Item 1.01 instead of processing the entire document. The SEC MCP server currently exposes 6 tools.

Endpoint

mcp
https://api.sec.finfeedapi.com/mcp

Query Current and Historical Exchange Rates

Currencies MCP separates current exchange-rate access from historical analysis. Historical periods currently range from 1SEC through 10DAY.

Realtime Currencies MCP

Use the realtime server to:

  • discover supported assets
  • retrieve a current exchange rate
  • price one base asset against multiple quote assets
  • retrieve asset icon URLs
mcp
https://api-realtime.fx.finfeedapi.com/mcp

Historical Currencies MCP

Use the historical server to:

  • discover supported assets
  • inspect supported candle periods
  • retrieve a point-in-time rate
  • retrieve multiple rates for a historical timestamp
  • query OHLC exchange-rate timeseries
mcp
https://api-historical.fx.finfeedapi.com/mcp

Build AI Workflows Around Prediction Markets

Prediction Markets MCP exposes both market discovery and market-state data. Agents can discover exchanges, identify active markets, retrieve richer market metadata, inspect current activity, query order books, and analyze historical market behavior. The Prediction Markets MCP server currently exposes 14 tools.

Available workflows

Market DiscoveryFind supported venues and valid market_id values before requesting market-level data.
Activity MonitoringRetrieve the latest trade and quote information or inspect a recent activity batch.
OHLCV AnalysisDiscover supported candle periods and request latest or historical OHLCV for individual markets.
Order Book AnalysisRetrieve a current order book snapshot with bids and asks or access historical order updates for downstream reconstruction.
Historical ResearchQuery historical trades, quotes, OHLCV, and raw order updates using bounded time windows.

Endpoint

mcp
https://api.prediction-markets.finfeedapi.com/mcp

Discover Flat Files Before Downloading Them

FinFeedAPI Flat Files MCP is designed primarily for dataset discovery. Agents can browse the available storage structure without manually constructing S3 paths. Once the required object is identified, file contents can be downloaded through the regular Flat Files S3 API.

Typical discovery path

A typical workflow can move through bucket, exchange, dataset, period, and file.

  1. finfeedapi
  2. E-IEXG/
  3. T-OHLCV+TP-1DAY/
  4. D-20161212.csv.gz

The MCP server exposes object information such as the file key, modification time, and size.

Endpoint

mcp
https://mcp.flatfiles.finfeedapi.com/mcp

What Can You Build with FinFeedAPI MCP?

Financial Research Agents

Let an agent discover datasets, retrieve historical market information, inspect filings, and combine different sources during a research workflow.

SEC Filing Monitors

Search newly available filings, identify relevant disclosures, extract selected sections, and pass the result into classification or summarization workflows.

Prediction Market Agents

Discover active markets, inspect prices and liquidity, retrieve order books, and analyze historical changes.

Quant Research Workflows

Retrieve historical stock candles, exchange-rate timeseries, market activity, or market microstructure datasets for analysis.

AI Financial Assistants

Give copilots access to structured financial information without hardcoding every individual REST request.

Data Discovery Agents

Allow agents to inspect supported exchanges, symbols, assets, markets, periods, buckets, and dataset paths before making larger requests.

Connect with Your Existing FinFeedAPI API Key

FinFeedAPI MCP uses the same API key authentication already used across FinFeedAPI services. Send your key with X-APIKey: YOUR_API_KEY.

The hosted MCP servers use HTTP streaming MCP and can be connected to compatible clients such as Cursor, Claude Desktop, or custom agent runtimes.

mcp.json
{
  "mcpServers": {
    "FinFeedAPI-Stock-Historical": {
      "url": "https://api-historical.stock.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    },
    "FinFeedAPI-SEC": {
      "url": "https://api.sec.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    },
    "FinFeedAPI-Prediction-Markets": {
      "url": "https://api.prediction-markets.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Why Use FinFeedAPI MCP?

Self-Describing Financial Tools

MCP-aware applications can inspect available operations and their parameters directly from the server.

Multiple Financial Data Categories

Work with market data, regulatory filings, exchange rates, prediction markets, and historical datasets through dedicated MCP services.

Built for Agent Workflows

Discovery tools help agents identify valid exchanges, symbols, markets, assets, periods, and datasets before requesting data.

Existing Authentication

Use your regular FinFeedAPI API key instead of introducing a separate MCP authentication flow.

Structured Tool Calls

Tool schemas make requests more predictable and easier for agent runtimes to validate.

Hosted Infrastructure

Connect directly to FinFeedAPI MCP endpoints without operating your own MCP adapter.

Available FinFeedAPI MCP Servers

ServerEndpoint
Stock Historical MCPapi-historical.stock.finfeedapi.com/mcp
SEC MCPapi.sec.finfeedapi.com/mcp
Currencies Realtime MCPapi-realtime.fx.finfeedapi.com/mcp
Currencies Historical MCPapi-historical.fx.finfeedapi.com/mcp
Prediction Markets MCPapi.prediction-markets.finfeedapi.com/mcp
Flat Files MCPmcp.flatfiles.finfeedapi.com/mcp

Frequently Asked Questions

What is FinFeedAPI MCP?

FinFeedAPI MCP is a collection of hosted Model Context Protocol servers that expose supported FinFeedAPI datasets through self-describing tools for AI agents and MCP-compatible applications.

Which FinFeedAPI products support MCP?

MCP is currently available for Stock Historical, SEC Filings, Currencies Realtime, Currencies Historical, Prediction Markets, and Flat Files.

Does MCP replace the FinFeedAPI REST API?

No. MCP provides another interface for working with FinFeedAPI data. REST, WebSocket, JSON-RPC, S3, and other supported interfaces remain available depending on the product.

How do I authenticate?

Use your regular FinFeedAPI API key through the X-APIKey header.

Can I access both realtime and historical data?

Yes, depending on the MCP server. Currencies provides separate realtime and historical servers, while other products expose the capabilities documented for their respective endpoints.

Can MCP access SEC filing content?

Yes. The SEC MCP server supports filing discovery, full-text search, full or item-level extraction, attachment retrieval, and XBRL-to-JSON conversion.

Can MCP retrieve prediction market order books?

Yes. Prediction Markets MCP can return the current order book snapshot. Historical order book tools return raw order updates rather than reconstructed snapshots.

Can MCP download Flat Files directly?

The current Flat Files MCP server is focused on discovery and listing. It can identify buckets, prefixes, object keys, modification times, and file sizes. File contents are then retrieved through the standard Flat Files S3 API.

Which MCP clients can connect to FinFeedAPI?

FinFeedAPI MCP servers can be used with MCP-compatible clients such as Cursor, Claude Desktop, or custom agent runtimes.

FinFeedAPI MCP

Connect AI Applications to Financial Data

Give your agents structured access to stocks, SEC filings, currencies, prediction markets, and historical datasets through FinFeedAPI MCP.