# com.fininfostation/tw-finance

> Taiwan finance open data: ETF, funds, TAIEX, sentiment, business climate, FX. Free & read-only.

- name: com.fininfostation/tw-finance
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 79/100 flags: no-repository
- quality: 88/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.fininfostation%2Ftw-finance
- tools: https://api.protogrid.dev/v1/servers/com.fininfostation%2Ftw-finance/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "tw-finance": {
      "type": "http",
      "url": "https://fininfostation.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 99
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-97% ~updated-79d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 88/100 (good)

### protocol: 100 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- pass `protocol.list_ttl`: tool list is cacheable (ttlMs 86400000)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); fund_lookup (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); market_sentiment (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,238 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 15, about 1,238 tokens to load them all
- tool set hash: 8fe7c2e3c95749906427093c253c6a4f
- badge: [![protogrid quality](https://protogrid.dev/badge/com.fininfostation/tw-finance.svg)](https://protogrid.dev/servers/com.fininfostation/tw-finance)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://fininfostation.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.9655172)

## Packages

_none_

## Tools (15)

- `business_climate`: 國發會景氣燈號：最新月燈號/綜合分數/9 項構成指標逐項檢查值與分數/下期發布日（官方預告）。NDC business climate signal with all 9 components.
- `data_catalog`: 列出本站「資料形狀 × 資料集」登錄表：有哪些 point（單值）／series（時間序列）／table（表格）／query（條件篩選＋群體聚合）資料集，各自的單位、識別碼種類、來源與深連結；query 母體另附可用欄位、運算子與可排序鍵。先呼叫本工具，即可組合出後續查詢。Catalog of datasets by shape (point/series/table/query) — call this first to compose queries.
- `data_point`: 取「一個標的 × 一個欄位 × 一個時點」的單值，如 0050 的折溢價、基金最新淨值、USD/TWD 匯率、景氣對策信號綜合分數。dataset 取自 data_catalog 的 point 清單；回應必附單位、資料日與來源。Single current value for one security and field.
- `data_query`: 對一個母體下條件篩出一組標的，並對整組計算聚合統計（count／coverage／min／max／mean／median／sum），如「費用率 0.4% 以下的被動 ETF，其費用率中位數」。where 語法為「欄位 運算子 值」以 and 連接（例 fee<=0.4 and type=passive）。回應必附母體大小 population 與欄位覆蓋率 coverage（有幾檔真的有這個欄位）。注意：績效欄位可用於 where 篩選與聚合統計，但不得作為排序鍵——排序即排名，本站不對個別商品做推薦。Filter a universe and aggregate over the matched set.
- `data_series`: 取「一個標的 × 一個欄位 × 一段時間」的時間序列，如 ETF 日收盤、基金淨值歷史。每點只有日期與值；資料缺口會以 gapNote 誠實標示、不靜默補值。Time series for one security and field.
- `data_table`: 取「一個標的的多列資料」，如 ETF 全成分股與權重、景氣對策信號 9 項構成指標、主要貨幣對一覽。回應含欄位定義（columns）與列（rows），截斷時標 truncated。Multi-row table for one security.
- `etf_lookup`: 以代號查台灣上市 ETF：名稱/發行投信/追蹤指數/市價/折溢價/費用率等基本資料。Look up a Taiwan-listed ETF by code (e.g. 0050).
- `etf_price_history`: 取 ETF 每日收盤價序列（預設近 12 個月、可調 months 1-120）。Daily close history for a Taiwan ETF.
- `fetch`: 以 search 回傳的 id 取該筆的完整內容（id／title／text／url／metadata）。A string which is a unique identifier for the search document.
- `fund_lookup`: 以代號或名稱關鍵字查台灣可銷售基金（境內投信/境外/期信）：最新淨值/淨值日/幣別/類型/總代理/今年以來報酬。Search Taiwan-distributed funds by code or name keyword.
- `fund_nav_history`: 取基金每日淨值序列（預設近 12 個月、可調 months 1-120；境內主級別最深約 10 年）。Daily NAV history for a fund.
- `fx_rates`: 主要貨幣即期匯率（多源交叉：ECB/台銀）含當日與近 1 週/1 月/3 月變化；可指定 pair（如 USD/TWD）。Spot FX rates with multi-period changes.
- `market_sentiment`: 台股情緒綜合分數（本站自製中性參考、含分項）。不含美股 CNN Fear & Greed（站主裁決不透過 MCP 再散布 CNN 資料，見 /us-sentiment 的公開指標原始值）。Taiwan market sentiment (self-made neutral reference); no CNN F&G.
- `search`: 以一段查詢字串搜尋本站的 ETF、台股、基金與資料集，回傳可引用的清單（id／title／url）。id 可交給 fetch 取完整內容。A single query string; returns citable results for Taiwan ETFs, stocks, funds and datasets.
- `taiwan_market_overview`: 台灣加權指數（TAIEX）最新官方收盤、市場廣度（漲跌家數）、台股情緒分數、台指選擇權 Put/Call 比一次取得。Taiwan market snapshot: TAIEX close, breadth, sentiment, PCR.
