TW-Market Live Data Intelligence MCP server

TW-Market Live Data Intelligence

English | 繁體中文

Local-first, governed Taiwan-market evidence for an operator and an AI

assistant — validate first, preview bounded work, then explicitly authorize

one execution where the capability permits it.

ProductVersion = 1.0.0. The current stable release is v1.0.0 (GitHub Release). The published prerelease history is v1.0.0-rc.1 (GitHub Release), and the earlier stable GitHub Release was v0.1.0. The current development line now uses Unified Request/Result/Audit V3 as the preferred authority while retaining V1/V2 compatibility. Phase G G1/G2 runtime capabilities have passed bounded controlled-live acceptance; Phase H has one active TPEx attention route; broader Roadmap Phase G/H scope remains explicitly incomplete. This is a local-first evidence workbench, not a realtime trading product.

Why TW-Market

AI discussion needs evidence with identity, source, timestamp, caveat, and execution provenance — not an unqualified price claim. This workbench gives a human operator a governed local path from request validation to an AI-ready handoff, while retaining a separate audit package.

Quick start

git clone https://github.com/SmartyJohnway/tw-market-live-data-intelligence.git
cd tw-market-live-data-intelligence
python -m venv .venv
# Activate .venv using your shell, then:
python -m pip install -r requirements-lock.txt
python scripts/verify_environment.py
python scripts/manage_security_master.py status

NOT_INITIALIZED is the normal fresh-install state. A Security Master update is an explicit operator action and may use official external acquisition:

python scripts/manage_security_master.py update --live
python scripts/run_unified_workbench.py

Open the loopback Workbench at /workbench/. For an MCP host, start the separate stdio launcher:

python scripts/run_unified_market_evidence_mcp.py

A governed 2330 workflow

preview is executable.

1. Create or select an installation-local Watchlist, then add 2330.
2. Compose a Unified Market Evidence Request and validate its identity.
3. Preview the planned operation and its capability boundary.
4. Explicitly authorize and confirm one bounded execution only when the

handoff for continued discussion.

1. Read the canonical Result and Audit Package, or export the AI-ready

Core capabilities

installation-local Taiwan Market Identity Service.

• Identity-aware requests: Mode A validates targets against the

one request only when its governed capability is executable.

• Bounded execution: Mode B previews, explicitly authorizes, and executes

Package, and AI-ready Markdown without dispatching another market source.

• Auditable handoff: Mode C creates a canonical Result, separate Audit

revisions, optimistic concurrency, and explicit preview/commit mutation.

• Persistent Watchlists are supported: installation-local Watchlists have immutable

latest completed official material-disclosure batch and latest available monthly revenue (TWD, unit thousand), using official CSV with an explicit governed official JSON fallback.

• Official research evidence: eligible TWSE/TPEX common shares support the

Unified MCP

The MCP surface has exactly six governed tools:

marketdescribecapabilities, marketvalidaterequest, marketpreviewrequest, marketreadresult, marketexportaihandoff, and marketfetch_evidence.

Shortened. The full README is on GitHub.