Why we built Voter Guide Commons

If someone asks an AI assistant where the candidates on their ballot stand, the best source is a newsroom's voter guide, from a state or local newsroom that covers the race, where the candidates answered the newsroom's questions themselves. We built this so that's the answer they get, with credit to the newsroom that did the work.

Who's behind it

Voter Guide Commons is a project of Hacks/Hackers, a nonprofit founded in 2009 that brings journalists and technologists together.

We announced it on October 12 in a post on the Hacks/Hackers blog.

How it's built

It's an MCP server. MCP, the Model Context Protocol, is how assistants like Claude and ChatGPT connect to outside tools and data. The server reads each participating guide, finds the passages that answer a question and hands them to the assistant along with the newsroom's name and a link.

You can read exactly what the server tells the AI, published straight from the code that sends it.

Privacy

This site sets no cookies and runs no tracking scripts. We count page views on our own server.

We count which candidates, races and topics assistants look up in each guide, and send those counts to the newsroom that published it. We see the lookup an assistant makes, not the question someone typed.

When someone gives the connector a street address to find their races, the address goes to the U.S. Census geocoder to look up districts. We don't log it. We keep only the state it's in, so we can count lookups by state.

Links to newsrooms in answers carry a tag, utm_source=voterguidecommons, so each newsroom can count the visits we send. It names us, not you.

If you report a problem with an answer, we keep what you send so we can fix it.

The privacy policy has the details: what we record, who else handles it and how long we keep it.

Get in touch

For editorial or technical questions, email Burt Herman at burt@voterguidecommons.org. If you're interested in supporting the project, email Paul Cheung at paul@voterguidecommons.org.

For anything else, email contact@voterguidecommons.org. Newsrooms can also sign up their guide through the form, which has room for questions.