# Polis

> Polis tests any piece of content against a realistic synthetic audience and returns what they actually thought — built MCP-first for AI agents.

Polis is an MCP server. Point an AI agent at `https://polis.sh/api/mcp` with a bearer API key and it can run a real audience simulation against any content in one tool flow.

## Start here

- Fastest: a human runs `curl -fsSL https://polis.sh/start | sh -s -- you@example.com` (provisions a key + prints the checkout link).
- New agent: `POST https://polis.sh/api/provision` with `{ "email": "..." }` to get a key and a checkout link for the human.
- Already have a key: connect MCP at `https://polis.sh/api/mcp`, call `polis_account`, then `polis_estimate` → `polis_test` → `polis_status` → `polis_report`.
- Full index: `https://polis.sh/llms.txt` · everything inlined: `https://polis.sh/llms-full.txt`

## Docs

- [What Polis is](https://polis.sh/docs/overview.md): The concept, inputs, and what you get back.
- [Agent quickstart](https://polis.sh/docs/quickstart.md): Connect, get a key, run a test, read the report.
- [How to run a test](https://polis.sh/docs/run-a-test.md): The workflow, a worked example, and how to read the report.
- [Test options reference](https://polis.sh/docs/test-options.md): Every input, every variation, and the full report schema.
- [MCP tools](https://polis.sh/docs/mcp-tools.md): Every tool, its inputs, and cost.
- [Detail levels & follow-up](https://polis.sh/docs/detail-and-followup.md): Richer per-persona output, and asking personas follow-ups.
- [Pricing & billing](https://polis.sh/docs/pricing.md): Polis tokens, plans, free trial, metered usage, spend limit.
- [Connect via OAuth (Claude, ChatGPT)](https://polis.sh/docs/oauth.md): Optional OAuth 2.1 for connectors that don't take a raw API key.
- [Discovery & well-known endpoints](https://polis.sh/docs/discovery.md): How agents and clients discover Polis.