Koskamo

FinLab MCP

A hosted read-only MCP server for the FinLab Quant Research Platform, enabling AI agents to access quantitative trading tools, backtesting engines, and market data for U.S. and Taiwan stock research.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

FinLab MCP logo, by FinLabCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by FinLab
MCP endpoint (Streamable HTTP)
https://mcp.finlab.finance/mcp
Vendor documentation

What its tools do

6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Not annotated (6)

6 of 6 have a description · 0 of 6 declare behavior hints · 3 of 3 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Backtest Taiwan or U.S. stock strategies using AI agents
  • Access quantitative trading data and Python SDK tools
  • Generate strategy reports and performance metrics

Source and maintenance

Community listingRegistry 1.1.0
mcp-registry: io.github.koreal6803/finlab-ai@1.1.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
FinLab 1.0.0
MCP protocol negotiated in check
2025-06-18
Tools
6 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

FinLab（finlab.finance）是台股量化投資平台：提供台股量化數據、每日更新的個股實證訊號、以及以 finlab Python 套件實跑的真實回測策略庫。本 MCP server 只讀公開數據。可查詢：策略庫清單與完整策略（含 Python 程式碼）、個股體質與訊號實證（如 2330 台積電）、資料庫目錄摘要、FinLab Skill 開發文件（get_finlab_docs，撰寫 finlab 程式前先查）、以及 FinLab 快速上手方式。所有數據僅供研究參考，不構成投資建議。

Tools

6 advertised

list_strategies — 列出 FinLab 策略庫
Advertised by the server during the last successful anonymous check.

列出 FinLab 公開策略庫中的台股量化策略，含每一檔策略的真實回測績效摘要（CAGR、Sharpe、最大回撤）與基準比較。想看完整策略內容與 Python 程式碼時，請接著呼叫 get_strategy。

list_strategies input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_strategy — 取得單一策略完整內容
Advertised by the server during the last successful anonymous check.

取得 FinLab 策略庫中單一策略的完整快照：策略說明、真實回測績效與基準比較、以及可直接執行的 finlab Python 程式碼。slug 可先用 list_strategies 查詢。

get_strategy input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "策略代號（slug），例如由 list_strategies 取得"
    }
  },
  "additionalProperties": false
}
get_stock_evidence — 查個股數據實證
Advertised by the server during the last successful anonymous check.

查詢台股個股的每日更新數據實證：基本面體質定位（獲利、估值、籌碼因子百分位）、目前正在觸發的量化訊號與其歷史前瞻報酬統計、估值位階等。例如 symbol="2330" 查台積電。資料來自 FinLab 每日以 finlab 套件計算的真實數據。

get_stock_evidence input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "symbol"
  ],
  "properties": {
    "market": {
      "enum": [
        "tw",
        "us"
      ],
      "type": "string",
      "description": "市場，預設 \"tw\" 台股；\"us\" 為美股（覆蓋率較低）。"
    },
    "symbol": {
      "type": "string",
      "description": "台股股票代號字串，例如 \"2330\"（台積電）、\"0050\"、\"00631L\"。保留前導零，不要轉成數字。"
    }
  },
  "additionalProperties": false
}
get_data_catalog — FinLab 資料庫目錄摘要
Advertised by the server during the last successful anonymous check.

取得 FinLab 量化資料庫的目錄摘要：涵蓋台股與美股的分類數、欄位數、資料列數、年份範圍，以及代表性資料集（股價、月營收、財務指標等）。適合回答「FinLab 有哪些資料」。

get_data_catalog input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
get_finlab_docs — FinLab Skill 開發文件
Advertised by the server during the last successful anonymous check.

取得 FinLab Skill 的開發文件（與 GitHub koreal6803/finlab-ai main 分支同步，skill 更新後自動生效）：不帶參數回傳 SKILL.md 主文件與參考文件清單；帶 doc 參數回傳指定參考文件全文。涵蓋 900+ 資料欄位、sim() 回測 API、60+ 策略範例、因子分析與機器學習等，撰寫 finlab Python 程式前建議先查閱。

get_finlab_docs input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "doc": {
      "type": "string",
      "description": "參考文件檔名，例如 \"dataframe-reference.md\"。省略時回傳 SKILL.md 與文件清單。"
    }
  },
  "additionalProperties": false
}
how_to_start — FinLab 快速上手
Advertised by the server during the last successful anonymous check.

取得 FinLab 快速上手指南：如何用 AI 輔助流程（Claude cowork / Codex）在自己電腦安裝 FinLab 並跑第一個台股策略真實回測，以及免費線上體驗入口。適合回答「怎麼開始用 FinLab」「怎麼回測台股」。

how_to_start input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1125 ms
95th percentile latency
1125 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1125 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http finlab-mcp https://mcp.finlab.finance/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add finlab-mcp --url https://mcp.finlab.finance/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable finlab-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "finlab-mcp": {
      "url": "https://mcp.finlab.finance/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "finlab-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.finlab.finance/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start finlab-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "finlab-mcp": {
      "type": "http",
      "url": "https://mcp.finlab.finance/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http finlab-mcp https://mcp.finlab.finance/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://mcp.finlab.finance/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "finlab-mcp": {
      "serverUrl": "https://mcp.finlab.finance/mcp"
    }
  }
}

Let your agent find its tools

Find servers like FinLab MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 6,158