Log inSubmit server
Legislative Yuan logo

Legislative Yuan

Queries Taiwan Legislative Yuan API v2 for bills, laws, meetings, legislators, gazettes, videos, interpellations, and votes.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Legislative Yuan

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "legislative-yuan": {
      "command": "uvx",
      "args": [
        "lymcp@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Legislative Yuan MCP server connects AI agents to Taiwan’s Legislative Yuan API v2 for querying legislative and parliamentary records. It exposes 42 tools covering bills, laws, committee activity, meetings, legislators, gazettes, interpellations, IVOD videos, and votes. Responses return the upstream API’s JSON payload, while failures use structured JSON error envelopes. Reach for it when an agent needs to research Taiwanese legislative proceedings, amendment histories, voting records, or parliamentary documents.

Use cases

  • Research Taiwanese bill histories and related proposals
  • Track law amendment versions and article contents
  • Find committee and plenary meeting records
  • Review legislator proposals, interpellations, and votes
  • Retrieve gazette agendas and IVOD transcripts

Key features

  • 42 tools across 10 legislative data areas
  • Filterable bills, laws, meetings, legislators, and votes
  • Law versions and article-content lookup
  • Gazette, agenda, IVOD, and transcript retrieval
  • Structured JSON responses and error envelopes
  • Workflow prompts and query-semantics resources

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · lymcp@latest (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
Last commit3d agoMost recent push to the default branch.

How Legislative Yuan works

What the Legislative Yuan MCP server does

The Legislative Yuan MCP server gives MCP-compatible agents access to data from Taiwan’s Legislative Yuan API v2 at ly.govapi.tw/v2. It is intended for research and retrieval workflows involving legislative records rather than general legal advice or document authoring.

The available data covers bills, committees, gazettes, interpellations, IVOD online television records, laws, meetings, legislators, and votes. Queries can commonly be narrowed by term, session, meeting, committee, legislator, date, bill type, law status, voting position, or other API fields described by each tool.

How it works

The server translates MCP tool calls into requests to the upstream Legislative Yuan API. Successful calls return the API’s original JSON payload, which lets an agent inspect the source fields directly. Failed calls return a machine-readable envelope containing an error type, message, URL, and, where available, HTTP status and response excerpt.

Supported error categories include HTTP failures, timeouts, network errors, invalid JSON, and unexpected errors. The project also provides workflow-oriented MCP prompts for recent plenary meeting bills, law amendment history, legislator proposal records, legislator interpellations, committee meeting lookups, and legislator voting records. The lymcp://query-semantics and lymcp://workflow-reference resources document date meanings, filters, identifiers, and workflow steps.

Setup and configuration

The Legislative Yuan MCP server can run through uvx:

bash
uvx lymcp@latest

For a client configuration, use the lymcp command through uvx, install from the Git repository with --from, run the local checkout with uv, or launch the published Docker image narumi/ly-mcp:latest. The README gives an MCP configuration example for Claude Desktop. Local development requires Python 3.12 or newer, uv, and just.

The package also includes a ly terminal command. It supports pretty or compact JSON, writing results to a file, and passing output-field selections to the upstream API. Examples include ly bills list, ly laws versions, ly meets bills, ly legislators propose-bills, and ly votes get.

Tools and capabilities

The 42 tools are organized into these areas:

  • Statistics and API overview information.
  • Bill lists, details, related bills, meeting records, and HTML documents.
  • Committee records and committee meeting content.
  • Gazette records and agenda entries.
  • Interpellation records by legislator, term, session, or meeting.
  • IVOD listings, video details, transcripts, and meeting-related videos.
  • Laws, amendment progress, related bills, historical versions, and article contents.
  • Meetings, associated bills, interpellations, and IVOD records.
  • Legislator details, proposals, cosigned bills, attendance, and interpellations.
  • Vote listings, full vote details, and related meetings.

Limitations and notes

The server depends on the availability and response format of the upstream Taiwan Legislative Yuan API v2. Results are returned as source JSON rather than normalized into a separate schema. Date-based questions require distinguishing between the latest known record, the latest record that has already occurred, and the next scheduled record; scheduled future entries may appear when using the upstream default ordering.

Running live tests makes requests to the upstream API. No authentication variable or other required environment variable is documented for normal operation.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Legislative Yuan

Legislative Yuan is an MCP server that connects AI agents to Taiwan’s Legislative Yuan API v2. Its main tools query bills, laws, meetings, committees, legislators, gazettes, interpellations, IVOD videos, and votes, returning the upstream API’s JSON data or a structured error response.

Install it with `uvx lymcp@latest`. You can also configure an MCP client to run the package from PyPI, a Git checkout, a local development directory, or the published Docker image.

Yes, Legislative Yuan works with Claude Desktop through a standard MCP configuration.

Yes, it can query law amendment history through law version tools. You can retrieve versions, amendment details, proposing legislators, progress information, version contents, and individual article contents.

No API key or required environment variable is documented for normal operation. The server reads data from the public Taiwan Legislative Yuan API v2 endpoint specified by the project.

Related MCP servers

All in Legal All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewLegislative Yuan AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/legislative-yuan?style=directory)](https://allmcps.com/mcp/legislative-yuan)
HTML Embed
<a href="https://allmcps.com/mcp/legislative-yuan"><img src="https://allmcps.com/api/badge/legislative-yuan?style=directory" alt="Legislative Yuan on AllMCPs" /></a>