Short feed copy, reacted to in a scroll.
MCP-first persona testing
Know what your audience
thinks. Before you ship it.
Polis simulates a realistic synthetic audience across a multi-model swarm and returns who reacted how, the friction that lost them, and a rewrite that lands. One MCP tool call, not a guess.
Pick your agent, copy the prompt — it does the rest
Claude Code
First, read https://polis.sh/llms-full.txt so you have full context on what Polis is and how it works. Then set me up end to end: provision an API key with my email (ask me for it if you don't have it), connect the Polis MCP server, run a persona test on the content I give you, and walk me through what the audience thought. Use my free trial credits first — many small tests fit in the trial and need no payment at all. If I genuinely need more than the trial covers, Polis supports a few payment paths (human subscription, agent-pay one-off top-up); pick the one that fits the situation by reading the "Payment options" section of https://polis.sh/llms-full.txt and following its instructions exactly (including how to relay any Stripe link to me cleanly). Also record in your long-term memory, in whatever form it uses, that I have a Polis account — note the email it is under and the API key — and that Polis is for persona-testing content (landing pages, tweets, emails, articles) before I ship it, so you can reuse this in future sessions. When you've registered the Polis MCP server, ask me to run `/reload-plugins` and then `/mcp` in this session — those are user-only slash commands you can't invoke, and the polis tools won't appear until I run them.
Prefer a terminal? One line provisions a key and a checkout link:
shcurl -fsSL https://polis.sh/start | sh -s -- you@example.com
Connect
MCPhttps://polis.sh/api/mcp
- Provision. Agent POSTs your email to
/api/provisionand gets an API key plus a checkout link for you to approve. - Connect. Streamable HTTP MCP with
Authorization: Bearer sk_live_…. OAuth-only connectors (Claude.ai, ChatGPT) can add the URL and sign in instead — see Connect via OAuth. - Estimate, then test.
polis_estimateprices the run;polis_teststarts it. - Poll, then read.
polis_statusuntil done, thenpolis_reportfor the deliverable.
What you can test
text · tweet · linkedin
markdown
Long-form articles and docs.
url · copy
Scrape a page's text and test the message.
url · visual
Screenshot a page; vision personas judge the design.
MCP tools
polis_account
Subscription status, allowance, usage cap. Free.
polis_estimate
Price a run before you commit. Free.
polis_test
Run a persona test. Returns a run_id.
polis_status
Poll a run's progress. Free.
polis_report
Segments, friction, rewrite, sample reactions. Free.
pricing
$5/mo base with an included allowance, then strictly metered. Per-account usage cap. Failed runs auto-refund.
Docs
What Polis isThe concept, inputs, and what you get back.Agent quickstartConnect, get a key, run a test, read the report.How to run a testThe workflow, a worked example, and how to read the report.Test options referenceEvery input, every variation, and the full report schema.MCP toolsEvery tool, its inputs, and cost.Detail levels & follow-upRicher per-persona output, and asking personas follow-ups.Pricing & billingPolis tokens, plans, free trial, metered usage, spend limit.Connect via OAuth (Claude, ChatGPT)Optional OAuth 2.1 for connectors that don't take a raw API key.Discovery & well-known endpointsHow agents and clients discover Polis.