Tiingo MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Tiingo MCP or direct API to fetch market prices, track crypto and forex rates, read financial news, and review fundamentals through natural language.

Tiingo logoTiingo
Api Key

Tiingo is a financial data platform for equities, crypto, forex, news, and fundamentals. It provides clean, reliable market data through simple APIs.

35 Tools

Try Tiingo now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Tiingo
Try asking
TOOLS

Supported Tools

Every Tiingo action and event your agent gets out of the box.

Get BOATS Prices

Get historical BOATS overnight intraday JSON price bars for one equity ticker; requires the BOATS add-on.

Get BOATS Top Of Book

Get BOATS overnight top-of-book and last-sale snapshots for selected or all available equities; requires the BOATS add-on.

Get Bulk Distributions

Get dividend and other distribution events across all covered tickers for an optional ex-date.

Get Bulk Splits

Get stock split events across all covered tickers for an optional ex-date.

Get Crypto Prices

Get latest or historical JSON price bars for selected crypto pairs, or omit tickers to return the entire current market, with optional exchange and currency controls.

Get Crypto Yield Metrics

Get historical yield-rate, balance, and liquidity metric bars for one crypto-yield pool.

Get Crypto Yield Ticks

Get the latest crypto-yield rates, balances, and liquidity metrics, optionally filtered by pools or platforms.

Get Distribution Yield

Get the complete historical trailing one-year distribution-yield series for one ticker.

Get Equity EOD Metadata

Get end-of-day coverage metadata and company description for one equity ticker.

Get Equity EOD Prices

Get JSON end-of-day price and adjustment history for one equity ticker, optionally bounded and resampled.

Get Equity Realtime Prices

Get historical intraday bars for one equity ticker from Tiingo's 24x5 consolidated realtime feed, the current recommended feed for new integrations.

Get Equity Realtime Top Of Book

Get 24x5 consolidated realtime equity top-of-book, reference-price, and liquidity snapshots from Tiingo's current recommended feed for new integrations.

Get Forex Prices

Get latest or historical beta JSON rate bars for one forex pair.

Get Forex Top Of Book

Get beta top-of-book quotes for selected or all available forex pairs.

Get Fundamentals Daily

Get JSON daily valuation and fundamental metrics for one ticker or PermaTicker; full universe coverage requires the fundamentals add-on.

Get Fundamentals Statements

Get JSON financial statement history for one ticker or PermaTicker, optionally in as-reported form.

Get Fund Fee Metrics

Get historical JSON mutual-fund or ETF fee and expense metrics.

Get Fund Fees

Get a mutual fund or ETF description, share class, net expense ratio, and related share classes.

Get IEX Prices

Get historical IEX intraday JSON price bars for one equity ticker.

Get IEX Top Of Book

Get IEX top-of-book, last-sale, reference-price, and daily market fields for selected or all available equities.

Get News Bulk File

Get metadata and the token-bearing download URL for one institutional bulk-news batch; handle the URL as a secret.

Get Small Exchange EOD Prices

Get official end-of-day JSON price bars for one Small Exchange contract.

Get Small Exchange Intraday Prices

Get historical intraday JSON price bars for one Small Exchange contract.

Get Small Exchange Top Of Book

Get Small Exchange top-of-book and last-sale snapshots, optionally filtered by ticker.

Get Ticker Distributions

Get dividend and other distribution events for one ticker, optionally bounded by ex-date.

Get Ticker Splits

Get stock split events for one ticker, optionally bounded by ex-date.

List Crypto Metadata

Return JSON metadata for all or selected Tiingo crypto pairs.

List Crypto Yield Platforms

List crypto-yield platforms, optionally restricted to platform codes.

List Crypto Yield Pools

List crypto-yield pools, optionally filtered by pool or platform codes.

List Fundamentals Definitions

List JSON definitions, units, and statement categories for Tiingo fundamentals data codes.

List Fundamentals Metadata

List company, security, industry, reporting, and stable identifier metadata for fundamentals tickers.

List News

Return one page of curated financial news filtered by assets, tags, sources, or dates, plus a continuation cursor for the next offset page.

List News Bulk Files

List institutional bulk-news batch files and their metadata.

List Small Exchange Metadata

List Small Exchange contract metadata, optionally filtered by ticker.

Search Assets

Search Tiingo assets by ticker or name and return identifiers and listing status.

SETUP GUIDE

Connect Tiingo MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["tiingo"],
  mcp: true,
});
Create a session scoped to Tiingo and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Get the latest daily price and trading volume for AAPL from Tiingo.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Tiingo request
SETUP GUIDE

Connect Tiingo API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["tiingo"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Tiingo
3

Run Tiingo tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Get the latest daily price and trading volume for AAPL from Tiingo." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Tiingo tool calls through the session, and print the final answer

Why Use Composio?

AI Native Tiingo Integration

  • Supports both Tiingo MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable market data queries
  • Rich coverage for equities, news, crypto, forex, fundamentals, and corporate actions

Managed Auth

  • Securely stores and manages your Tiingo API key
  • Central place to manage, scope, and revoke Tiingo access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Tiingo
  • Scoped, least privilege access to Tiingo resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Tiingo.It takes 30 seconds.

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

Start building