# Legislative Yuan

This MCP server connects coding agents to Taiwan’s Legislative Yuan API. Use it to look up bills, laws, meetings, legislators, votes, gazettes, and IVOD records.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: narumiruna
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/narumiruna/ly-mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/legislative-yuan

## What it does

Legislative Yuan exposes Taiwan Legislative Yuan API v2 through an MCP server. It provides 42 tools covering bills, committees, meetings, gazettes, interpellations, IVOD videos, laws, legislators, and votes. Successful calls return the upstream JSON payload; failures use a machine-readable JSON error envelope with a failure type and HTTP status.

The server runs with `uvx lymcp` and supports filters such as term, session, date, committee, legislator, law status, and bill category. Several recurring workflows have dedicated MCP prompts, including plenary-meeting bill lookup, law amendment history, legislator proposal records, and vote records.

Date questions need a clear mode: latest known, latest occurred, or next scheduled. Results depend on the Taiwan Legislative Yuan API v2; local development requires Python 3.12+, `uv`, and `just`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ly-mcp -- uvx lymcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add legislative-yuan -- uvx lymcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "legislative-yuan": {
            "command": "uvx",
            "args": [
                "lymcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "legislative-yuan": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "lymcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add legislative-yuan uvx lymcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>

## When to use it
- find bills by term, category, or sponsor
- trace the amendment history of a law
- review a legislator’s proposals and votes
- retrieve meeting records with related IVOD videos
- filter gazettes and their agenda entries

## Example prompts
- List legal bills from term 11 and include their filing dates.
- Trace the amendment history of the Labor Standards Act and link each stage to its bills.
- Show this legislator’s votes in term 11 and report the position recorded for each one.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md