Persqo
Run Persqo persona tests on a public URL and return findings and a fix prompt.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http persqo 'https://persqo.com/api/mcp' --header 'Authorization: <Persqo API key sent as a Bearer token>'{
"mcpServers": {
"persqo": {
"type": "http",
"url": "https://persqo.com/api/mcp",
"headers": {
"Authorization": "<Persqo API key sent as a Bearer token>"
}
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Persqo MCP Server
AI personas test your web app like real users, then hand your coding agent ready-to-paste fix prompts.
Persqo runs AI personas (first-time visitor, impatient mobile user, accessibility-dependent user and more) through your live or preview site in a real browser. Every run gives you step-by-step recordings, screenshots and prioritized findings. This MCP server lets Claude Code, Cursor, Codex and any MCP client start a test, wait for it, read findings and pull a fix prompt straight into the session.
Get an API key
Sign up at https://persqo.com and create an API key (pq_live_...) in the dashboard.
Option A: remote server (no install)
{
"mcpServers": {
"persqo": {
"url": "https://persqo.com/api/mcp",
"headers": { "Authorization": "Bearer pq_live_YOUR_KEY" }
}
}
}Claude Code:
claude mcp add --transport http persqo https://persqo.com/api/mcp --header "Authorization: Bearer pq_live_YOUR_KEY"Option B: local stdio from GitHub
persqo-mcp is not on npm. Install and run the stdio server from this repository. package.json maps the persqo-mcp command to bin.js, which is what npx executes:
npx -y github:YaakovTzedek/persqo-mcp{
"mcpServers": {
"persqo": {
"command": "npx",
"args": ["-y", "github:YaakovTzedek/persqo-mcp"],
"env": { "PERSQO_API_KEY": "pq_live_YOUR_KEY" }
}
}
}Optional PERSQO_API_BASE (default https://persqo.com).
Tools
| Tool | What it does |
|---|---|
run_test | Start persona testers against a public https URL. wait true polls until the test finishes and returns a summary plus the fix prompt. Persqo's browser runs in the cloud and cannot open localhost. Deploy a preview (Vercel or Netlify) or tunnel your machine with ngrok or cloudflared, then pass that https URL. timeout_ms default 120000, max 600000. Requires url. |
get_test_status | Read status, personas, findings, cost, and the report URL. Requires test_id. |
get_findings | Findings with severity, screenshots, and fix_prompt. Requires test_id. |
get_fix_prompt | One combined fix prompt for a finished test. Requires test_id. |
generate_personas | Suggest personas for a URL. Does not spend a session. Requires url. |
list_tests | List recent tests. Optional limit. |
Notes
The Persqo browser cannot open localhost. Use a Vercel/Netlify preview URL or an ngrok / cloudflared tunnel.
License
MIT
Frequently asked questions
What is Persqo?
Run Persqo persona tests on a public URL and return findings and a fix prompt.
How do I install Persqo?
It runs as a remote server. In Claude Code: claude mcp add --transport http persqo 'https://persqo.com/api/mcp' --header 'Authorization: <Persqo API key sent as a Bearer token>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Persqo need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is Persqo open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Persqo?
It is published by YaakovTzedek. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.