Skip to main content
Glama
Sign In

Taiwan Procurement

by io.github.pipeworx-io
OverviewDiscussionsAdmin

Taiwan List By Date

taiwan_list_by_date
Read-onlyIdempotent

List Taiwan government procurement tenders (政府電子採購網 / PCC) published on a given date, via the g0v community mirror. Pass a date as YYYYMMDD (e.g. "20260630"); defaults to today. Returns tenders with id, title, agency, announcement type, and any associated companies. Third-party mirror; results are best-effort.

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "date": "20250630"
    },
    "name": "taiwan_list_by_date"
  }
}

Input Schema

NameRequiredDescriptionDefault
dateNoDate in YYYYMMDD, e.g. "20260630". Omit for today.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / examples
      Added value: +[
+  {
+    "date": "20250630"
+  },
+  {}
+]
  2. First observed

TDQS

A4.2/5.0
Behavior4/5

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

The description adds behavioral context beyond the annotations by disclosing that this is a third-party mirror and results are 'best-effort', which implies potential incompleteness or staleness. It also states what the tool returns (id, title, agency, announcement type, associated companies), which is useful. These go beyond the readOnly/openWorld/idempotent hints.

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 and front-loaded with the action ('List') and subject. It packs essential details—format, default, output fields, and caveat—into four short sentences. While not as terse as a two-sentence ideal, every sentence contributes useful information and there is no redundancy or fluff.

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 optional parameter and no output schema, the description is highly complete. It explains the purpose, the exact date format, the default value, the returned fields, and the best-effort nature of the third-party mirror. This covers all aspects needed for an agent 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 input schema covers 100% of the parameter, including its format and default behavior. The description repeats this same information ('Pass a date as YYYYMMDD... defaults to today') without adding new semantic detail. Thus, the description provides no value beyond the schema, consistent with the baseline score 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 lists Taiwan government procurement tenders published on a given date, with a specific verb ('List') and resource ('tenders'). It also implies differentiation from siblings by focusing on date-based listing, and includes the source (PCC) and the g0v mirror. This distinguishes it from search-by-company or general search tools.

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 context for when to use the tool: to list tenders published on a specific date, with the option and syntax for the date parameter and a default to today. However, it does not explicitly mention alternative tools or provide exclusions, such as 'for keyword search use taiwan_search_tenders', so it lacks explicit when-not guidance.

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

All Taiwan Procurement toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources