Politics Rootz — Documentation

MCP server & REST API for US political data · Rootz Corp · Updated 24 July 2026

Politics Rootz is a machine-readable database of US elected officials and candidates — from town clerk to president. Every record carries origin provenance: a cryptographic proof of which source it came from and when it was captured.

No API key. No account. No rate-limit signup.

Every read endpoint below is open. Paste any URL into a browser, curl, or an AI assistant and it returns structured JSON.

Quick start

# Find officials by state and level
curl https://politics.rootz.global/api/search?state=FL&level=federal

# Look up by name
curl https://politics.rootz.global/api/search?name=Sanders

# Full profile — positions, committees, finance
curl https://politics.rootz.global/api/official/1

# Who represents this address?
curl https://politics.rootz.global/api/represent?zip=04043

Connecting an AI assistant (MCP)

The MCP server speaks Streamable HTTP and exposes the same public data as the REST API.

Field	Value
Endpoint	`https://politics.rootz.global/mcp`
Transport	Streamable HTTP (SSE supported)
Authentication	None for read tools
Protocol	2024-11-05

Claude — custom connector

Settings → Connectors → Add custom connector → paste the endpoint URL above → Add. Then toggle the connector on inside the conversation where you want to use it.

Any MCP client — config

{
  "mcpServers": {
    "politics": {
      "type": "http",
      "url": "https://politics.rootz.global/mcp"
    }
  }
}

Tool catalog

READ tools are safe and side-effect free. WRITE tools create or modify a Citizen Bridge workspace. The live tools/list response is always authoritative.

Officials & representation

Tool		Purpose
politics_search	READ	Search officials by name, state, party, level, chamber
politics_official	READ	Full profile: positions, committees, finance
politics_by_state	READ	All officials in a state, grouped by level
politics_represent	READ	Representatives matching a ZIP or address
politics_candidates	READ	Declared candidates for upcoming races
politics_candidate_feed	READ	Candidate activity feed
politics_municipalities	READ	Municipal-level officials and bodies

Positions, votes & legislation

Tool		Purpose
politics_positions	READ	Stated policy positions across officials by topic
politics_speeches	READ	Speech and statement records
politics_state_votes	READ	State-level roll-call votes
politics_bills_search	READ	Search bills by keyword, topic, or sponsor
politics_bill	READ	Bill metadata, sponsors, status
politics_bill_toc	READ	Section table of contents — page before pulling text
politics_bill_text	READ	Bill text by section, sliced to avoid full dumps

Provenance & change tracking

Tool		Purpose
politics_origin	READ	Origin-proof statistics and coverage
politics_provenance	READ	Source proof for a specific record
politics_timeline	READ	Historical snapshots — the political wayback
politics_changes	READ	Recently detected position changes
politics_methodology	READ	How records are collected, scored, and verified
politics_stats	READ	Database coverage counts

Citizen Bridge (write)

Tool		Purpose
politics_bridge_session	READ	Read an existing workspace by hash
politics_bridge_create	WRITE	Create a citizen workspace
politics_bridge_compare	WRITE	Save a side-by-side comparison set
politics_bridge_letter	WRITE	Draft correspondence to an official
politics_create_watchlist	WRITE	Create a watchlist; sends a double-opt-in confirmation email

Origin provenance

Political data is only as good as its sourcing. Every record we publish is bound to a proof of where it came from — the source URL, the capture timestamp, and a content hash. When a record changes, the prior version is retained rather than overwritten, so the history of change stays auditable.

This is the difference between a claim and a measurement. We do not ask you to trust our numbers; we hand you the provenance and let you decide whether it is sufficient.

curl https://politics.rootz.global/api/origin
curl https://politics.rootz.global/api/official/1/timeline

Neutrality

Politics Rootz is politically neutral by construction. Every party, every candidate, every level is indexed on the same terms with the same collection methodology. We publish records and their provenance; we do not rank, endorse, score ideology, or editorialize. Where a scoring signal exists (such as AI-readability), the methodology is published at /api/methodology.

Fair use

There is no hard rate limit and no key to apply for. We ask that automated clients keep to a reasonable request rate, identify themselves with a descriptive user agent, and use politics_bill_toc to page into long documents rather than pulling entire bill texts speculatively. Sustained abusive traffic may be throttled at the edge.

Corrections

If you are an official or candidate and a record about you is wrong, visit /claim to claim and correct it, or email support@rootz.global. Corrections are versioned like any other change — the original stays in the archive with its origin proof intact.

Support

General & corrections: support@rootz.global
Privacy requests: privacy@rootz.global
Vulnerability reports: security@rootz.global