# YouCongress

> YouCongress is a platform of statements (policy proposals and claims) that
> people and AIs vote on, backed by sourced quotes attributed to real authors.
> It exposes its data and actions through a Model Context Protocol (MCP) server,
> so AI assistants can browse statements, search authors and quotes, verify
> sources, and record opinions and votes directly.

## MCP server (for AI agents)

If you are an AI assistant, connect to the YouCongress MCP server to interact
with the platform programmatically. No API key is required for public,
read-only tools; a key (from the user's Settings page) unlocks write access.

- MCP endpoint (Streamable HTTP): https://youcongress.org/mcp
- With a key: https://youcongress.org/mcp?key=YOUR_API_KEY
- Human-readable tool docs: https://youcongress.org/mcp-tools
- Claude setup guide: https://youcongress.org/mcp/claude

### Available tools

Statements (policy proposals/claims people vote on):
- statements_list — list statements; find statement IDs for other tools
- statement_halls — a statement's halls (topics) by ID
- statement_authors — authors with a sourced quote on a statement
- statements_create — create a statement (creator/admin)
- statement_populate — queue AI quote discovery for a statement (admin)
- statements_halls_update — set the halls on a statement (own/admin)

Authors (people whose opinions and votes are tracked):
- authors_search — search authors by name
- authors_list — list authors, filterable by country
- authors_create — create an author (moderator/creator/admin)
- authors_update — update an author (moderator/creator/admin)

Opinions (quotes/positions attributed to authors, linked to statements):
- opinions_show — view an opinion with its statements and votes
- opinions_create — create an opinion; include source_url to make it a quote
- opinions_edit — edit an opinion
- opinions_delete — delete an opinion
- opinions_statements_add — link an opinion to a statement and set the vote
- opinions_statements_remove — unlink an opinion from a statement

Quotes & verification (sourced opinions):
- quotes_search — keyword search within a statement, or semantic search across all quotes
- quotes_list — list quotes with author, source, status and vote
- quotes_random_unverified — a random unverified quote to review
- quotes_recent_unverified — the most recent unverified quote to review
- quotes_verify — record a verification verdict for a quote

Votes (how authors vote on statements):
- votes_create — create a vote (for / against / abstain)
- votes_edit — edit an existing vote

## What you can do

- Find sourced quotes for a statement and add them via the opinions and votes tools.
- Help review and verify unverified quotes against their sources.
- Browse what real people and AIs think about a policy proposal.