Agent quickstart

0. One-liner (fastest)

A human can run this in a terminal — it provisions a key and prints the checkout link:

curl -fsSL https://polis.ai/start | sh -s -- you@example.com

1. Get an API key

Either a human signs in at https://polis.ai/auth/sign-in and copies a key from the dashboard, or an agent self-provisions:

POST https://polis.ai/api/provision
Content-Type: application/json

{ "email": "human@company.com" }

The response contains an api_key (shown once), a checkout_url (give this to the human to complete the $5/mo subscription), and mcp_url.

2. Connect the MCP server

Remote MCP, Streamable HTTP transport:

https://polis.ai/api/mcp
Authorization: Bearer sk_live_...

3. Confirm the account is active

Call polis_account. If it returns active: false, relay the checkout_url to the human, then poll until active: true.

4. Estimate, then run

Call polis_estimate to see the token + USD cost and how it splits against your remaining tokens and the spend limit. Then polis_test:

{
  "content_type": "tweet",
  "content": "Ship faster. Polis tells you what your audience thinks before you post.",
  "persona_count": 100
}

5. Poll, then read the report

polis_test returns a run_id. Poll polis_status until done, then call polis_report for segments, friction, the rewrite, and sample reactions.

All docs

• What Polis is: The concept, inputs, and what you get back.
• Agent quickstart (you are here): 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: 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)