> 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)

# 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`:

```json
{
  "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](https://polis.ai/docs/overview.md): The concept, inputs, and what you get back.
- [Agent quickstart](https://polis.ai/docs/quickstart.md) (you are here): 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): 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)