# Houan Mcp

> Local stdio MCP server for searching Japanese Diet bills (衆参議案情報) and committee Q&A records via the NDL Kokkai API.

- **Type:** MCP server
- **Install:** `agentstack add mcp-shayouworld-houan-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SHAYOUWORLD](https://agentstack.voostack.com/s/shayouworld)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SHAYOUWORLD](https://github.com/SHAYOUWORLD)
- **Source:** https://github.com/SHAYOUWORLD/houan-mcp
- **Website:** https://codeagent.jp/tools/houan-mcp

## Install

```sh
agentstack add mcp-shayouworld-houan-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @codeagentjp/houan-mcp

Local stdio MCP server for searching Japanese **Diet bills (衆参議案情報)** and **committee Q&A records** via the [NDL Kokkai (国会会議録検索システム) API](https://kokkai.ndl.go.jp/).

This server does not call an LLM. It only returns source-backed Diet data, with primary URLs (NDL Kokkai, 衆議院議案情報, 参議院議案情報) so your MCP client (Claude Desktop, Claude Code, Cursor, or any other agent) can cite the original source.

Sister package: [`@codeagentjp/egov-law-mcp`](https://www.npmjs.com/package/@codeagentjp/egov-law-mcp) for current Japanese laws (e-Gov Law Search). `houan-mcp` covers the *legislative process* side: bills under deliberation, committee questionings, and full meeting transcripts.

## Status

MVP. Four tools:

- `find_diet_qa` — full-text search across all Diet committee speeches via the NDL Kokkai API. Filter by date, chamber, committee, speaker.
- `get_meeting_record` — retrieve a single committee's full transcript by `issueID`.
- `search_bills` — search current-session bills in either house by title keyword.
- `get_bill` — retrieve detail of one bill (proceedings timeline, committee assignment, full-text URL).

## Requirements

- Node.js 20 or later
- Network access to `https://kokkai.ndl.go.jp`, `https://www.shugiin.go.jp`, `https://www.sangiin.go.jp`

## Install

From npm:

```json
{
  "mcpServers": {
    "houan": {
      "command": "npx",
      "args": ["-y", "@codeagentjp/houan-mcp"]
    }
  }
}
```

From source:

```bash
git clone https://github.com/SHAYOUWORLD/houan-mcp.git
cd houan-mcp
node bin/houan-mcp.mjs
```

```json
{
  "mcpServers": {
    "houan": {
      "command": "node",
      "args": ["/absolute/path/to/houan-mcp/bin/houan-mcp.mjs"]
    }
  }
}
```

## Tools

### `find_diet_qa`

Full-text search of Diet committee speeches via the NDL Kokkai API.

```json
{
  "keyword": "クロード ミトス",
  "from": "2026-04-01",
  "until": "2026-04-25",
  "chamber": "衆議院",
  "committee": "外務委員会",
  "limit": 5
}
```

Returns matched speeches with speaker, position, committee context, and direct NDL URL.

### `get_meeting_record`

Retrieve a single full transcript by `issueID`.

```json
{
  "issueID": "122103968X00620260410"
}
```

### `search_bills`

Search 衆議院議案情報 / 参議院議案情報 by title keyword.

```json
{
  "keyword": "情報",
  "chamber": "both",
  "session": 221,
  "limit": 20
}
```

### `get_bill`

Retrieve a bill detail page (proceedings timeline, committee assignment, full-text URL). The `proceedingURL` must be a URL returned by `search_bills` — it is validated against the chamber's allowed path prefix before fetching.

```json
{
  "chamber": "shugiin",
  "proceedingURL": "https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/keika/1DE..."
}
```

## Data Sources and Attribution

This package uses three Japanese public sources:

- **NDL Kokkai (国会会議録検索システム)** —  · [API documentation](https://kokkai.ndl.go.jp/api.html). Diet records published 1947–. No auth required. Be a good neighbour: insert short delays between sequential requests, avoid concurrent bursts.
- **衆議院議案情報** — 
- **参議院議案情報** — 

Tool results include the source URL. When you publish or redistribute output based on this package, include an appropriate attribution. Suggested:

> 出典: 国会会議録検索システム (https://kokkai.ndl.go.jp/) / 衆議院議案情報 / 参議院議案情報

## Example: pulling a Mythos Q&A

The 4/10 2026 衆議院外務委員会 questioning by 宇佐美登 (チームみらい) on Anthropic's Claude Mythos Preview can be retrieved like this:

```json
{
  "tool": "find_diet_qa",
  "arguments": {
    "keyword": "クロード",
    "from": "2026-04-01",
    "until": "2026-04-30"
  }
}
```

The response includes 花田貴裕 政府参考人's verbatim answer with `meetingURL` pointing to the canonical NDL record at `https://kokkai.ndl.go.jp/txt/122103968X00620260410`.

## Safety Notes

- This package is a **legislative reference tool, not legal/political advice**.
- It does not execute shell commands.
- It writes JSON-RPC messages only to stdout and logs only to stderr.
- It fetches only the NDL Kokkai API and 衆/参 議案情報 endpoints.
- Diet records in NDL typically appear with a 1–2 week lag after the committee meeting. If a recent meeting cannot be found, check back later or consult the chamber's video library directly.

## Related

- Sibling MCP for current laws: [`@codeagentjp/egov-law-mcp`](https://github.com/SHAYOUWORLD/egov-law-mcp)
- Roadmap (法令diff / 自治体条例 / 判例 MCPs): [SHAYOUWORLD/egov-law-mcp#1](https://github.com/SHAYOUWORLD/egov-law-mcp/issues/1)
- Background article: [codeagent.jp / Tools](https://codeagent.jp/tools/)

## License

[MIT](./LICENSE) © codeagent.jp

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SHAYOUWORLD](https://github.com/SHAYOUWORLD)
- **Source:** [SHAYOUWORLD/houan-mcp](https://github.com/SHAYOUWORLD/houan-mcp)
- **License:** MIT
- **Homepage:** https://codeagent.jp/tools/houan-mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-shayouworld-houan-mcp
- Seller: https://agentstack.voostack.com/s/shayouworld
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.