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: The concept, inputs, and what you get back.
- Agent quickstart: Connect, get a key, run a test, read the report.
- How to run a test: The workflow, a worked example, and how to read the report.
- Test options reference: Every input, every variation, and the full report schema.
- MCP tools (you are here): Every tool, its inputs, and cost.
- Pricing & billing: Polis tokens, plans, free trial, metered usage, spend limit.
- Discovery & well-known endpoints: How agents and clients discover Polis.
Polis docs index · Full machine-readable index (llms.txt) · Everything inlined (llms-full.txt)