Skip to main content
Glama
kewelin

taiwan-data-mcp

by kewelin

taiwan-data-mcp

讓 AI 助理(Claude、Cursor、任何支援 MCP 的工具)直接查 台灣公開資料 的 MCP server。

一句話:把散落的台灣資料站,變成 AI 可以直接呼叫的工具。資料即時來自來源站,回傳一律附上來源與連結。

工具

工具

功能

資料來源

taiwan_scam_check

查網址 / 網域是否被 165 通報詐騙

fraud.tw(內政部警政署 165)

taiwan_company_search

用公司名搜尋,拿統一編號與負責人

inc.com.tw(經濟部公司登記)

taiwan_company_profile

用統編查公司完整登記資料(含董監事)

inc.com.tw

taiwan_person_companies

用人名查他擔任負責人/董監事的公司

inc.com.tw

taiwan_company_risk

公司風險查核(統編或公司名):解散/拒絕往來/國際制裁/金管會/司法/勞動/環保紅旗+上市櫃即時股價

inc.com.tw

taiwan_company_relations

公司關係圖譜:法人股東/轉投資子公司/最終母公司/集團規模/共同董監事人脈

inc.com.tw

taiwan_company_name_check

公司名稱預查/撞名查重(創業命名用)

inc.com.tw

taiwan_company_verify

經濟部商工登記 OpenAPI 即時官方登記狀態

inc.com.tw

taiwan_realprice_search

搜尋實價登錄的地址 / 路段 / 行政區

housetw.com(內政部實價登錄)

taiwan_realprice_locate

用經緯度反查行政區與行情頁

housetw.com

taiwan_realprice_area

查某縣市 / 行政區成交行情統計

housetw.com

taiwan_realprice_estimate

自動估價:單價區間與推估總價

housetw.com

taiwan_realprice_road

查某路段成交行情與逐年走勢

housetw.com

taiwan_drug_search

用中文藥名搜尋核准藥品、取許可證字號

health-hub(衛福部食藥署)

taiwan_drug_info

用許可證字號查藥品成分/適應症/健保價/回收/短缺

health-hub

taiwan_gov_tender_by_company

查某公司投標/得標的政府採購案

政府電子採購網(g0v PCC API)

taiwan_gov_tender_search

用標案名稱關鍵字搜尋政府採購案

政府電子採購網(g0v PCC API)

taiwan_farm_price

查蔬果批發市場最新行情(菜價)

農業部 data.moa.gov.tw

跨工具串接是重點:例如「查這家公司 → 看它登記地址那區的房價 → 查它官網是不是詐騙」,一次問答內 AI 自己串起來。

Related MCP server: TWSE MCP Server

安裝

需要 Node.js 18+。

Claude Desktop

編輯 claude_desktop_config.json(設定 → Developer → Edit Config):

{
  "mcpServers": {
    "taiwan-data": {
      "command": "npx",
      "args": ["-y", "taiwan-data-mcp"]
    }
  }
}

Claude Code

claude mcp add taiwan-data -- npx -y taiwan-data-mcp

Cursor / 其他

任何支援 MCP 的工具,指向 npx -y taiwan-data-mcp(stdio)即可。

範例提問

  • 「google.com 是詐騙網站嗎?」

  • 「台積電的統編、負責人、資本額是多少?」

  • 「臺北市信義區的房價中位數大概多少?哪幾條路最貴?」

  • 「我在經緯度 25.034, 121.5645,附近房價如何?」

開發

npm install
npm run smoke   # 直接打活線 API,驗證 6 個工具回得出資料
node test/e2e.mjs  # MCP 協定層測試

資料來源網站

本工具的資料即時來自以下網站,每筆查詢結果也都會標註來源與連結:

  • 實價登錄行情 — housetw.com(實價雷達)

  • 公司登記查核 — inc.com.tw(台灣公司登記網)

  • 165 防詐查詢 — fraud.tw(防詐雷達)

  • 藥品/健康查詢 — health-hub(衛福部食藥署資料)

  • 政府標案查詢 — 政府電子採購網開放資料(透過 g0v PCC API

  • 農產批發行情 — 農業部開放資料(data.moa.gov.tw

三站皆為聚合台灣政府開放資料的免費查詢服務。

資料與免責

資料即時取自上述各站的公開 API,內容以政府開放資料為準,僅供參考,不構成投資、法律或交易建議。詐騙查詢結果為「是否被通報」,未被通報不代表絕對安全。

License

MIT License

Available Tools

23 tools
taiwan_bulk_due_diligenceA

批次盡職調查:一次傳多個台灣公司(統編或公司名,最多 50 個),各回一張風險卡(登記狀態/資本/負責人/上市櫃股價/拒往/金管/勞動/環境/司法/國際制裁旗標)。徵信、法遵、供應商清單批次查核用。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
idsYes公司統編或名稱陣列,最多 50 個

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It discloses that the tool returns a risk card with multiple flags and mentions the data source. Behavioral details like error handling are omitted, but for a read-only bulk query this is adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is a single, well-structured paragraph. It front-loads purpose, lists output fields, and provides use cases and data source. No redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple parameter and no output schema, the description sufficiently covers purpose, output contents, and use cases. It hints at an array of risk cards but could explicitly state the return structure.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with a clear description. The tool description repeats the schema info without adding new meaning, so it meets baseline expectation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool performs batch due diligence on Taiwanese companies, returning a risk card with specific fields. It distinguishes from individual tools like taiwan_company_risk by emphasizing bulk operation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Description provides use cases: credit investigation, compliance, supplier list batch checks. It implies when to use (for bulk) but does not explicitly exclude individual queries or mention alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_company_name_checkA

公司名稱預查/撞名查重:給一個想取的公司名稱,回傳是否已有相同或近似的既有公司(含統編)。創業命名或盡調辨識用。回傳 core(特取名稱)、exact(完全相同)、similar(近似)。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes想查的公司名稱,例如「台積電」「方圓科技」

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must convey behavioral traits. It discloses the return structure and data source but does not mention aspects like read-only behavior, rate limits, or any side effects. The description is adequate but not comprehensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, with the key action front-loaded ('公司名稱預查/撞名查重'). It provides examples and return info in a few sentences with no wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter and no output schema, the description sufficiently covers the purpose, input, output fields, and use case. An AI agent has enough context to select and invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers the single parameter 'name' with a clear description. The tool's description adds minimal extra meaning beyond the schema. Since schema coverage is 100%, the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool checks if a proposed company name already exists in Taiwan's registry, including similar names. It specifies the return fields (core, exact, similar) and the data source, leaving no ambiguity about the tool's function.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly mentions use cases: '創業命名或盡調辨識用' (for startup naming or due diligence identification). However, it does not provide guidance on when not to use this tool versus siblings like taiwan_company_search or taiwan_company_profile, though the specificity of name pre-check implies differentiation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_company_profileB

用 8 位統一編號查台灣公司完整登記資料:名稱、負責人、資本額、實收資本、設立日期、登記地址、營業項目、狀態、上市櫃與進出口資格等。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
unified_business_noYes8 位統一編號,例如 22099131

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must carry the full burden. It states the data source (inc.com.tw) but does not disclose whether the operation is read-only, any authentication requirements, rate limits, or data freshness. For a tool without annotations, more behavioral context is needed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence that front-loads the purpose and lists the key data fields, with no unnecessary words. It is concise and effective.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple lookup tool with one parameter and no output schema, the description lists the expected return fields, which is adequate. It could mention data freshness or error handling, but the lack of output schema reduces the burden. The description is largely complete given the tool's complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage for the single parameter 'unified_business_no', and the description repeats that it uses an 8-digit number. The description adds an example but does not provide additional semantics like format validation or typical usage beyond the schema, so the baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool uses an 8-digit unified business number to retrieve complete Taiwan company registration data, listing specific fields such as name, capital, and status. It is distinct from sibling tools like 'taiwan_company_search' or 'taiwan_company_verify', but does not explicitly differentiate itself.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when you have a unified business number, but provides no explicit guidance on when to use this tool versus alternatives, nor when not to use it. No exclusions or alternative recommendations are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_company_rankingsA

台灣公司排行:依登記資本額(預設)或成立新舊,列出最大/最新/最老的公司,可選行業關鍵字(子字串比對,如「半導體」「銀行」「餐飲」)與縣市(如「臺北市」)篩選。回答「某產業/某縣市資本額最大的公司是哪些」用。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
byNocapital 資本額最大(預設)/newest 最新成立/oldest 最老字號
limitNo回傳幾筆(1-50,預設 20)
countyNo縣市(可選),例如「臺北市」(用「臺」非「台」)
industryNo行業關鍵字(可選,子字串),例如「半導體」「銀行」

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full responsibility. It discloses the data source (inc.com.tw), mentions sub-string matching for industry, and clarifies county name formatting (use '臺' not '台'). This adds transparency beyond the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single well-structured sentence that front-loads the main function and then provides filtering details. It is concise without missing critical information, though it could be slightly more structured with bullet points.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the low complexity (4 optional parameters, no output schema), the description adequately covers the tool's behavior and usage. It explains the ranking order and filtering, which is sufficient for an agent to decide when to invoke.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, but the description adds value by explaining the 'by' enum options (newest/oldest), noting the sub-string matching behavior for industry, and warning about the correct character for 'Taipei'. This enriches understanding beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it lists Taiwanese company rankings by capital (default), newest, or oldest, with filtering by industry keyword and county. It specifies the data source and gives example queries, making the tool's purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states the tool is for answering questions like 'which companies have the largest capital in a certain industry/county?' It does not explicitly exclude alternatives, but the context signals and sibling tool names imply other tools for different queries.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_company_relationsA

公司關係圖譜(盡職調查/天眼查式):用 8 位統編查該公司的法人股東(誰持有它)、轉投資子公司(它持有誰)、推估最終母公司、整個集團規模,以及共同董監事連到的其他公司(人脈)。查母子公司、集團版圖、關係人用。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
unified_business_noYes8 位統一編號,例如 04541302(鴻海)

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so the description carries full burden. It discloses the tool's scope (shareholders, subsidiaries, ultimate parent, group size, connected companies via directors) and data source (inc.com.tw). It also notes '推估最終母公司' (estimated ultimate parent), indicating a non-definitive result. However, it does not address rate limits, authentication, or data freshness.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that front-loads the tool's purpose and lists its outputs. It is moderately concise given the complexity, though it could be slightly more structured with bullet points.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (multiple relationship types), no output schema, and no annotations, the description provides a good overview of the tool's capabilities and use case. It lacks details on return format, pagination, or error handling, but is adequate for an agent to understand when to invoke it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The only parameter, unified_business_no, is fully described in the input schema (8-digit number, example). Schema coverage is 100%, so baseline is 3. The description reiterates '用 8 位統編' but adds no new semantic detail beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly specifies the tool's function: given an 8-digit business number, it retrieves corporate shareholders, subsidiaries, estimated ultimate parent, group size, and connected companies via common directors. This distinguishes it from sibling tools like taiwan_company_profile (basic info) and taiwan_person_companies (person-centric).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description states the use case: '查母子公司、集團版圖、關係人用' (for checking parent-subsidiary, group landscape, related parties). It implicitly contrasts with sibling tools (e.g., for simple company info use taiwan_company_profile), but lacks explicit when-not-to-use or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_company_riskA

公司風險查核(盡職調查紅旗):用 8 位統編或公司名稱(簡稱如「台積電」自動解析成正主)查該公司有無解散、政府採購拒絕往來、國際制裁名單(OFAC/UN)、金管會重大裁罰、司法案件、勞動法令裁罰、環保裁罰,回傳風險等級、紅旗清單與負責人,上市櫃並附即時股價。資料來源:inc.com.tw(聚合政府公開資料)。

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNo公司名稱或簡稱(與統編二擇一),例如「台積電」「鴻海」
unified_business_noNo8 位統一編號(與 name 二擇一),例如 22099131

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden and excels: it enumerates all checks performed (dissolution, government procurement blacklist, OFAC/UN sanctions, FSC penalties, judicial cases, labor law penalties, environmental penalties) and outputs (risk level, red flags, responsible person, stock price for listed companies). It also cites the data source (inc.com.tw).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single paragraph that efficiently conveys all necessary information without being wordy. It could be slightly more structured (e.g., bullets), but the information density is high and front-loaded with the core action '查核...'.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (multiple risk categories, no output schema, 2 parameters), the description is exceptionally complete: it explains input format, auto-resolution, all checks performed, output elements (risk level, red flags, responsible person, stock price), and data source. No gaps remain.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the description adds significant value beyond the schema: it explains that the company name can be an abbreviation (e.g., '台積電') and is auto-resolved, and that the two parameters are mutually exclusive ('二擇一'). This helps the agent choose correctly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: checking company risks (due diligence red flags) using an 8-digit unified business number or company name, and returning risk level, red flags, responsible person, and stock price for listed companies. It differentiates from sibling tools like taiwan_bulk_due_diligence (bulk check) and taiwan_company_name_check (name-only check).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description specifies input options (unified business number or company name with auto-resolution for abbreviations) but does not explicitly state when to use this tool versus alternatives like taiwan_bulk_due_diligence or when not to use it. Usage context is implied but not clearly delineated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_company_verifyA

用 8 位統編向經濟部商工登記公示 OpenAPI 取「即時」官方登記狀態(名稱/狀態/資本/實收/負責人/所在地/登記機關)。比一般資料庫更即時,適合確認某公司目前是否仍存續、是否已解散撤銷。資料來源:經濟部商工登記公示資料。

ParametersJSON Schema
NameRequiredDescriptionDefault
unified_business_noYes8 位統一編號,例如 22099131

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses the data source (MOEA OpenAPI) and notes it is 'real-time', but does not discuss rate limits, authentication, error handling, or potential side effects. It is adequate but lacks depth for a comprehensive understanding.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, front-loaded with the core purpose, and every sentence adds necessary information without redundancy. It is appropriately concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has only one parameter, no output schema, and several similar siblings, the description is sufficiently complete to understand what the tool does and how to use it. It covers data source, use case, and parameter format.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter has 100% schema coverage, and the description adds a clear example ('例如 22099131') and specifies the length (8 digits). This adds value beyond the schema, aiding correct usage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it uses an 8-digit unified business number to fetch real-time official registration status from the MOEA's OpenAPI, listing specific fields (name, status, capital, etc.). It distinguishes itself from databases by being more real-time, making the purpose specific and unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage context (checking if a company is still existing or dissolved) but does not explicitly state when not to use it or compare with sibling tools like taiwan_company_profile or taiwan_company_search. Usage guidance is implied but not fully explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_compare_companiesA

並排比較 2–5 家台灣公司:回傳各家的負責人、資本額、成立年數、登記狀態、上市櫃、企業穩定度分數、政府標案得標數、拒絕往來/勞動/金管裁罰筆數,方便挑供應商或做對手分析。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
idsYes2–5 個公司統編或名稱

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses the data source and return fields but does not mention error handling, rate limits, or behavior on invalid IDs. For a read-only comparison tool, this is adequate but could be improved.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with a clear purpose and a list of returned fields. It is concise and front-loaded, with no wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (single array parameter, no nested objects, no output schema), the description fully explains input requirements and output fields. It includes the data source and intended use case.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has 100% description coverage, with a single required parameter 'ids' described as '2–5 個公司統編或名稱'. The description adds no new information beyond the schema, so baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool compares 2-5 Taiwanese companies side-by-side and lists specific data points returned (responsible person, capital, age, status, etc.). It distinguishes itself from sibling tools like company_profile (single company) by focusing on multi-company comparison.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for supplier selection or competitor analysis, providing clear context. It does not explicitly state when not to use or list alternatives, but the sibling tool names (e.g., taiwan_company_profile) suggest appropriate alternatives for single-company queries.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_drug_infoA

用藥品許可證字號查該藥詳情:主成分、適應症、用法、劑型、藥品類別/管制分級、健保價、是否被回收、供應短缺狀態。資料來源:衛福部食藥署 · health-hub。用藥請依醫師、藥師指示。

ParametersJSON Schema
NameRequiredDescriptionDefault
license_noYes藥品許可證字號,例如「衛署藥輸字第024600號」(可先用 taiwan_drug_search 取得)

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It states the data source and what information is returned, but lacks details on error handling (e.g., invalid license number) or any restrictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, using two sentences to cover purpose, data source, and a suggestion for prior use. No unnecessary information, but the list of fields could be more structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple query nature with one parameter and no output schema, the description adequately explains what the tool returns (list of fields). It mentions the data source, making it contextually complete for typical use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema covers the single parameter 'license_no' with a description of its format and source. The tool description does not add additional semantic value beyond the schema, so performance is adequate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: querying drug details using a license number. It lists specific fields like active ingredient, indications, usage, etc., and distinguishes from sibling tool 'taiwan_drug_search' by stating the input source.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a clear usage flow: use 'taiwan_drug_search' first to obtain the license number. It does not explicitly exclude alternative uses, but the context is sufficient for an agent to understand when to invoke this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_farm_priceA

查台灣農產品批發市場最新交易行情:某蔬果的平均、最高、最低批發價(元/公斤)與交易量。颱風季菜價查詢常用。涵蓋蔬果花卉,不含禽蛋肉品。資料來源:農業部 data.moa.gov.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
cropYes蔬果名稱,例如「高麗菜」「香蕉」「青蔥」「番茄」
marketNo批發市場(可選,預設「台北一」),例如「台北一」「台北二」「台中」「三重」「高雄」

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so the description bears full burden. It discloses the tool returns price and volume data, covers specific categories, excludes others, and cites the data source. It does not mention side effects, but as a read-only query, that is acceptable. Adds useful context beyond schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise: two sentences and a data source line. Front-loaded with purpose and output, followed by context and coverage. Every sentence adds value without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Without an output schema, the description adequately explains return values (price stats and volume), units, data source, and coverage. It misses details like handling multiple markets or error conditions, but is sufficient for common usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptions for both parameters (crop and market, with default). The description adds no new parameter-specific meaning beyond the schema; it re-iterates crop name examples and default market. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool queries latest wholesale market prices for agricultural products, with specific output (average, high, low price per kg, volume). It delineates coverage (vegetables, fruits, flowers) and exclusions (poultry, eggs, meat), distinguishing it from sibling tools focused on companies, real estate, or drugs.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

While the description does not explicitly contrast with alternatives, its domain (agricultural prices) is distinct from all sibling tools, making usage context clear. It implies use when needing Taiwan farm prices, especially during typhoon season, without specifying when not to use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_find_connectionA

查兩家公司/兩個人之間的最短關係鏈(天眼查式盡職調查):透過共同負責人/董監事一層層串接,回傳中間的人與公司節點與相隔層數。用於「這兩家公司/這兩個人有沒有關係、怎麼牽上線」。a、b 可填公司名、8 位統編或人名。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
aYes起點:公司名/統編/人名,例如「鴻海精密工業」
bYes終點:公司名/統編/人名,例如「三創數位」

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It discloses that the tool returns intermediate nodes and distance ('中間的人與公司節點與相隔層數'), implying a read-only operation. It also mentions '天眼查式盡職調查' to set expectations. No side effects or auth needs are discussed, but the behavior is adequately described for a path-finding tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single block of text that is relatively concise for the information it conveys. It front-loads the main purpose and includes examples. Slightly verbose with extra details like '資料來源:inc.com.tw' but not excessive.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite lacking an output schema, the description explains the return format (nodes and distance). It covers the essential aspects of the tool's functionality and data source. No mention of limits or pagination, but acceptable for a path-finding tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers both parameters with descriptions, achieving 100% coverage. The description adds value by clarifying that parameters can be company name, 8-digit unified number, or person name, and provides examples. This exceeds the baseline of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool finds the shortest relationship chain between two companies/people using common directors/officers, and provides an analogy to Tianyancha due diligence. It distinguishes itself from sibling tools like taiwan_company_relations by specifying 'shortest chain' and 'how they connect'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly says 'use for: do these two companies/people have a relationship, how are they connected?' which provides clear context. It does not explicitly state when not to use or name alternatives, but the purpose is well-defined enough to guide selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_gov_tender_by_companyA

查某公司/廠商參與投標或得標的政府採購案,回傳標案名稱、機關、公告類型、日期與相關廠商。可搭配公司查核做盡職調查(這家公司接過哪些政府標案)。資料來源:政府電子採購網開放資料(g0v PCC API)。

ParametersJSON Schema
NameRequiredDescriptionDefault
companyYes公司/廠商名稱,例如「大同股份有限公司」

TDQS

A3.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided; description lacks disclosure of read-only nature, rate limits, or other behavioral traits. Only implies data retrieval through its description of returning results.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with core functionality. Every sentence adds value: first describes function and output, second gives usage context and data source. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Lists returned fields, provides usage scenario, and cites data source. Lacks details on pagination, limits, or authentication, but is sufficient for a simple query tool. Should ideally mention if it returns current or historical data.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Parameter 'company' is well-described in schema (with example). Description adds no additional semantic meaning beyond schema. Schema coverage is 100%, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states it queries a company's government procurement cases, listing specific return fields (tender name, agency, announcement type, date, related companies). Differentiates from sibling tools like taiwan_gov_tender_search by being company-specific.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides context for use in due diligence (可搭配公司查核做盡職調查). Implies usage when you have a company name, but does not explicitly differentiate from alternatives or state when not to use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_person_companiesA

用人名查他擔任「負責人/董監事」的台灣公司,回傳關聯公司數與範例公司(公司關係/查老闆人脈用)。以姓名比對,可能含同名同姓。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes人名,例如「郭台銘」

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description bears full burden. It discloses matching by name, potential same-name matches, data source, and output (count and example companies). It does not mention rate limits or auth, but for a read-only search, this is adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is very concise: a few sentences in Chinese that front-load the core purpose, output, and data source. No unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple single-parameter search tool with no output schema, the description adequately explains input, output (count and examples), and caveats. It does not specify result limits or format, but these are minor omissions.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The only parameter 'name' is fully described in the schema (example: 郭台銘). The tool description does not add additional semantics beyond what the schema provides; it only reiterates the purpose. With 100% schema coverage, baseline score is 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool searches for Taiwanese companies where a person serves as responsible person/director/supervisor. It specifies the output (number of related companies and examples) and distinguishes from sibling tools like taiwan_company_search (company-by-name) and taiwan_company_profile (detailed info).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for checking person-company relationships and networks. It includes a caveat that same names may cause ambiguity. However, it does not explicitly state when to use alternative tools or when not to use this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_realprice_areaA

查某縣市 / 行政區的不動產成交行情統計:中位與平均單價(萬/坪)、成交筆數、平均屋齡、價格分位、熱門路段排行。資料來源:housetw.com(內政部實價登錄)。

ParametersJSON Schema
NameRequiredDescriptionDefault
countyYes縣市,例如「臺北市」「新北市」(用「臺」非「台」)
districtNo行政區(可選),例如「信義區」

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided. The description mentions the data source and the read-only output statistics, but does not disclose rate limits, authentication requirements, or other behavioral traits that an agent should know.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence that front-loads the core function and lists outputs efficiently. Could be slightly more concise but overall well-structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given only two parameters (one required) and no output schema, the description covers the return values (median/average price, count, age, percentiles, road rankings) and data source. It is complete for the tool's scope.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the description adds little beyond the examples in the schema. The description mentions county and district but does not provide additional semantic meaning like format restrictions beyond what's in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: querying real estate transaction statistics for a county/district. It lists specific outputs (median/average price, transaction count, etc.) and distinguishes from sibling tools like taiwan_realprice_estimate and taiwan_realprice_locate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives. The description does not mention when-not-to-use or provide comparative context with sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_realprice_estimateA

自動估價:輸入縣市+行政區(可加建物型態/屋齡/坪數),回傳可比案例的單價區間(萬/坪)與推估總價。資料來源:housetw.com(內政部實價登錄)。

ParametersJSON Schema
NameRequiredDescriptionDefault
countyYes縣市,例如「臺北市」(用「臺」非「台」)
districtYes行政區,例如「信義區」
area_pingNo坪數(可選),給了才會推估總價
house_ageNo屋齡(可選,年)
building_typeNo建物型態(可選),例如「住宅大樓」「公寓」「華廈」

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions data source and returns unit price range and total price, but does not elaborate on limitations, estimation methodology, or edge cases (e.g., missing data, geographic scope). It is adequate but lacks depth.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two sentences, elegantly covering purpose, inputs, outputs, and data source. It is front-loaded with the core functionality in the first sentence. No extraneous information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 5 parameters and no output schema, the description is reasonably complete for a simple estimation tool. However, it lacks details on response structure, error handling, or specific limitations. It meets the minimum viability threshold.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with detailed parameter descriptions (e.g., county uses '臺' not '台'). The tool description adds little beyond restating the schema, such as '可加建物型態/屋齡/坪數'. Since the schema already covers semantics, the description provides minimal additional value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: automatic valuation (自動估價). It specifies inputs (county, district, optional building type/age/area) and outputs (comparable unit price range in 萬/坪 and estimated total price). It also distinguishes from sibling tools like taiwan_realprice_area or taiwan_realprice_search by focusing on estimation/valuation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide explicit guidance on when to use this tool versus its siblings (e.g., taiwan_realprice_search, taiwan_realprice_area). It only describes functionality, leaving the agent to infer usage context without clear boundaries or conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_realprice_locateA

用經緯度 (lat,lng) 反查所在的台灣縣市與行政區,並回傳該區實價頁連結。適合「我現在在這個座標,附近房價如何」。資料來源:housetw.com。

ParametersJSON Schema
NameRequiredDescriptionDefault
latYes緯度,例如 25.034
lngYes經度,例如 121.5645

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It states the output (county, district, link) and data source (housetw.com), but does not explicitly confirm it is read-only or mention any potential errors or rate limits. This is adequate but not thorough.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences in Chinese, front-loaded with the action and use case. No unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with 2 parameters and no output schema, the description provides sufficient context: what it does, when to use, and data source. Could mention coordinate limitations, but overall complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with clear descriptions for lat and lng. The tool description adds the context that they are for reverse geocoding in Taiwan, but does not add significant meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool uses lat/lng to reverse-lookup Taiwan county/district and returns a link. This differentiates it from siblings like taiwan_realprice_area (area-based) or taiwan_realprice_estimate (estimate). The specific use case is given.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a clear use case: 'when you are at a coordinate and want to know nearby housing prices'. It does not explicitly state when not to use or list alternatives, but the context is strong enough for correct selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_realprice_roadA

查某路段的不動產成交行情:單價統計(萬/坪)、成交筆數、屋齡與逐年價格走勢。資料來源:housetw.com(內政部實價登錄)。

ParametersJSON Schema
NameRequiredDescriptionDefault
roadYes路段,例如「松高路」「忠孝東路四段」
countyYes縣市,例如「臺北市」
districtYes行政區,例如「信義區」

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It mentions the data source (housetw.com, based on government data) but does not disclose behavioral aspects like cache behavior, data recency, or required permissions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Description is a single concise sentence with a second line for data source, front-loaded with purpose. No waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Lists key outputs (unit price, count, house age, trends) which is sufficient for a retrieval tool. However, no output schema or mention of error handling/pagination. Almost complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with clear parameter descriptions. The tool's description adds no additional meaning beyond the schema, earning baseline 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states the tool queries real estate transaction prices for a specific road, listing the outputs: unit price statistics, transaction count, house age, and yearly trends. It clearly differentiates from siblings like taiwan_realprice_area (area-level) by focusing on roads.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus siblings. Does not mention prerequisites, exclusions, or alternative tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_scam_checkA

查詢某網址 / 網域是否被內政部警政署 165 反詐騙通報為詐騙或涉詐網站。輸入網址或網域(如 example.com 或完整 URL)。回傳風險等級、通報情形與來源連結。資料來源:fraud.tw(165 開放資料)。

ParametersJSON Schema
NameRequiredDescriptionDefault
domainYes要查詢的網址或網域,例如 example.com、https://www.example.com

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It explains the read-only nature, return fields (risk level, reports, source link), and data source. No destructive behavior is relevant.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no wasted words, front-loaded with purpose. Extremely concise and structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple query tool with one parameter, the description fully covers input and output expectations. No gaps despite missing output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema covers the one parameter with 100% coverage, but the description adds examples of input format (e.g., example.com or full URL), which is not in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool checks if a URL/domain is reported as fraud by Taiwan's 165 anti-fraud unit, distinguishing it from sibling tools like company checks or real estate queries.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when needing to verify a site's fraud status, and sibling tools are dissimilar, so context is clear. However, no explicit when-not or alternatives are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

taiwan_validate_tax_idA

驗證台灣統一編號(8 碼)檢查碼是否正確(財政部統編邏輯,純演算法、不查資料庫)。資料清理、表單驗證、判斷一組號碼是否為有效統編格式用。回傳 valid 與說明。資料來源:inc.com.tw。

ParametersJSON Schema
NameRequiredDescriptionDefault
unified_business_noYes8 位統一編號,例如 22099131

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully discloses behavioral traits: it is a pure algorithm (no database), returns valid and explanation, and cites the data source. This gives the agent full understanding of what to expect.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise: two sentences plus a data source. The first sentence states the core function immediately, and every sentence provides necessary information without waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple validation tool with one parameter and no output schema, the description is complete. It explains the algorithm, purpose, and return value, leaving no gaps for the agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The sole parameter 'unified_business_no' has a description that adds value beyond the schema: it specifies the format (8 digits) and provides an example. Since schema coverage is 100%, baseline is 3, but the added context justifies a 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it validates the check digit of Taiwan's unified business number using an algorithm, specifying the length (8 digits) and that it is pure algorithm without database lookup. It also mentions usage for data cleaning and form validation, distinguishing it from sibling tools like taiwan_company_verify.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear use cases: data cleaning, form validation, and checking valid format. However, it does not explicitly state when not to use it or compare with alternatives like taiwan_company_verify, leaving some ambiguity for the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 23 tool updatesv0.12.0
    • First observedtaiwan_bulk_due_diligence
    • First observedtaiwan_company_name_check
    • First observedtaiwan_company_profile
    • First observedtaiwan_company_rankings
    • First observedtaiwan_company_relations
    • First observedtaiwan_company_risk
    • First observedtaiwan_company_search
    • First observedtaiwan_company_verify
    • First observedtaiwan_compare_companies
    • First observedtaiwan_drug_info
    • First observedtaiwan_drug_search
    • First observedtaiwan_farm_price
    • First observedtaiwan_find_connection
    • First observedtaiwan_gov_tender_by_company
    • First observedtaiwan_gov_tender_search
    • First observedtaiwan_person_companies
    • First observedtaiwan_realprice_area
    • First observedtaiwan_realprice_estimate
    • First observedtaiwan_realprice_locate
    • First observedtaiwan_realprice_road
    • First observedtaiwan_realprice_search
    • First observedtaiwan_scam_check
    • First observedtaiwan_validate_tax_id

TDQS

A3.9/5.0

Scored across 23 tools

Disambiguation4/5

Tools cover distinct domains (company, drug, real estate, farm, scam, tender), but within the company domain there are 9 tools that could overlap, e.g., taiwan_company_search vs taiwan_company_name_check. However, detailed descriptions clarify their specific purposes, making confusion unlikely.

Naming Consistency5/5

All tools follow a consistent pattern: taiwan_<domain>_<action> in snake_case, with clear verbs like search, check, info, verify. No mixing of styles.

Tool Count4/5

23 tools is on the high side for a single server, but the scope is broad (multiple domains). Each domain has a reasonable number of tools, and none feel superfluous.

Completeness4/5

Company domain is well-covered (search, profile, risk, relations, compare, verify, etc.). Drug, real estate, and tender have core operations. Missing some secondary features (e.g., drug interactions, real estate listings), but overall solid for the stated data sources.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Provides real-time access to Taiwan Stock Exchange market data, financial reports, and trading analytics. It enables users to query stock prices, market indices, and corporate profitability metrics through natural language.
    22
    9 npm
    7
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An open-source MCP server that aggregates Taiwan public data sources (data.gov.tw, TWSE, MOEA, CWA, etc.) and exposes them through the Model Context Protocol, enabling AI agents to query Taiwan data with a single configuration line.
    1
    Apache 2.0
  • A
    license
    A
    quality
    D
    maintenance
    MCP server for querying Taiwan's real estate transaction registry via web scraping of the Ministry of the Interior's official portal. Enables natural language queries for real estate sales, rentals, and pre-sale housing data.
    1
    1
    MIT