knesset-mcp
It is an MCP server for querying the Israeli Knesset's open data (bills, laws, MKs, parties, committees, sessions, votes, and more) using prebuilt shortcuts or generic OData access.
Find and profile people:
find_personlocates MKs/ministers by Hebrew name;get_personreturns their full role history, factions, committee roles, and bill counts.Search and inspect bills:
search_billsfilters by name, Knesset, status, type, or initiator;get_billgives the full story — status, sponsors, name changes, merges, sessions, votes, and documents.Explore votes:
get_voteshows one plenum vote's totals, faction breakdown, and how each MK voted;get_person_voteslists an MK's votes with context for what "for"/"against" meant.Get sessions:
get_sessionretrieves plenum sittings or committee meetings with agenda, documents, protocols, and votes.Query any table generically:
list_tables,describe_table,query, andget_recordprovide access to every Knesset OData table with filtering, sorting, expanding related records, and paging.No API key needed: the server handles API quirks such as paging limits, firewall restrictions, Hebrew text, and join keys automatically.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@knesset-mcp search for bills sponsored by איימן עודה"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
knesset-mcp
An MCP server for the Israeli Knesset's open data: bills, laws, regulations, MKs, parties, committees, plenum sessions, votes and parliamentary questions. It covers every table in the Knesset's OData v4 API, including per-MK plenum votes. No API key is needed.
Tools
Shortcuts for common questions, each one call that does the joins for you:
Tool | Answers |
| Who is this MK? Returns their Id, latest faction and Knessets served. |
| Every role someone held: MK, faction, minister, committee roles, plus bill counts. |
| Bills by Hebrew name, Knesset, status, type (government/private/committee) or sponsor. |
| One bill: status, sponsors, name history, merges, committee and plenum sessions, votes, documents. |
| One plenum vote: totals, breakdown by faction, and who voted how. |
| How one MK voted, newest first, with what each vote was about and what "for" meant on it. |
| One plenum sitting or committee meeting: agenda, documents and protocols, votes. |
Generic access to every table:
Tool | Does |
| All tables grouped by topic, with what each holds. |
| Fields, types, links usable in |
| Any OData query ( |
| One record by Id. |
All data is in Hebrew, so search with Hebrew terms. Tools that take names reject Latin text and ask for the Hebrew form.
Related MCP server: Knesset MCP Server
Setup
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'Add to Claude Code (stdio):
claude mcp add knesset -- /absolute/path/to/knesset-mcp/.venv/bin/knesset-mcpRun as an HTTP service (for remote clients, or a claude.ai custom connector once hosted):
.venv/bin/knesset-mcp --transport streamable-http --host 0.0.0.0 --port 8000The endpoint is http://<host>:8000/mcp.
Tests
.venv/bin/pytest # offline unit tests
.venv/bin/pytest -m live # end-to-end against knesset.gov.ilAPI quirks this server handles
Checked against the live API on 2026-09-23:
Paging: the API returns 100 rows per page plus a
@odata.nextLink. The server follows it, up to 200 rows per tool call, and returnsnext_skipwhen more exist.Firewall: knesset.gov.il's firewall rejects any query containing
;and any$applywithaggregate(), answering with an HTML "access denied" page. Both are refused locally with an explanation. Vote tallies are counted in the server instead.$expandon single records (KNS_Bill(123)?$expand=...) returns HTTP 500. Records are always fetched asKNS_Bill?$filter=Id eq 123, where expand works.Table and type names differ in places (the set
KNS_DocumentQueriehas the typeKNS_DocumentQuery). The schema is read live from$metadata, so this is handled.Broken tables:
V_Lobbyists,V_LobbyistsClientsandKNS_DocumentQuerieare listed but return 404, andKNS_DocumentIsraelLawis empty.A bare "for" or "against" is meaningless: voting against "to accept the reservation" is not voting against the law. Every ballot
get_person_votesreturns carriesForMeansandAgainstMeansfrom the vote itself.Joins never stop at one page: internally,
fetch_allpages through every matching row (up to 2,000) and logs a warning if it hits that ceiling, instead of silently returning 200.Join keys that aren't obvious:
KNS_PlenumVoteResult.MkId=KNS_Person.Id, andItemIDon votes and agenda items is theKNS_Bill.Idwhen the item is a bill.Responses are cached in memory for an hour, and the schema for a day.
Not yet covered
Reading document contents. Tools return links to .pdf/.doc files, including protocols, but don't extract their text.
Analytics across many records, such as how often an MK voted against their party. Each call reads at most 200 rows. That needs a local mirror of the data.
Available Tools
11 toolsdescribe_tableARead-onlyIdempotent
Show a table's fields and types, its links to other tables (usable in $expand), and optionally one example row, so you can write a correct query.
Inputs: table (required), include_sample.
find_personARead-onlyIdempotent
Find MKs and ministers by Hebrew name. Returns each match's Id (use it with get_person, get_person_votes, search_bills), latest faction and the Knessets they served in.
Inputs: name (required), current_only.
get_billARead-onlyIdempotent
Everything about one bill: details and status, initiators, name changes, merges and splits, committee and plenum sessions that discussed it, plenum votes on it (pass a vote Id to get_vote for how each MK and party voted), and document links.
Inputs: bill_id (required).
get_personBRead-onlyIdempotent
A person's profile: every role they held over time (MK and faction, minister, deputy minister, committee roles) plus how many bills they initiated.
Inputs: person_id (required), knesset_num.
get_person_votesARead-onlyIdempotent
How one MK voted in the plenum, newest first, with what each vote was about. Pass a VoteID to get_vote to see how everyone else voted.
Inputs: person_id (required), top, skip, since, +1 more.
get_recordARead-onlyIdempotent
Fetch one record from any table by its Id, optionally with linked records.
Inputs: id (required), table (required), expand.
get_sessionARead-onlyIdempotent
One plenum sitting or committee meeting: when, which committee, the agenda items, documents (including protocols), and for plenum sittings the votes held.
Inputs: kind (required), session_id (required).
get_voteBRead-onlyIdempotent
One plenum vote: what was voted on, the totals, the breakdown by faction, and the names of the MKs behind each result.
Inputs: vote_id (required).
list_tablesARead-onlyIdempotent
List every Knesset table, grouped by topic, with what each one holds.
Use this to find the right table before describe_table and query.
Inputs: no named parameters.
queryARead-onlyIdempotent
Query any Knesset table with OData v4 options. Returns up to 200 rows per call; when more exist the result includes next_skip. Text fields are Hebrew.
Example: table=KNS_CommitteeSession, filter="CommitteeID eq 4191 and StartDate ge 2026-01-01T00:00:00Z", orderby="StartDate desc", expand="KNS_CmtSessionItem($select=Name)".
Inputs: table (required), top, skip, count, +4 more.
search_billsARead-onlyIdempotent
Search bills by name, Knesset, status, type or initiator. Newest Knesset first. Each result includes its status in words; use get_bill for the full story of one bill.
Inputs: top, skip, text, bill_type, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct entity or operation: table discovery, generic querying, people, bills, votes, and sessions are clearly separated. Even generic get_record is distinguishable from get_person/get_bill by its purpose as a raw record fetch.
Most tools follow a clear verb_noun pattern: list_tables, describe_table, find_person, get_person, search_bills, get_bill, get_vote, get_session. The bare 'query' tool is a minor outlier, but the overall convention is still predictable.
With 11 tools, the server is well-scoped for a Knesset data domain. Each tool covers a meaningful operation without redundancy or bloat.
The tool set covers the full read-only lifecycle: table discovery and schema inspection, generic querying, person profiles and voting records, bill search and detail, plenum votes, and sessions. The generic query and get_record tools also prevent dead ends for entities without dedicated endpoints.
Maintenance
Related MCP Connectors
Free read-only Israeli election, polling and dated CBS population data in four languages.
Access U.S. congressional data (bills, votes, members, committees) via MCP.
Live Israeli public data for AI agents: alerts, prices, open data, FX rates, Shabbat times.
Israel Government Procurement MCP — public tenders & exemption contracts (keyless).
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides access to Israel's OpenBudget API, allowing users to query and search various government budget datasets including budget items, contracts, and support payments.12-
- AlicenseAqualityDmaintenanceEnables AI assistants to query bills, committees, and members from the Israeli Knesset parliamentary information API via MCP tools.99 npm3MIT
- AlicenseAqualityBmaintenanceEnables searching and retrieving metadata of Israeli primary legislation via the Knesset's official OData API, including law names, status, and Basic Law classification.790 PyPI1Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables querying UK Parliament data including MPs, Lords, bills, Hansard debates, and divisions.278 npmMIT