MCP 서버

officials

global.rootz.politics/officials
지식 및 문서 검색 및 리서치 공개 · 연결 가능 MCP 2026-07-28

이 MCP로 할 수 있는 일

Provides source-linked data on US officials, candidates, legislation, votes, positions, speeches, polls, campaign finance, and provenance histories.

politics_alignment
politics_alignment
Compare an official's stated positions against their actual roll-call votes, per topic — what they SAY vs how they VOTED, both source-linked. Does NOT label agreement/contradiction (you judge and cite); surfaces the juxtaposition no unsigned source can. Use official id.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'Official ID'}}}
politics_bill
Bill Details
Details of a US bill or resolution: vote breakdown, sponsors, cosponsors, status, and origin proof. Returns metadata, a short text excerpt, and a text index by default; full legislative text is omitted because omnibus bills exceed typical token caps. The include_text parameter controls whether the complete text is returned in a single response.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['bill_id'], 'properties': {'bill_id': {'type': 'string', 'description': 'Bill ID (e.g. hr3424-119 for House bill 3424 in 119th Congress)'}, 'include_text': {'enum': ['none', 'excerpt', 'full'], 'type': 'string', 'default': 'excerpt', 'description': 'excerpt (default): metadata + ~1.2KB head + text index. none: metadata + index only. full: entire full_text (may exceed the token cap for large bills).'}}}
politics_bills_search
Search Bills
Search bills by topic, sponsor, status, or congress. Returns bill metadata and whether full text is available.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20}, 'topic': {'type': 'string', 'description': 'Topic keyword (e.g. crypto, defense, healthcare)'}, 'status': {'type': 'string', 'description': 'Bill status: introduced, committee, passed_house, passed_senate, enacted'}, 'sponsor': {'type': 'string', 'description': 'Sponsor name or bioguide ID'}, 'congress': {'type': 'integer', 'default': 119, 'description': 'Congress number (119 = 2025-2026)'}}}
politics_bill_text
Bill Text Slice
One signed, bounded slice of a bill's full legislative text, addressed by part number or section label. Each response carries part and total_parts, next_part, the slice's part_sha256, and the whole-bill content_hash. Parts 1 through total_parts concatenated in order hash to content_hash, so a bill too large to return in a single response remains verifiable as complete and unaltered.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['bill_id'], 'properties': {'part': {'type': 'integer', 'default': 1, 'description': '1-based part number. Response tells you total_parts and next_part.'}, 'bill_id': {'type': 'string', 'description': 'Bill ID (e.g. hr7148-119)'}, 'section': {'type': 'string', 'description': 'Jump to a section by label instead of part, e.g. "2", "SEC. 2", or "preamble". Overrides part.'}, 'max_chars': {'type': 'integer', 'default': 30000, 'description': 'Max characters per part (2000–60000). Larger = fewer parts but bigger responses.'}}}
politics_bill_toc
Bill Section Index
Section index for a bill: every "SEC. N" heading with its character offset and length, plus the whole-bill origin hash (content_hash) and total text length. A small response that describes the structure of a large bill.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['bill_id'], 'properties': {'bill_id': {'type': 'string', 'description': 'Bill ID (e.g. hr7148-119)'}}}
politics_bridge_compare
Save Comparison Set
Compare multiple politicians side-by-side on a bridge page — positions, party, office, campaign finance. Optionally filter to a specific topic.
입력 스키마
{'type': 'object', 'required': ['hash', 'official_ids'], 'properties': {'hash': {'type': 'string', 'description': 'Bridge page session hash'}, 'title': {'type': 'string', 'description': 'Title for this comparison'}, 'topic': {'type': 'string', 'description': 'Optional topic to focus comparison on'}, 'official_ids': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Array of official IDs to compare'}}}
politics_bridge_create
Create Bridge Workspace
Create a citizen bridge page — a personalized workspace for tracking representatives, comparing positions, and taking action (write letters, log calls). Returns a shareable URL that any AI agent can collaborate on. Optionally auto-populates with the citizen's state representatives.
입력 스키마
{'type': 'object', 'properties': {'zip': {'type': 'string', 'description': 'ZIP code for precise district matching'}, 'state': {'type': 'string', 'description': 'State abbreviation — auto-adds federal representatives'}, 'topics': {'type': 'string', 'description': 'Comma-separated topics of interest (e.g. Healthcare,Climate)'}}}
politics_bridge_letter
Draft Letter to Official
Draft a letter to a politician on the citizen's bridge page. The letter gets an origin hash for proof of content. Returns delivery options (email, web form, USPS, phone).
입력 스키마
{'type': 'object', 'required': ['hash', 'official_id', 'body'], 'properties': {'body': {'type': 'string', 'description': 'Letter body text'}, 'hash': {'type': 'string', 'description': 'Bridge page session hash'}, 'subject': {'type': 'string', 'description': 'Letter subject'}, 'action_type': {'enum': ['letter', 'email', 'call', 'meeting'], 'type': 'string', 'default': 'letter'}, 'official_id': {'type': 'integer', 'description': 'Official to write to'}}}
politics_bridge_session
Read Bridge Workspace
Current state of a citizen bridge workspace: tracked officials, saved comparisons, drafted actions, and messages.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['hash'], 'properties': {'hash': {'type': 'string', 'description': 'Bridge page session hash'}, 'agent_id': {'type': 'string', 'description': 'Your agent identifier for multi-agent tracking'}}}
politics_by_state
Officials by State
Get all current officials for a US state — federal senators and representatives, state legislators, and any indexed local officials. Organized by government level.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['state'], 'properties': {'state': {'type': 'string', 'description': 'State abbreviation (e.g. FL, CA, TX)'}}}
politics_candidate_feed
Candidate Data Feed
Get a candidate's Campaign Data Standard (CDS) feed: a single machine-readable record of who they are, the offices they hold and seek, their positions in their own words (each source-linked), their voting record by reference, and declared data gaps. This is the standardized, signed feed an AI or reporter uses to grab a candidate's positions and verify they are genuine. Every MCP response is signed; the standalone signed feed is also at /official/{id}/candidate.json. Tier is "rootz-compiled" until the campaign claims and signs it ("candidate-signed").
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'id': {'type': 'integer', 'description': 'Official ID (from politics_search)'}, 'expand': {'type': 'boolean', 'description': 'Deliver more positions inline (larger response). Default false = bounded for AI consumption.'}, 'bioguide_id': {'type': 'string', 'description': 'Bioguide ID (alternative to id)'}, 'positions_limit': {'type': 'integer', 'description': 'Max positions in the delivered feed (default 15, max 500). The complete signed feed (all positions) is always at signed_feed_url.'}, 'positions_offset': {'type': 'integer', 'description': 'Pagination offset for positions.'}}}
politics_candidates
Federal Candidates
Registered federal candidates for the 2026 election cycle, filterable by state, office (senate, house, president), party, or presence of a campaign URL. Returns campaign website, social media links, FEC data, and position and speech counts.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'description': 'Max results (default 50)'}, 'party': {'type': 'string', 'description': 'Filter by party (Democrat, Republican, Libertarian, etc.)'}, 'state': {'type': 'string', 'description': 'Two-letter state code (e.g. ME, CA, TX)'}, 'office': {'enum': ['senate', 'house', 'president'], 'type': 'string', 'description': 'Filter by office'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'has_url': {'type': 'boolean', 'description': 'Only return candidates with campaign websites'}}}
politics_changes
Recent Changes
Get recent changes detected across all politicians — position shifts, website updates, new data. Each change links to the before/after snapshots with origin proof.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50}, 'since': {'type': 'string', 'description': 'ISO date to filter changes after (e.g. 2026-05-01)'}}}
politics_coverage
politics_coverage
Coverage map: per-state, per-dataset completeness (officials by level, positions, finance, state-legislative votes). Shows WHERE the data is deep (federal — complete) vs sparse (local). Use it to know whether silence means "no data captured" rather than "nothing there".
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {}}
politics_create_watchlist
Create Watchlist
Creates a Just the Facts watchlist bound to an email address, covering any combination of specific officials, issue topics, and a town with state for local meetings, agendas, and minutes. Sends a double-opt-in confirmation email and returns the bridge workspace URL.
입력 스키마
{'type': 'object', 'required': ['email'], 'properties': {'name': {'type': 'string', 'description': 'Watchlist name'}, 'town': {'type': 'string', 'description': 'Town/city to track local meetings (e.g. Fort Myers)'}, 'email': {'type': 'string', 'description': 'Subscriber email (required)'}, 'state': {'type': 'string', 'description': '2-letter state for the town'}, 'topics': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Issue topics (e.g. Crypto, Healthcare)'}, 'cadence': {'enum': ['daily', 'weekly'], 'type': 'string', 'description': 'Digest frequency'}, 'officials': {'type': 'array', 'items': {'type': 'integer'}, 'description': 'Official IDs to track'}, 'report_prompt': {'type': 'string', 'description': 'Plain-English brief for how the digest is written'}}}
politics_methodology
Collection Methodology
Get the full transparency methodology — how we collect, assess, extract, sign, and verify political data. Includes quality assessment algorithm (signals + weights), trust levels, data sources, cron schedule, and what we can and cannot prove. Open and auditable.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {}}
politics_municipalities
Search Municipalities
Search US municipalities (cities, towns, villages, counties). Every incorporated place in the US with coordinates. Filter by state, name, or type. Returns website, platform, meeting calendar, and board/commission info where available.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Municipality name (partial match)'}, 'type': {'enum': ['city', 'town', 'village', 'borough', 'county', 'cdp', 'place', 'charter_township'], 'type': 'string', 'description': 'Place type: city, town, village, borough, county, cdp'}, 'limit': {'type': 'integer', 'default': 30, 'description': 'Max results (default 30)'}, 'state': {'type': 'string', 'description': 'Two-letter state code (MA, CA, TX, etc.)'}}}
politics_official
Official Profile
Get full details for a specific official by ID — biography, party, office, policy positions, committee assignments, campaign finance, social media, and contact info. All data includes source URLs for verification.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'id': {'type': 'integer', 'description': 'Official ID from politics_search results'}, 'expand': {'type': 'boolean', 'description': 'Return the fuller record (larger response, untruncated detail). Default false = bounded for AI consumption.'}, 'bioguide_id': {'type': 'string', 'description': 'Congress.gov Bioguide ID (e.g. S000033 for Bernie Sanders)'}, 'positions_limit': {'type': 'integer', 'description': 'Max policy positions to return (default 15, max 250). Response is bounded so it fits any AI client tool-result limit.'}, 'positions_offset': {'type': 'integer', 'description': 'Pagination offset for positions (page with offset += limit).'}}}
politics_origin
Origin Archive Statistics
Get origin archive statistics — total snapshots, changes detected, origin proofs recorded, unique URLs tracked. Shows the depth of the political wayback machine.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {}}
politics_poll
politics_poll
Get one poll in full: pollster, sponsor, field dates, population, sample size, margin of error, mode, the VERBATIM question(s) asked, per-option toplines, the first-party source_url, and the signature (poll_proof) that binds the exact wording and numbers. This is the ground truth to check any claim about a poll against.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'Poll ID from politics_polls results'}}}
politics_polls
politics_polls
Search the SIGNED public-poll archive. Unlike aggregators, every poll keeps the EXACT question wording, population base (LV/RV/adults), sample size, margin of error, mode, and per-option toplines — first-party sourced, snapshot-hashed, and cryptographically signed (verifiable). Filter by race_key, state, subject (e.g. "approval", "Senate"), pollster, or since (ISO date). Returns a list; call politics_poll {id} for full detail + signature. Use this when a question hinges on what a poll ACTUALLY asked vs how it was reported.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'cycle': {'type': 'integer', 'description': 'Election/survey cycle year (e.g. 2026)'}, 'limit': {'type': 'integer', 'default': 50}, 'since': {'type': 'string', 'description': 'Only polls whose field_end >= this ISO date (e.g. 2026-08-01)'}, 'state': {'type': 'string', 'description': '2-letter state (omit for national)'}, 'offset': {'type': 'integer', 'default': 0}, 'subject': {'type': 'string', 'description': 'Subject substring (e.g. "approval", "TX Senate", "immigration")'}, 'pollster': {'type': 'string', 'description': 'Pollster substring (e.g. "Quinnipiac", "Emerson")'}, 'race_key': {'type': 'string', 'description': 'Stable contest key to get every poll of one race over time (e.g. us-pres-approval-trump)'}}}
politics_positions
Policy Positions by Topic
Policy positions across officials by topic, covering who supports or opposes issues such as crypto, stablecoins, AI, healthcare, and guns. Each position carries a source URL and origin hash. Returns compact records by default (id, name, party, state, stance, summary, source) with a total count; the compact parameter controls row detail and offset controls paging.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['topic'], 'properties': {'limit': {'type': 'integer', 'default': 100, 'description': 'Max results per page. Compact: default 100, max 250. Full: default 25, max 50.'}, 'party': {'type': 'string', 'description': 'Filter by party (Republican, Democrat)'}, 'state': {'type': 'string', 'description': 'Filter by state (2-letter code)'}, 'topic': {'type': 'string', 'description': 'Policy topic label — use exact stored labels: Cryptocurrency, Technology, Healthcare, Immigration, Climate, Gun Control, Abortion, Taxes, Economy, Education, National Security, Housing, Criminal Justice, Social Security, Voting Rights, Agriculture, Trade'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset. Response includes total; page by offset += limit.'}, 'compact': {'type': 'boolean', 'default': True, 'description': 'Compact mode (default). Small bounded record per position; use with offset to page. Set false for full rows (limit capped at 50).'}}}
politics_provenance
Provenance Chain
Get the complete origin proof chain for an official — every data source, content hash, quality assessment, snapshot history, and verification instructions. Proves where every piece of data came from.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['official_id'], 'properties': {'official_id': {'type': 'integer', 'description': 'Official ID'}}}
politics_represent
Find My Representatives
Representation lookup for a US ZIP code: both U.S. Senators, the U.S. House member for that ZIP's congressional district, and the state's statewide executives (governor, attorney general, and similar). Every official carries source_url (the capture origin) and source_link (a public page).
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['zip'], 'properties': {'zip': {'type': 'string', 'description': '5-digit US ZIP code, e.g. 04101'}}}
politics_resolve
politics_resolve
Resolve a messy name string (e.g. "Rep. Johnson", "cornyn") to a canonical official — returns the best match with a 0-1 confidence score and ranked alternatives. Use this first when you have a name but not an ID; then call politics_official with best.id. Add state to disambiguate.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Name to resolve (partial/with title/lowercase all OK)'}, 'level': {'enum': ['federal', 'state', 'county', 'municipal', 'school'], 'type': 'string', 'description': 'Government level to disambiguate'}, 'state': {'type': 'string', 'description': 'State abbreviation to disambiguate (e.g. TX)'}}}
politics_search
Search Officials
Search for politicians and elected officials across all levels of US government — federal, state, county, municipal. Filter by name, state, party, level, chamber, or office title. Returns officials with their current office, party, and contact info.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Official name (partial match, e.g. "Sanders" or "Alexandria")'}, 'level': {'enum': ['federal', 'state', 'county', 'municipal', 'school'], 'type': 'string', 'description': 'Government level'}, 'limit': {'type': 'integer', 'default': 50, 'description': 'Max results (default 50)'}, 'party': {'type': 'string', 'description': 'Party name (e.g. Democrat, Republican, Independent)'}, 'state': {'type': 'string', 'description': 'State abbreviation (e.g. FL, NY, CA)'}, 'office': {'type': 'string', 'description': 'Office title (e.g. Senator, Mayor, Governor, Town Clerk)'}, 'offset': {'type': 'integer', 'default': 0, 'description': 'Pagination offset'}, 'status': {'enum': ['active', 'candidate', 'former', 'defeated'], 'type': 'string', 'description': 'Status (default: active + candidate)'}, 'chamber': {'enum': ['senate', 'house', 'council', 'board'], 'type': 'string', 'description': 'Legislative chamber'}}}
politics_speeches
Congressional Speeches
Search Congressional Record floor speeches by official, topic, date range, or keyword. Returns verbatim text from the official government record with origin proof hash. Every speech is directly citable with a GPO source URL.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'text': {'type': 'string', 'description': 'Full-text search within speech content'}, 'limit': {'type': 'integer', 'default': 20, 'description': 'Max results'}, 'topic': {'type': 'string', 'description': 'Topic (Cryptocurrency, Healthcare, Immigration, etc.)'}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string', 'description': 'Filter by chamber'}, 'date_to': {'type': 'string', 'description': 'End date ISO'}, 'date_from': {'type': 'string', 'description': 'Start date ISO (e.g. 2025-01-03)'}, 'bioguide_id': {'type': 'string', 'description': 'Bioguide ID (e.g. L000571 for Lummis, S001184 for Tim Scott)'}, 'official_id': {'type': 'integer', 'description': 'Official ID from politics_search'}}}
politics_state_votes
State Legislature Votes
Search state legislature votes across 26+ US states. Filter by state, topic, or date. Returns bill title, vote result, yes/no counts.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {'days': {'type': 'integer', 'default': 30, 'description': 'Look back N days (default 30, max 365)'}, 'limit': {'type': 'integer', 'default': 30, 'description': 'Max results (default 30, max 100)'}, 'state': {'type': 'string', 'description': 'Two-letter state code (CA, TX, NY, etc.)'}, 'topic': {'type': 'string', 'description': 'Topic filter (Healthcare, Economy, Education, etc.)'}, 'bill_id': {'type': 'string', 'description': 'Specific bill identifier (e.g. HB 1234)'}}}
politics_stats
Database Statistics
Get summary statistics for the politics.rootz.global database — total officials, breakdown by level, party, state, and chamber. Shows coverage completeness.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {}}
politics_timeline
Official Timeline
Get the full origin timeline for a politician — every page snapshot, every position change, every data source with hash proof. The political wayback machine. Shows what changed, when, and where the data came from.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'Official ID'}, 'limit': {'type': 'integer', 'default': 100}}}
추가됨
politics_poll
2026년 9월 17일 12:39 PM
추가됨
politics_polls
2026년 9월 17일 12:39 PM
추가됨
politics_create_watchlist
2026년 9월 17일 12:39 PM
추가됨
politics_municipalities
2026년 9월 17일 12:39 PM
추가됨
politics_state_votes
2026년 9월 17일 12:39 PM
추가됨
politics_candidates
2026년 9월 17일 12:39 PM
추가됨
politics_speeches
2026년 9월 17일 12:39 PM
추가됨
politics_provenance
2026년 9월 17일 12:39 PM
추가됨
politics_methodology
2026년 9월 17일 12:39 PM
추가됨
politics_coverage
2026년 9월 17일 12:39 PM
추가됨
politics_alignment
2026년 9월 17일 12:39 PM
추가됨
politics_candidate_feed
2026년 9월 17일 12:39 PM
추가됨
politics_bills_search
2026년 9월 17일 12:39 PM
추가됨
politics_bill_text
2026년 9월 17일 12:39 PM
추가됨
politics_bill_toc
2026년 9월 17일 12:39 PM
추가됨
politics_bill
2026년 9월 17일 12:39 PM
추가됨
politics_bridge_letter
2026년 9월 17일 12:39 PM
추가됨
politics_bridge_compare
2026년 9월 17일 12:39 PM
추가됨
politics_bridge_session
2026년 9월 17일 12:39 PM
추가됨
politics_bridge_create
2026년 9월 17일 12:39 PM
추가됨
politics_origin
2026년 9월 17일 12:39 PM
추가됨
politics_changes
2026년 9월 17일 12:39 PM
추가됨
politics_timeline
2026년 9월 17일 12:39 PM
추가됨
politics_stats
2026년 9월 17일 12:39 PM
추가됨
politics_positions
2026년 9월 17일 12:39 PM
추가됨
politics_by_state
2026년 9월 17일 12:39 PM
추가됨
politics_resolve
2026년 9월 17일 12:39 PM
추가됨
politics_official
2026년 9월 17일 12:39 PM
추가됨
politics_search
2026년 9월 17일 12:39 PM
추가됨
politics_represent
2026년 9월 17일 12:39 PM