Legislative Yuan — Claude Code MCP server: use and setup
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.
claude mcp add ly-mcp -- uvx lymcpWhat Legislative Yuan 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.
What it helps with
- 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 for the agent
- 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.
How to install Legislative Yuan
Platform CLI
claude mcp add ly-mcp -- uvx lymcpuvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>
Platform CLI
codex mcp add legislative-yuan -- uvx lymcpuvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add legislative-yuan uvx lymcpuvx runs the command named after the package; if the README names another one, use uvx --from lymcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Legislative Yuan
How do I install Legislative Yuan in Claude Code?
Run claude mcp add ly-mcp -- uvx lymcp. Claude Code will then add the MCP server.
What does Legislative Yuan do?
It gives an agent access to Taiwan Legislative Yuan API v2 for querying bills, laws, meetings, legislators, gazettes, IVOD records, interpellations, and votes.
How does the server handle date-based requests?
It separates latest known records from events that have already occurred and meetings scheduled for later. Choosing the right mode changes which records are considered.
