# Mind Polling

> We poll AI models, not people. Write a poll, choose the AI models to ask, and see how their answers change over time, with every prompt, setting and raw response on the record.

Mind Polling is a web app run by Communities News (https://communities.news). It sends the questions in a person's poll to AI models through each provider's API, many times per question, on a schedule, and keeps every prompt, setting and raw answer so results can be checked, cited and rerun. It is built first for journalists and researchers.

## Start

- [What Mind Polling does](https://mindpolling.com/)
- [Public polls, by topic](https://mindpolling.com/polls)
- [How it works](https://mindpolling.com/how-it-works)
- [Methodology](https://mindpolling.com/methodology)
- [A worked example](https://mindpolling.com/example)
- [Pricing](https://mindpolling.com/pricing)
- [Models and their rates](https://mindpolling.com/models)
- [Questions and answers](https://mindpolling.com/faq)
- [For journalists](https://mindpolling.com/for-journalists)
- [For researchers](https://mindpolling.com/for-researchers)
- [For developers: the API, the MCP server and keys](https://mindpolling.com/developers)
- [The sandbox: test keys](https://mindpolling.com/sandbox)
- [Guide: your first poll](https://mindpolling.com/guides/first-poll)
- [Guide: write better questions](https://mindpolling.com/guides/write-better-questions)
- [Guide: read a result](https://mindpolling.com/guides/interpret-results)
- [About](https://mindpolling.com/about)
- [Contact](https://mindpolling.com/contact)
- [Data and privacy](https://mindpolling.com/data-and-privacy)
- [Create an account](https://mindpolling.com/signup): email and password, or Google.
- [Sign in](https://mindpolling.com/login).

Every page above is also Markdown at its own address with `.md` added (https://mindpolling.com/pricing.md), and answers `Accept: text/markdown` with the same text.

## Public polls

Each is Markdown at its address with `.md` added, and links its data as CSV and JSON. [The directory](https://mindpolling.com/polls) lists them by topic.

- [US and State Economy Outlook, by AI Model](https://mindpolling.com/p/state-economy-outlook), by [Communities News](https://mindpolling.com/u/communities-news)
- [Alaska Governor-elect Kreiss-Tomkins, by AI Model](https://mindpolling.com/p/alaska-governor-kreiss-tomkins), by [Alaska News](https://mindpolling.com/u/alaska-news)
- [Stock Market, Gold and Bitcoin Outlook, by AI Model](https://mindpolling.com/p/financial-stock-equity-market-outlook), by [Communities News](https://mindpolling.com/u/communities-news)
- [2027 Alaska PFD Amount, by AI Model](https://mindpolling.com/p/alaska-pfd-amount-2027), by [Alaska News](https://mindpolling.com/u/alaska-news)

## When to use Mind Polling

- **Use it** to find out what AI models say about a question, and how that changes: read a public poll's results, or (with the account holder's key) write a poll, price it and run it.
- **Use it** to check a claim about AI answers against a record: every figure has its range, its sample size, the models asked and the dates.
- **Do not use it** as a chatbot or as a survey of the public: it polls models, not people, and its results describe the models' answers, not the world.
- **Try it without spending:** public polls need no key, and a test key (`mp_test_`) runs polls on a stub model and charges nothing.

## Before you act: what is true here

- Mind Polling runs no A2A endpoint and publishes no agent skills. It has a REST API (OpenAPI at /openapi.json), an MCP server at /mcp and an AI catalog at /.well-known/ard.json; public polls need no key.
- **The API** ([/api/v1](https://mindpolling.com/api/v1)): anyone can find and read public polls and their latest results with no key. Every raw answer, results as of a past moment and the change feed need a free key with only the read scope, which spends nothing. With a key that has more scopes, which the account holder makes on [the API keys page](https://mindpolling.com/app/settings/api), an agent can create, edit, start, run and pause that person's polls and read their private results. A key that can run polls spends the account's prepaid balance, only up to the monthly allowance its owner gave it, and every call that spends must say the most it may commit (`max_cost_usd`) and is refused above it. Test keys run on a stub model and charge nothing. Every result can be read as it stood at a past moment (`as_of`). Limits: 120 requests a minute per address without a key, 600 reads and 60 writes a minute per key. Details: [the API guide](https://mindpolling.com/docs/api.md), [OpenAPI](https://mindpolling.com/openapi.json), [how keys work](https://mindpolling.com/auth.md). The same operations are MCP tools at [/mcp](https://mindpolling.com/mcp).
- An account is created with an email address and password, or with Google, on [the sign-up page](https://mindpolling.com/signup). A person has to confirm the email or complete the Google sign-in.
- Polls are private unless their author makes one public: then it has its own page under /p/ on this site, with its results, a sample of the replies, its method and its data (every reply stays its author's), and its author has a profile page under /u/. A private poll, and what any run cost, are never shown to anyone but its author. Any author can make a poll public once their profile has a display name and a handle and the poll has at least one topic; every public poll is listed in [the directory](https://mindpolling.com/polls), by topic.
- Running a poll costs money. An account is funded in advance with whole-dollar top-ups through Stripe. A poll runs between a start date and an end date, at most 90 days apart, at a set time of day, and stops on its own after its last run. Each answer is charged what the AI provider charged for it (its tokens, and any web searches), marked up (2.5 times by default), and at least $0.001; errors are not charged. The poll builder shows a typical and a high estimate for one run and for the whole poll before it is saved, and each run holds the most it can cost before the first model is asked and returns the unused part when it ends; a run is skipped when the balance cannot cover it.
- Results come from each model's API under stated settings. That is not the same as what a chat app shows, which adds its own instructions, memory and often web search.
- An author can link official figures (from FRED, the St. Louis Fed's data service, and from Massive's market data) to a question. They are shown beside the results, each as it had been published at the time drawn, never blended with the models' answers and never shown to the models; the API returns them as `official` on each question of `get_results`. This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis.

## API and MCP

- [For developers](https://mindpolling.com/developers): where to start, with a prompt to copy.
- [The sandbox](https://mindpolling.com/sandbox): test keys, which run polls on a stub model and charge nothing.
- From a terminal: `npx mindpolling` lists the MCP server's tools as commands, and `npx -y mindpolling mcp` is the server on standard input and output.
- [API guide](https://mindpolling.com/docs/api.md), [OpenAPI 3.1](https://mindpolling.com/openapi.json) and [the index](https://mindpolling.com/api).
- [How keys work](https://mindpolling.com/auth.md): scopes, test keys, spending limits.
- [MCP server](https://mindpolling.com/mcp): Streamable HTTP; send a key as `Authorization: Bearer` for your own polls.

## More

- [Everything in one file](https://mindpolling.com/llms-full.txt): this map plus the method.
- [Sitemap](https://mindpolling.com/sitemap.xml).
- [Security contact](https://mindpolling.com/.well-known/security.txt).
- [Privacy](https://communities.news/privacy) and [terms](https://communities.news/terms), on Communities News.
