open-assembly-mcp 0.2.5

MCP server for Korean National Assembly Open API (open.assembly.go.kr) — bills, members, votes, committee composition, pending bills, plenary agenda, and per-member vote records

open-assembly-mcp

MCP server for the Korean National Assembly Open API (열린국회정보) — query bills, members, vote results, committee composition, pending bills, plenary agenda, and per-member vote records directly from Claude or any MCP-compatible AI client.

---

Quick Start

Prerequisites: Claude Desktop must be installed.

Step 1. Get a free API key at open.assembly.go.kr → Sign up → 마이페이지 → API 키 발급

Step 2. Run the setup wizard:

uvx open-assembly-mcp --setup

It prompts for your key, validates it, and writes the Claude Desktop config automatically.

Step 3. Restart Claude Desktop — the Assembly tools are ready.

---

Usage Examples

Once connected, ask Claude in natural language (Korean or English):

22대 국회에서 발의된 AI 관련 법률안을 찾아줘

반도체특별법의 표결 결과와 공동발의자 명단을 알려줘

Find all housing-related bills in the 22nd Assembly that passed,
and list their lead proposers with party affiliation.

Which members of the 법제사법위원회 proposed the most bills in the 22nd Assembly?

Did any 더불어민주당 members vote against 국민투표법 개정안?

Claude chains the tools automatically and returns a structured summary.

---

Available Tools

All tools return total_count and has_more for transparent pagination.

Coverage by tool (detailed coverage verification planned for a future release):

Tool	Reliable range	Notes
search_bills	16th–22nd	Member-sponsored bills only (no government bills)
get_bill_detail	16th–22nd
get_bill_review	16th–22nd
get_member_info	16th–22nd
get_committee_members	16th–22nd
get_vote_results	19th–22nd recommended	Electronic vote records sparse before 19th Assembly
get_member_votes	18th–22nd recommended	Roll-call data available from ~18th Assembly onward; default page_size=300 fetches all members in one call
get_bill_proposers	16th–22nd	No assembly filter; uses bill ID directly
get_pending_bills	22nd recommended	Bills not yet processed; ~8,900 in the 22nd Assembly
get_plenary_agenda	22nd recommended	Bills scheduled for upcoming plenary session
get_bill_committee_review	16th–22nd	Committee meetings for a specific bill (requires BILL_ID)

Not available via Open API: transcripts, citizen petitions, bill full text (use get_bill_detail → LINK_URL for the official bill page).

---

Updating

uvx caches packages locally. If you installed a previous version, force a reinstall to get the latest:

uvx --reinstall open-assembly-mcp --setup

To update the server used by Claude Desktop, edit your config and change the args line to pin the new version, or leave it as open-assembly-mcp@latest to always pull the latest on startup.

---

Manual Config (alternative to --setup)

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "open-assembly": {
      "command": "uvx",
      "args": ["open-assembly-mcp@latest"],
      "env": {
        "ASSEMBLY_API_KEY": "your-api-key-here"
      }
    }
  }
}

---

Claude Code Setup

claude mcp add open-assembly \
  --command uvx \
  --args "open-assembly-mcp@latest" \
  --env "ASSEMBLY_API_KEY=your-key-here"

---

Why this exists

The Korean National Assembly's 열린국회정보 API provides rich legislative data — every member-sponsored bill since 2000, full member rosters, plenary vote tallies, committee review timelines, and co-sponsor networks. The data is invaluable for political science research, but the traditional retrieval workflow is slow:

Traditional: search site manually → copy data → clean → load into Python/R
             → hours of overhead per research question

With MCP:    ask Claude in one sentence → tools chain automatically → results in seconds

Concrete research use cases:

Task	Tools used
Co-sponsorship network for a policy domain	search_bills + get_bill_proposers
Party-line discipline on a specific vote	get_member_votes (filter by party)
Full legislative career of a single member	search_bills (proposer filter)
Committee composition by party	get_committee_members
Bill timeline from filing to promulgation	get_bill_review + get_bill_detail
Cross-party voting coalitions	get_vote_results + get_member_votes

---

Local Development

git clone https://github.com/kyusik-yang/open-assembly-mcp.git
cd open-assembly-mcp

cp .env.example .env        # add ASSEMBLY_API_KEY=your-key

uv sync --group dev
uv run pytest tests/ -v

# Run the server locally
ASSEMBLY_API_KEY=your-key uv run python -m data_go_mcp.open_assembly.server

---

Changelog

v0.2.5 (2026-03)

• Added 3 new tools: get_pending_bills (계류의안), get_plenary_agenda (본회의부의안건), get_bill_committee_review (위원회 심사 회의정보)
• Fixed get_member_votes default page_size 50 → 300 (covers full ~300-member plenary in one call)
• Improved docstrings: corrected get_vote_results description, added pagination tips to all tools

v0.2.4 (2026-03)

• --setup wizard: ASCII art banner with teal-to-blue gradient, animated validation, polished bilingual prompts

v0.2.3 (2026-03)

• --setup wizard: ANSI colors, box-drawing header, professional bilingual prompts

v0.2.2 (2026-03)

• --setup wizard: bilingual prompts (EN/KR), academic contact info

v0.2.1 (2026-03)

• Added --setup wizard: interactive installer that auto-configures Claude Desktop

v0.2.0 (2026-03)

• Added get_member_votes — per-member roll-call records for any bill
• All tools now return total_count and has_more for transparent pagination
• Added propose_dt_from / propose_dt_to date filter to search_bills
• Extended coverage to 16th and 17th Assemblies

v0.1.0 (2026-02)

• Initial release

---

License

Apache 2.0. See LICENSE.

This project was built following the architecture of Koomook/data-go-mcp-servers. The server structure, packaging conventions, and API client pattern are adapted from that project under the Apache 2.0 license.

Not affiliated with or endorsed by the Korean National Assembly or open.assembly.go.kr.

---

Built with Claude Code — because the best way to make an AI tool for querying a legislature is to have an AI write it.