Finlab Ai

io.github.koreal6803Published by GitHub account koreal6803v1.1.0Updated Oct 24, 2026

Quantitative trading toolkit with 900+ data columns, backtesting, and 60+ strategy examples.

VerifiedStreamable HTTPWeb executableFinanceKnowledge & MemoryData & Analytics

Overview

AI-generated overview

Hosted read-only FinLab MCP server that gives an assistant Taiwan and U.S. stock strategy backtests, per-stock factor evidence, data catalog and FinLab docs.

What you can do
  • List and read FinLab's public Taiwan-stock strategies, including backtest performance (CAGR, Sharpe, max drawdown) and runnable Python code
  • Look up daily-updated evidence for a single Taiwan stock: fundamental and valuation percentiles, chip factors, triggered signals and their historical forward returns
  • Summarize the FinLab data catalog: table and column counts, row counts, year ranges and representative datasets
  • Retrieve FinLab Skill documentation, including the data reference, sim() backtest API, strategy examples, factor analysis and machine learning notes
  • Get a quick-start guide for installing FinLab locally and running a first backtest
When to use it
Useful when you want an assistant to research Taiwan or U.S. stock strategies, inspect backtested performance, or check factor and signal evidence for a specific ticker without writing scraping or backtest code yourself. Also handy for looking up FinLab data fields and API usage before writing finlab Python code.
Requirements
Remote streamable HTTP endpoint at mcp.finlab.finance; no install, package, environment variable or header is declared. The README notes that running strategies locally through the separate skill requires the finlab Python package, a browser sign-in and a FinLab account (free account with a 7-day trial).
Before you install
The hosted server is described as read-only, but the separate local skill downloads market data and documents broker order APIs; the README says the AI should preview and wait for confirmation before placing real orders. Signing in creates a FinLab account, and the trial is time-limited. Strategy code and data run on your machine, and nothing is uploaded unless you ask.

Installation

In SourceWeft

  1. Open Finlab Ai in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.koreal6803%2Ffinlab-ai/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "finlab-ai": {
      "type": "http",
      "url": "https://mcp.finlab.finance/mcp"
    }
  }
}

README

FinLab AI

Let AI discover your next alpha.

FinLab AI is an official product of FinLab. FinLab official website: https://finlab.finance

Backtest Taiwan and U.S. stocks from Claude Code, Codex or Gemini CLI: your AI gets real market data and the FinLab backtest engine, with no scraping or backtest code of your own.

用 Claude Code、Codex 回測台股：AI 直接讀還原股價、月營收、財報、三大法人資料，用 FinLab 回測引擎驗證策略。


[Demo]

Installation

bash
npx skills add koreal6803/finlab-ai --skill finlab -g -y

This installs the skill for Claude Code, Codex, Cursor and other tools that read Agent Skills, for every project on this machine. Or use your tool's own plugin command:

ToolCommand
Claude Code/plugin install finlab-plugin --marketplace koreal6803/finlab-ai
Codexcodex plugin marketplace add koreal6803/finlab-ai, then codex plugin add finlab-plugin@finlab-ai
CursorCustomize > From GitHub Repository > koreal6803/finlab-ai

Then ask your AI: "Backtest a Taiwan stock strategy that buys the strongest monthly revenue growth." The first run asks you to sign in to FinLab once in your browser, which creates a free account with a 7-day full trial, no credit card needed.

What it does on your machine

The skill is documentation: it has no hooks and no bundled programs. It tells your AI tool to install the finlab Python package with uv, sign in with python -m finlab login, which opens your browser, and download market data from FinLab. Strategy code runs on your machine, and nothing is uploaded unless you ask for it. It also documents broker order APIs, and tells your AI to show you a preview and wait for your confirmation before placing any real order.

MCP Server

A hosted, read-only MCP server (streamable HTTP) is available — no install required:

bash
claude mcp add --transport http finlab https://mcp.finlab.finance/mcp

Tools: list_strategies, get_strategy (with Python code), get_stock_evidence, get_data_catalog, get_finlab_docs (this skill's docs, always in sync with main), how_to_start. Listed on the MCP Registry as io.github.koreal6803/finlab-ai (see server.json). The old finlab-ai.koreal6803.workers.dev endpoint is retired.

Documentation

DocumentContent
Data Reference900+ columns across 80+ tables
Backtesting Referencesim() API, resampling, metrics
Factor Examples60+ complete strategy examples
Best PracticesPatterns, anti-patterns, tips
ML ReferenceFeature engineering, labels

Learn more

Source: README.md at commit b4541ea

Tools

6

list_strategies

列出 FinLab 策略庫

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

Takes no parameters.

get_strategy

取得單一策略完整內容

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

Parametersslugrequired

get_stock_evidence

查個股數據實證

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

Parametersmarketsymbolrequired

get_data_catalog

FinLab 資料庫目錄摘要

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

Takes no parameters.

get_finlab_docs

FinLab Skill 開發文件

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

Parametersdoc

how_to_start

FinLab 快速上手

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

Takes no parameters.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.