> Full machine-readable index: https://polis.ai/llms.txt

[Polis](https://polis.ai) · [All docs](https://polis.ai/docs) · [llms.txt](https://polis.ai/llms.txt) · [llms-full.txt](https://polis.ai/llms-full.txt)

# MCP tools

Endpoint: `https://polis.ai/api/mcp` (Streamable HTTP). Auth: `Authorization: Bearer <api_key>`.

| Tool | Cost | Purpose |
|------|------|---------|
| `polis_account` | free | Subscription status, included allowance left, overage used, usage cap. Returns a checkout URL if inactive. |
| `polis_estimate` | free | Token + USD estimate for a prospective run and how it splits vs. the spend limit. |
| `polis_test` | charged up front | Start a persona test. Returns a `run_id`. Refunded automatically if the run fails before a report. |
| `polis_status` | free | Progress for a `run_id` (reactions done / total, done flag). |
| `polis_report` | free | The completed deliverable + aggregate stats + sample verbatim reactions. |

`polis_test` inputs: `content_type` (text|tweet|linkedin|markdown|url), `content` (unless url), `url` + `url_mode` (copy|visual) for url, optional `audience`, `persona_count` (10-1000, default 100).

Runs are asynchronous. Always: `polis_estimate` → `polis_test` → poll `polis_status` → `polis_report`.

---

## All docs

- [What Polis is](https://polis.ai/docs/overview.md): The concept, inputs, and what you get back.
- [Agent quickstart](https://polis.ai/docs/quickstart.md): Connect, get a key, run a test, read the report.
- [How to run a test](https://polis.ai/docs/run-a-test.md): The workflow, a worked example, and how to read the report.
- [Test options reference](https://polis.ai/docs/test-options.md): Every input, every variation, and the full report schema.
- [MCP tools](https://polis.ai/docs/mcp-tools.md) (you are here): Every tool, its inputs, and cost.
- [Pricing & billing](https://polis.ai/docs/pricing.md): Polis tokens, plans, free trial, metered usage, spend limit.
- [Discovery & well-known endpoints](https://polis.ai/docs/discovery.md): How agents and clients discover Polis.

[Polis docs index](https://polis.ai/docs) · [Full machine-readable index (llms.txt)](https://polis.ai/llms.txt) · [Everything inlined (llms-full.txt)](https://polis.ai/llms-full.txt)