
mindpolling
com.mindpolling/mindpolling
Polls of AI models: read public results with no key; create and run your own with an API key.
Documentation
For developers: the API, the MCP server and keys
Everything a person can do on Mind Polling, a program can do too, through a REST API and an MCP server that offer the same operations. Public polls need no key.
Without a key, and with one
- No key: find public polls and read their latest results, up to 120 requests a minute per address.
- A key with the read scope: results as they stood at a past moment, the feed of changes, and your own polls. It is free and can spend nothing.
- A key with write and run: create polls and run them. A run spends the account's prepaid balance, so every call that spends must say the most it may cost (
max_cost_usd), and is refused without it.
A key is made by the account holder, on the API keys page, never by a program. How keys work covers scopes, spending limits and what is logged.
The API
- Base address:
https://mindpolling.com/api/v1 - Description: OpenAPI 3.1, generated from the code that answers.
- Guide: the API guide, every operation with what it needs.
- Index: /api, the operations as JSON.
Try it, with nothing to install:
curl -s https://mindpolling.com/api/v1/polls
The guide opens with the whole API in five lines.
The MCP server
The same operations are tools at https://mindpolling.com/mcp (Streamable HTTP), named by their operation id. Add that address to an MCP client as a remote server. With no key it reads public polls; for your own, send a key as Authorization: Bearer. Tools that spend are marked destructive, so a client asks its user first.
From a terminal
The same tools are commands, with nothing to configure. mindpolling is a small package on npm that calls the MCP server, so its commands are always the server's own tools:
npx mindpolling
npx mindpolling list_polls --limit 5
npx mindpolling get_results <poll>
The first line lists every tool with its arguments. Set MIND_POLLING_API_KEY to call with a key. For an MCP client that can only start a local program, npx -y mindpolling mcp is the same server on standard input and output.
In a browser
A public page also offers its open reads (finding polls, reading a poll and its results, listing models) to an agent running in the browser, through WebMCP, where the browser supports it. They are the same tools as the MCP server's, with the same names. Nothing that needs a key is offered there.
Test keys
A key that starts mp_test_ is the sandbox: the same API on a stub model, with no charge and nothing public. Build against one before any money is involved.
A prompt to copy
Give one of these to an agent that has the MCP server, or the API guide. They are the prompts the MCP server itself offers.
Find a public poll and summarise what each model answered, with the 95% ranges.
Call list_polls, pick the poll that fits, then get_results for it. Report each model's latest answer with its 95% range, the number of answers it rests on, and whether answers that read a prediction market (sources.read_market) are a large share.
Create one of my polls, show me the cost, and run it once after I agree.
Call get_me to check the key, list_models for the models, create_poll with my questions, then estimate_poll. Tell me the cost and wait for my yes before run_poll_now with max_cost_usd set to that amount. Then follow it with get_live_run and report get_results.
Reading pages as Markdown
Every public page is also Markdown at its own address with .md added, such as /pricing.md, and answers Accept: text/markdown with the same text. /llms.txt is the map.
Versions and deprecation
The API is version 1, and the version is in every address (/api/v1). Within a version, fields are only added, never removed or renamed. A change that would break a client is a new version beside the old one.
Deprecation policy: a version being retired is announced on this page and keeps answering for at least 6 months. For that whole time each of its answers carries a Deprecation header (RFC 9745) and a Sunset header (RFC 8594) with the date it stops. No version is deprecated today.
Limits: 600 reads and 60 writes a minute per key; every answer carries RateLimit headers.
Questions and bug reports: contact us, or the public issue tracker.
This file is generated from mindpolling.com/developers, so it always says what the site says. Bug reports and requests are welcome as issues. A change to this text is an issue too, not a pull request: an edit made here would be overwritten.
mindpollingnpm install mindpolling