Ly

You can access Taiwan’s Legislative Yuan API data through a dedicated MCP server that exposes bills, committees, gazettes, meetings, interpellations, and more. This server consolidates many endpoints into a single, convenient interface you can query with a compatible MCP client to build powerful data workflows and tooling.

How to use

You will run the MCP server locally or connect to a remote instance using a compatible MCP client. Once connected, you can navigate the available tools to list entities (bills, committees, gazettes, laws, meetings, legislators, IVODs, interpellations) and fetch detailed information for specific items. Use the client’s standard MCP call patterns to request lists, retrieve full records, or drill into related data such as bill deliberations, gazette agendas, and IVOD transcripts. This enables you to build dashboards, automate data collection, or integrate with your own analysis pipelines.

How to install

Prerequisites you need before installation are Node tooling and a suitable MCP client environment. Install and run the MCP server using one of the supported approaches shown below.

End-user setup snippets

{
  "mcpServers": {
    "lymcp": {
      "command": "uvx",
      "args": ["lymcp@latest"]
    }
  }
}

Another local development option

{
  "mcpServers": {
    "lymcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/ly-mcp",
        "lymcp"
      ]
    }
  }
}

Docker option

{
  "mcpServers": {
    "lymcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "narumi/ly-mcp:latest"
      ]
    }
  }
}

Setup with a client (examples)

Add the server configuration to your MCP client configuration. Use the same command pattern in your client to reference the MCP server you run or connect to.

Notes on development and testing

Development and testing require Python 3.12+ and the uv package manager. You can run the full test suite with coverage or run tests directly with verbose output. Linting and type checking are available to maintain code quality.

Available tools

get_stat

Get Legislative Yuan API statistics and overview information.

list_bills

List bills with optional filters by term, session, category, proposer, and other criteria.

get_bill

Get comprehensive information about specific bills, returning the complete JSON.

get_bill_related_bills

Query related bills and their associations.

get_bill_meets

Access bill deliberation records from various meetings.

get_bill_doc_html

Retrieve HTML document content for specific bills.

list_committees

List Legislative Yuan committees with optional filters.

get_committee

Get detailed information about specific committees.

get_committee_meets

Access committee meeting records and proceedings.

list_gazettes

List Legislative Yuan gazettes with optional filters by volume and gazette ID.

get_gazette

Get detailed information about specific gazettes.

get_gazette_agendas

Get agendas/contents from specific gazettes.

list_gazette_agendas

List all gazette agendas with optional filters by term, meeting date, etc.

get_gazette_agenda

Get detailed information about specific gazette agenda items.

list_interpellations

List interpellations with optional filters by member, term, session, and meeting code.

get_interpellation

Get detailed information about specific interpellations.

get_legislator_interpellations

Get interpellations where a specific legislator is the questioning member.

list_ivods

List IVOD recordings with optional filters by term, session, committee, member, and video type.

get_ivod

Get detailed information about specific IVOD recordings, including video URLs, transcripts, and gazette content.

get_meet_ivods

Get IVOD recordings related to specific meetings.

list_laws

List laws with optional filters by law number, category, parent number, status, and authority.

get_law

Get comprehensive information about specific laws including basic data, articles, and version information.

get_law_progress

Get undecided progress list for specific laws.

get_law_bills

Get bills related to specific laws with optional filters.

get_law_versions

Get historical version records for specific laws including changes and proposers.

list_law_contents

List law articles/contents with optional filters by law number, version ID, article number, and status.

get_law_content

Get detailed information about specific law articles/contents using content ID.

list_meets

List Legislative Yuan meetings with optional filters by term, session, meeting type, attendees, date, committee code, and meeting ID.

get_meet

Get detailed information about specific meetings using meeting ID/code.

get_meet_ivods

Get IVOD recordings related to specific meetings with optional filters.

get_meet_bills

Get bills discussed in specific meetings with optional filters by bill criteria.

get_meet_interpellations

Get interpellations that occurred in specific meetings with optional filters.

list_legislators

List legislators with optional filters by term, party, district name, legislator ID, and name.

get_legislator

Get detailed information about specific legislators by term and name.

get_legislator_propose_bills

Get bills proposed by a specific legislator with optional filters by bill criteria.

get_legislator_cosign_bills

Get bills co-signed by a specific legislator with optional filters by bill criteria.

get_legislator_meets

Get meetings attended by a specific legislator with optional filters by meeting criteria.

get_legislator_interpellations

Get interpellations made by a specific legislator with optional filters.