다양한 Tiingo API 엔드포인트를 도구로 노출하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 MCP 프로토콜을 통해 주가, 뉴스, 외환, 펀더멘털, 기업 행동 등 금융 데이터에 프로그래밍적으로 접근할 수 있게 합니다.

선수 조건

• Node.js (v18 또는 그 이후 권장)
• NPM (Node.js 포함)
• Tiingo API 키
• MCP 호환 클라이언트 또는 러너(예: VSCode 확장, CLI)

준비

1. 저장소를 복제하거나 프로젝트 디렉터리에 있는지 확인하세요.

2. 의존성 설치 하세요:

3. Tiingo API 키를 받으세요: 이 서버를 사용하려면 Tiingo API 토큰이 필요합니다.

4. Tiingo 계정이 없다면 등록하세요.

5. Tiingo 계정 페이지로 가서 API 토큰 섹션으로 이동하거나 직접 방문하세요: https://www.tiingo.com/account/api/token).

6. API 토큰을 복사합니다. Tiingo API로 인증하려면 이 토큰을 MCP 클라이언트에 제공해야 합니다. 참고: Tiingo는 프로그래밍 등록이나 로그인을 지원하지 않습니다; API 토큰만이 유일한 인증 방법입니다.

7. Set Tiingo API Key: 이 서버는 Tiingo API 키가 필요합니다.

Stock Trade MCP Server

A Model Context Protocol (MCP) server that exposes various Tiingo API endpoints as tools. This server allows programmatic access to financial data including stock prices, news, forex, fundamentals, and corporate actions via the MCP protocol.

Prerequisites

• Node.js (v18 or later recommended)
• npm (comes with Node.js)
• A Tiingo API Key
• MCP-compatible client or runner (e.g., VSCode extension, CLI)

Setup

1. Clone the repository or ensure you are in the project directory.

2. Install dependencies:

   npm install
   

3. Obtain Your Tiingo API Key: To use this server, you need a Tiingo API token.

   1. Register for a Tiingo account if you don’t have one.
   2. Go to your Tiingo Account page and navigate to the API Token section (or directly visit: https://www.tiingo.com/account/api/token).
   3. Copy your API Token. You will need to provide this token to your MCP client to authenticate with the Tiingo API. Note: Programmatic registration or logins are not supported by Tiingo; the API token is the sole method for authentication.

4. Set Tiingo API Key: This server requires your Tiingo API key. You can typically provide the API key in your MCP client’s configuration (see “Running the Server” below for an example).

5. Build the server:

   npm run build
   

   This will create a build directory with the compiled JavaScript code.

Running the Server

• Via MCP runner: Configure your MCP client to run the server using stdio transport. You can provide the TIINGO_API_TOKEN in the env block of the configuration. Example MCP settings entry:

  "mcp-tiingo": {
    "transportType": "stdio",
    "command": "node",
    "args": [
      "/path/to/mcp-tiingo/build/index.js"
    ],
    "env": {
      "TIINGO_API_TOKEN": "YOUR_API_KEY_HERE"
    }
    // ... other optional settings ...
  }
  

  (Replace /path/to/mcp-tiingo and YOUR_API_KEY_HERE accordingly)

Available Tools

The server exposes the following Tiingo API endpoints as tools via MCP:

get_end_of_day_prices

• Description: Fetches End-of-Day prices for a given ticker symbol with optional date range and format.
• Key Inputs: ticker, startDate, endDate, resampleFreq

get_news

• Description: Fetches news articles from Tiingo with various filtering options.
• Key Inputs: tickers, tags, sources, startDate, endDate, limit

get_forex_prices

• Description: Fetches historical intraday Forex prices for a given ticker symbol with optional date range and frequency.
• Key Inputs: ticker, startDate, endDate, resampleFreq

get_forex_top_of_book

• Description: Fetches real-time Forex Top-of-Book/Last data for one or more ticker symbols.
• Key Inputs: ticker or tickers

get_fundamentals_definitions