# TW-Market Live Data Intelligence **Category:** πŸ’» Developer Tools **Repository:** https://github.com/SmartyJohnway/tw-market-live-data-intelligence **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/tw-market-live-data-intelligence ## Description Local-first Taiwan market evidence for AI agents: Watchlists, governed MCP, audited execute-once. ## Claude Desktop Quick Installation Heuristic fallback β€” verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low): ```json "mcpServers": { "tw-market-live-data-intelligence": { "command": "npx", "args": ["-y","tw-market-live-data-intelligence"] } } ``` ## Documentation & README # TW-Market Live Data Intelligence [English](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/README.md) | [繁體中文](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/README.zh-TW.md) > 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. ![Deterministic Unified Workbench overview](https://raw.githubusercontent.com/SmartyJohnway/tw-market-live-data-intelligence/HEAD/docs/assets/workbench-overview.png) ProductVersion = `1.0.0`. The current stable release is `v1.0.0` ([GitHub Release](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/releases/tag/v1.0.0)). The published prerelease history is `v1.0.0-rc.1` ([GitHub Release](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/releases/tag/v1.0.0-rc.1)), 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 ```bash 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: ```bash python scripts/manage_security_master.py update --live python scripts/run_unified_workbench.py ``` Open the loopback Workbench at [`/workbench/`](http://127.0.0.1:8000/workbench/). For an MCP host, start the separate stdio launcher: ```bash python scripts/run_unified_market_evidence_mcp.py ``` ## A governed 2330 workflow 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 preview is executable. 5. Read the canonical Result and Audit Package, or export the AI-ready handoff for continued discussion. ## Core capabilities - **Identity-aware requests:** Mode A validates targets against the installation-local Taiwan Market Identity Service. - **Bounded execution:** Mode B previews, explicitly authorizes, and executes one request only when its governed capability is executable. - **Auditable handoff:** Mode C creates a canonical Result, separate Audit Package, and AI-ready Markdown without dispatching another market source. - **Persistent Watchlists are supported:** installation-local Watchlists have immutable revisions, optimistic concurrency, and explicit preview/commit mutation. - **Official research evidence:** eligible TWSE/TPEX common shares support the latest completed official material-disclosure batch and latest available monthly revenue (TWD, unit thousand), using official CSV with an explicit governed official JSON fallback. ## Unified MCP The MCP surface has exactly six governed tools: `market_describe_capabilities`, `market_validate_request`, `market_preview_request`, `market_read_result`, `market_export_ai_handoff`, and `market_fetch_evidence`. Request v3 is preferred; Request v1 and v2 remain accepted compatibility contracts. New governed materializations default to Result v3 and Audit Package v3, while historical V1/V2/V3 packages remain readable without rewriting. See the [V1 historical public contracts](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/contracts/V1_PUBLIC_CONTRACTS.md) and [current AI usage guide](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/agent_usage_guide.md) for request, result, and handoff semantics. ## MCP distribution The supported Windows MCPB distribution is published with [`v1.0.0`](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/releases/tag/v1.0.0): [download the MCPB](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/releases/download/v1.0.0/tw-market-unified-mcp-v1.0.0-win-x64.mcpb) and its [SHA-256 sidecar](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/releases/download/v1.0.0/tw-market-unified-mcp-v1.0.0-win-x64.mcpb.sha256). It uses local stdio transport and provides the same six tools. The [official Registry entry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.SmartyJohnway/tw-market-live-data-intelligence) is `io.github.SmartyJohnway/tw-market-live-data-intelligence`. See [MCP distribution](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/distribution/MCP_DISTRIBUTION.md) for installation scope, integrity, and Security Master boundaries. ## Data and source caveats Capability support, currentness, source provenance, and execution eligibility are explicit product data. A supported identity does not imply an executable source route; a preview is not an authorization; a source observation is not a realtime guarantee. Research support does not provide arbitrary disclosure or monthly-revenue history, realtime disclosures, or `financial_summary`. Consult the [capability matrix](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/reference/CAPABILITY_MATRIX.md), [source matrix](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/reference/SOURCE_MATRIX.md), and [governance boundaries](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/reference/GOVERNANCE_BOUNDARIES.md) before relying on any result. ## Safety and non-goals There is no automatic polling, scheduler, startup market fetch, Watchlist-driven automatic execution, trading, order routing, full-market scan, model-selected URL/executor, or realtime guarantee. Persistent Watchlists mutate only through explicit preview/commit. Never commit credentials, tokens, cookies, or private market payloads. ## Documentation Repository governance front door: - [PROJECT.md](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/PROJECT.md) β€” current project/product authority - [ROADMAP.md](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/ROADMAP.md) β€” canonical Roadmap V3.2 - [HANDOFF.md](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/HANDOFF.md) β€” current operational handoff - [AGENTS.md](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/AGENTS.md) β€” AI/repository collaboration rules Product documentation: - [Operator quick start](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/operator/QUICK_START.md) - [Local Workbench guide](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/operator/LOCAL_WORKBENCH.md) - [Troubleshooting](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/operator/TROUBLESHOOTING.md) - [Documentation index](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/INDEX.md) - [V1 release](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/release/V1_RELEASE.md) - [Changelog](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/CHANGELOG.md) ## Contributing and security Read [CONTRIBUTING.md](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/CONTRIBUTING.md) before opening a pull request. Report security concerns using the grounded guidance in [SECURITY.md](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/SECURITY.md). ## Release status `VERSION` records `1.0.0`. The current stable release is `v1.0.0` ([GitHub Release](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/releases/tag/v1.0.0)); published prerelease history remains `v1.0.0-rc.1`. The current development line has progressed through accepted Phase G G1/G2 runtime work and H-ACT-V3 preferred-authority promotion; this does not retag or rewrite the immutable `v1.0.0` release. Roadmap Phase G/H completion remains a broader scope question tracked separately in [ROADMAP.md](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/ROADMAP.md). Both release tags are immutable authorities; subsequent documentation status updates do not move them. ## Project Overview This root README is the current product entry point. Engineering history, protocol acceptance, and prior M5/M6/M8 architecture remain available through [Project History](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/PROJECT_HISTORY.md), the [Engineering history / protocol archive](docs/INDEX.md#engineering-history--protocol-archive), and [`docs/archive/`](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/archive/), including the [`2026-06-30 historical README`](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/docs/archive/readme/README_20260630_M5LRM_ARCHITECTURE_CONVERGENCE.md). They are retained for audit and compatibility, not as a second current-product contract. ## License See [LICENSE](https://github.com/SmartyJohnway/tw-market-live-data-intelligence/blob/HEAD/LICENSE).