Skip to main content
Glama
YaakovTzedek

Persqo MCP Server

by YaakovTzedek
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

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.

Related MCP server: kilotest

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

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • kilotest

    jrpool
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI platforms to run ensemble front-end quality tests on public web pages, including accessibility, usability, and standards conformity, and to retrieve the resulting reports.
    3,235 npm
    4
    MIT
  • Menso MCP Server by menso-io

    Menso MCP Serverofficial

    menso-io
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI clients to launch real purchase or signup test runs against a live public URL and then fetch run status, scored findings with friction points and suggested fixes, and a public replay of every step taken. It works over Streamable HTTP with an API key, so no installation is needed in Claude Code, Cursor, Windsurf or any compatible client.
    5 npm
    MIT