# jp-diet

> Where is a bill in Japan's National Diet now, and how did it get there? For each law bill (cabinet bills and member bills of both houses) from session 142 (1998) to now: submission, committee referral, committee and plenary decisions in each house, enactment and promulgation, or lapse or review while closed at session end, with dates and source URLs. Each observed change is kept with the time observed and the page SHA-256. For enacted bills: which existing laws each one amends and the enforcement dates (including dates set for the future), an enforcement calendar and per-law amendment histories, from e-Gov law search. Facts only; no forecasts. Hosted MCP and HTTP.

Data sources: bill information pages of the House of Representatives (https://www.shugiin.go.jp/internet/itdb_gian.nsf/html/gian/menu.htm) and the House of Councillors (https://www.sangiin.go.jp/japanese/joho1/kousei/gian/) of Japan (facts only; page text not reproduced); revision histories of laws from e-Gov law search (https://laws.e-gov.go.jp/, law API v2, PDL1.0; metadata only, no law text); the cabinet meeting agenda pages of the Prime Minister's Office (https://www.kantei.go.jp/jp/kakugi/index.html, PDL1.0) and the Diet Record Search System API of the National Diet Library (https://kokkai.ndl.go.jp/api.html) for the cabinet decision and the meetings of each bill (read by a scheduled job; the paid dossier reads them again at call time). Processed by MK Career Planning; not official.
Official check: Facts as listed on the bill information pages of the House of Representatives and the House of Councillors, with the time this service observed them. Confirm on the source_urls before relying on them. This service does not predict whether or when a bill will pass.
Status: status is the House of Representatives list value (審議状況) mapped to a code; status_ja is as published. position is read only from the published stages of the current session (for example in_committee = referred to a committee and no committee decision is listed yet). It is not a forecast.
Sessions: Sessions are those listed by the House of Representatives bill information pages (from session 142, 1998). The House of Councillors pages start at session 153 (2001); for earlier sessions only the House of Representatives pages are used, so House of Councillors member bills that never reached the House of Representatives are missing. Past sessions are loaded newest first; coverage says how far each one is loaded.
Observation times: first_observed_at and observed_at are the times this service fetched the page. For bills of past sessions they are when this service loaded its archive (from 2026-11), not when the stage happened; use date for when a stage happened.
Group votes: Parliamentary group names are exactly as published on the House of Representatives bill progress pages (split on ；, surrounding spaces removed). Groups that changed names are not merged. Only House of Representatives plenary votes carry groups for and against on those pages; committee votes and House of Councillors groups are not published there. Group-level public voting facts only: this service does not collect or list votes or speeches of individual members.
Statistics: Past distribution, closed sessions only (bills of the current session are not included). Days = enactment date minus submission date. Submission date: the earliest of submitted / received / received for preliminary examination on the bill pages of the submitted session. Enactment date: the latest plenary decision date in the session whose status is 成立 (not the promulgation date). Bills without both dates are left out (n says how many are in). Enactment share: Closed sessions only: enacted / listed, as a fraction (null while the session is open). The other outcomes of the same denominator are listed next to it (carried_over, withdrawn, not_concluded, rejected, and unconfirmed = other + not_on_hr_list). Every answer carries coverage; past facts only, not a forecast.
Changes: Changes this service observed on the bill pages of both houses, newest first. observed_at is when this service read the page (it reads the current session every 12 to 24 hours), date is the date published for the new stage. First loads (when tracking started, and loading of past sessions) are not counted as changes. Facts only; not a forecast.
Bill ids: submitted session, kind and number (222-閣法-1; also 222-cabinet-1, 221-hr-1, 222-hc-2). A bill carried over to a later session keeps its id; each session's pages are kept separately in the timeline.
Meetings (meetings block of jp_diet_bill_status): Diet meetings whose record in the National Diet Library's Diet Record Search System API contains the bill title, from the bill's first recorded date (search_from), newest first, up to 20 meetings from the first 30 matching records (truncated says when more may exist). relation stage_on_same_day: this bill's timeline lists a stage in the same house on the meeting date (for example a committee or plenary decision); title_mentioned: the title appears in the record, which may be only a mention. Meeting-level data and links only: no speech text, excerpts or speaker names (Copyright Act art. 40(1)). Read by this service's scheduled job, not at request time; retrieved_at says when.
Cabinet decision (cabinet_decision block of jp_diet_bill_status): Cabinet decision of a cabinet bill (閣法): the cabinet meeting agenda pages of the Prime Minister's Office within 14 days before submission whose law bill item has the same title. The cabinet meeting list this service reads covers the current year only; earlier years are not_checked (not a statement that there was no decision). Read by this service's scheduled job, not at request time.
Paid dossier: Meeting records: metadata and links from the Diet Record Search System API of the National Diet Library (https://kokkai.ndl.go.jp/api.html). Speech copyright belongs to the speakers; this service returns only meeting-level information, links and an excerpt of up to 200 characters around the bill title, and never lists speeches by speaker.
Enforcement dates (jp_diet_enforcement_calendar, jp_diet_law_history, the enforcement block of jp_diet_bill_status): Enforcement dates are as listed in the revision history of e-Gov law search (Digital Agency). A future date is the date the law or a cabinet order sets, as recorded by e-Gov; it is not this service's estimate. egov_provisional_date is e-Gov's placeholder (amendment_scheduled_enforcement_date) and may not be the actual date; read enforcement_comment. e-Gov keeps revision histories mostly from 2016-2017 on, so older amendments may be missing.
e-Gov: Source: e-Gov law search (https://laws.e-gov.go.jp/), Digital Agency of Japan, reused under the Public Data License 1.0 (PDL1.0). Processed by MK Career Planning (law numbers normalized, revisions grouped by amending law, matched to Diet bills, dates sorted); not made by the government. No law text is stored or returned.
Disclaimer: Facts compiled from public pages of the National Diet, the Prime Minister's Office, the National Diet Library and e-Gov (Digital Agency), with the time this service observed them. Not legal or investment advice. No prediction of whether a bill will pass. Not affiliated with the National Diet or the Cabinet.
免責：国会・首相官邸・国立国会図書館・e-Gov（デジタル庁）の公開のページから集めた事実と、このサービスが観測した時刻です。法律・投資の助言ではありません。成立の見込みは示しません。国会・内閣とは関係がありません。

## Privacy at a glance

- No account, no email, no API key. Free tools need nothing but the call.
- Free tools: we do not store your inputs (for example the number or name you looked up) in our database (except as noted below), and we do not keep Cloudflare's request logs, so your IP address and User-Agent are not logged by us. Usage is counted only as daily totals.
- This server takes no payments.
- This service has its own data notes (for example what it passes to another source or keeps as a hash): see section 1 of the Privacy Policy.
- Details and exceptions (short error logs kept up to 7 days, Cloudflare's own processing): https://jp-diet-production.mk-career-planning.workers.dev/privacy

## Connect

- MCP (streamable HTTP): https://jp-diet-production.mk-career-planning.workers.dev/mcp
- OpenAPI: https://jp-diet-production.mk-career-planning.workers.dev/openapi.json
- x402 discovery: https://jp-diet-production.mk-career-planning.workers.dev/.well-known/x402

## Free tools

- catalog: List the tools of this server with prices, data sources, licensing, daily limits and data freshness.
- jp_diet_bills_list: List the law bills of a Diet session (default: current; past sessions from 142 (1998) as loaded, see jp_diet_sessions_list; 閣法 = cabinet bills, 衆法/参法 = member bills of the House of Representatives/Councillors) with where each is now: status as published (審議状況, e.g. 成立 = enacted), a status code, the position read from published stages (e.g. in_committee), latest stage date and source URLs. Filters: session, house, kind, status, title words. Free.
- jp_diet_sessions_list: Which Diet sessions does this service hold bill records for? Returns every session the House of Representatives bill pages list (from 142, 1998), newest first: number, type (常会 ordinary, 臨時会 extraordinary, 特別会 special), start and end dates, number of law bills, and how far it is loaded (coverage complete, partial or not_loaded; past sessions are loaded newest first). Free.
- jp_diet_bill_status: Where is this Diet bill now and how did it get there? Give bill_id (e.g. 222-閣法-1 or 222-cabinet-1) or a title. Returns status, position and the timeline per session and house (referral, committee and plenary decisions, promulgation), each with date, source URL and first observed time; the Diet meetings that dealt with the bill (house, meeting, date, official record link); for cabinet bills the cabinet decision date and page. Each block has a status. Free.
- jp_diet_group_votes: How did each parliamentary group (会派) vote on the law bills of a Diet session? From the House of Representatives bill progress pages: for each bill with a plenary vote, the groups for and against as published (names exactly as published, not merged across renames), a bills x groups table, and pairwise agreement between groups (share of bills where both were on the same side, with n). Group-level public votes only; no individual members. Free.
- jp_diet_stats: Counts of law bills per Diet session and kind (cabinet / member bills): listed, newly submitted, carried in, enacted, withdrawn, not concluded, carried over, rejected, enactment share of closed sessions; days from submission to enactment (median, p25, p75, n); by committee. This service's own aggregation of the bill pages it has loaded, always with coverage (which sessions are complete or still loading). Past facts only, not a forecast. Free.
- jp_diet_changes: Which Diet bills moved since a date? Changes this service observed on the bill pages of both houses, newest first: bill id and title, from-stage and to-stage (or list status before and after), the published date of the new stage, when observed, and the source URL. First loads and loading of past sessions are not counted. Free.
- jp_diet_enforcement_calendar: Which Japanese laws change on which dates? Enforcement dates of amendments, new laws and repeals made by Acts between two dates (Japan time; default the next 365 days; the last year also works): law changed (e-Gov id, title, number, category), amending law number and title, promulgation date, date and its basis, e-Gov's note on the provision, e-Gov link, and the Diet bill id when known. From e-Gov law search (PDL1.0). Facts only. Free.
- jp_diet_law_history: How has this Japanese law been changed, by which Acts, and from when? Give an e-Gov law id (e.g. 322AC0000000049 = 労働基準法). Returns amendments by Acts since 1998 that e-Gov's revision history lists (mostly from 2016-2017 on), newest first: amending law number and title, promulgation date, each enforcement stage with its date (future included) and e-Gov's note, e-Gov link, and the Diet bill id when known. No law text. Free.
- get_receipt: Re-fetch the stored result of a settled paid call by its receipt_id, for when the response was lost after payment. Free. Unknown or unsettled receipt ids return RECEIPT_NOT_FOUND. Results are kept for 30 days after settlement.
- HTTP: GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/bills, GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/sessions, GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/bill, GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/groups, GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/stats, GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/changes, GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/enforcement, GET https://jp-diet-production.mk-career-planning.workers.dev/v1/diet/law return the same data as the MCP tools. GET https://jp-diet-production.mk-career-planning.workers.dev/v1/receipts/<receipt_id> is get_receipt.

## Payments

This server offers free tools only. It does not request or accept x402 payments.

## Rate limits

- Free calls (free HTTP endpoints under /v1/ and free MCP tools) are limited to 300 requests per 60 seconds per client (a client is keyed by a one-way hash of its IP address and the first 64 characters of its User-Agent; neither is stored. The User-Agent can be set by anyone, so this split is for fairness between clients behind a shared gateway, not a security control). Over the limit, HTTP returns 429 RATE_LIMITED with a Retry-After header and MCP tools return the error RATE_LIMITED. Paid calls are not rate limited.

## Provenance and fetch_status

Responses carry provenance[] (source, upstream_updated_at, retrieved_at, content_sha256, parser_version, fetch_status). fetch_status values:

- found: The upstream document was retrieved and contains the data used for this answer.
- empty: The upstream was retrieved, but it has no item for this query (for example JMA had no bulletin for that area in its feeds, or the municipality is not in the list). The state is unknown: empty does NOT mean 'none in effect'.
- stale: The data was retrieved but is older than the freshness threshold for its kind; treat it with care.
- unavailable: The upstream could not be retrieved, read or used (network error, withdrawn bulletin, paused source, or data not yet loaded).
- unsupported: The query is outside what this source covers (for example a date JMA does not issue warnings for yet, or a period before the source's records).

## Errors

- RECEIPT_NOT_FOUND (get_receipt)
- RATE_LIMITED (free calls over the per-client limit; HTTP 429 with Retry-After; not charged)

## Terms

- Fresh: the current session's House of Representatives bill list was read within 36 hours; otherwise source.freshness says stale.
- Keep the attribution (sources, 'processed by MK Career Planning, not official', for cabinet entries the PDL1.0 source line with the page URL, and for enforcement data the line 出典：e-Gov法令検索（https://laws.e-gov.go.jp/） with the processing note) when you pass results on.
- jp_diet_bill_dossier: 1.00 USD per call (USDC on Base via x402), one bill per call; not charged when no single bill matches.

## Privacy and support

- Operator: MK Career Planning
- Terms of Service: https://jp-diet-production.mk-career-planning.workers.dev/terms
- Privacy policy: https://jp-diet-production.mk-career-planning.workers.dev/privacy
- Support (free): https://jp-diet-production.mk-career-planning.workers.dev/support (mk.career.planning@gmail.com)