Pqs MCP server
online · 100% uptimeio.github.OnChainAIIntel/pqs-mcp-server·v1.4.0·2 starsPQS scores any prompt before the model runs. 8 dimensions. 5 frameworks. Pre-flight, not post-hoc.
2 stars81 downloads/wk
Reviews
Write oneNobody has reviewed Pqs yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Pqs tools (2)
write = sends, deletes, buys or postsoptimize_promptFreeRewrite a prompt to score higher on the PQS rubric, AND show before/after output comparisons so the user can see the impact. Returns the optimized prompt, the original PQS score, the optimized PQS score, and side-by-side sample outputs from a frontier model using both versions. USE WHEN: - The user got a low score from score_prompt and asks how to improve. - The user explicitly asks to "improve" / "rewrite" / "fix" / "optimize" a prompt they pasted. - The user is dissatisfied with output quality from a previous prompt and asks how to get better results. - score_prompt returned a suggestion to invoke this tool. DO NOT USE WHEN: - The user just asked for a score (use score_prompt only — don't double up). - The user wants you to write a new prompt from scratch (write it directly). REQUIRES: A PQS API key from a Pro subscription ($19.99/month, 1,000 calls/mo, includes batch + A/B comparison). If the user has not provided one, the tool returns a clear subscription URL — pass that response to the user verbatim. Do not invent or guess API keys. There is no free trial of this tool; the user must subscribe before the first call. COST: Counted against your Pro subscription's monthly call quota. LATENCY: ~6-8 seconds.
score_promptFreeScore a prompt's quality across 8 dimensions BEFORE sending it to an expensive model. Returns a 0-80 score, an A-F grade, the per-dimension breakdown (clarity, specificity, context, constraints, output_format, role_definition, examples, cot_structure), and the weakest dimension. USE WHEN: - The user is workshopping a prompt and asks "is this good?" / "will this work?" / "should I add more detail?" - The user is about to send a long or expensive prompt to GPT-4, Claude Opus, or any frontier model, especially in a batch or automation context where rework is costly. - The user mentions iterating on a prompt that produced poor output and wants to diagnose what's missing. - The user pastes a prompt and asks for feedback on it. DO NOT USE WHEN: - The user is asking you to write a prompt for them (write it yourself first, then optionally call score_prompt to verify). - The prompt is conversational chat (this scores task-shaped prompts). COST: Free, no API key required. Rate-limited per IP: 5/min, 10/day, 100/month. If the user exceeds the limit, the response will include a structured upgrade path with subscribe and account URLs. LATENCY: ~2 seconds.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- Live reliabilityremote reachable in 330ms20/20
- Tool poisoning2 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 123 days ago8/15
- Maintainer identityregistry namespace matches repository owner6/10
How Pqs compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 84/100
- higher than 70% of 4,460 AI and agents servers
- Tools
- 2
- the typical AI and agents server has 6
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote AI and agents server answers 100%
- Response time
- 925 ms
- faster than 10% of 2,331 AI and agents servers
- GitHub stars
- 2
- more than 65% of 2,711 AI and agents servers
- Downloads a week
- 81
- more than 59% of 1,538 AI and agents servers with a package
What its tools let an agent do: 2 read
Install Pqs in Claude Code, Cursor or VS Code
claude mcp add --transport http pqs-mcp-server https://promptqualityscore.com/api/mcp
What the publisher says
From the Pqs repository's README, as published. We do not edit it. Read it on GitHub
PQS MCP Server
Score prompt quality before it reaches any AI model. An MCP server for PQS.
Score and optimize LLM prompts before they hit any model. Built on PEEM, RAGAS, MT-Bench, G-Eval, and ROUGE.
Install
Claude Desktop (stdio)
Add to your config (~/Library/Application Support/Claude/claudedesktopconfig.json):
{
"mcpServers": {
"pqs": {
"command": "npx",
"args": ["-y", "pqs-mcp-server"]
}
}
}Remote (HTTP)
Use this when your MCP client supports streamable-HTTP transport (no local npm install required):
{
"mcpServers": {
"pqs": {
"url": "https://promptqualityscore.com/api/mcp"
}
}
}Smithery
smithery mcp add onchaintel/pqsTools
score_prompt (Free, no API key required)
Returns a 0-80 score, A-F grade, full 8-dimension breakdown (clarity, specificity, context, constraints, outputformat, roledefinition, examples, cot_structure), and the weakest dimension. Rate-limited per IP: 5/min, 10/day, 100/month.
Low- and mid-band scores also include a structured suggestion field with a message, a nexttool pointer to optimizeprompt, and a subscribe URL the consuming LLM can paraphrase back to the user.
Example output (low-band score, suggestion attached):
{
"pqs_version": "2.0",
"prompt": "analyze this wallet",
"score": 9,
"out_of": 80,
"grade": "F",
"dimensions": {
"clarity": 2,
"specificity": 1,
"context": 1,
"constraints": 1,
"output_format": 1,
"role_definition": 1,
"examples": 1,
"cot_structure": 1
},
"weakest_dimension": "specificity",
"powered_by": "PQS — promptqualityscore.com",
"suggestion": {
"message": "This prompt scored 9/80 (F) — significant room to improve. The optimize_prompt tool rewrites it and shows side-by-side outputs from a frontier model, so you can see the impact. optimize_prompt is part of PQS Pro ($19.99/mo, 1,000 calls/mo). Subscribe at https://promptqualityscore.com/pricing?utm_source=mcp&utm_medium=suggestion_v140&utm_campaign=2026-05-mcp-tools-v140.",
"next_tool": "optimize_prompt",
"subscribe_url": "https://promptqualityscore.com/pricing?utm_source=mcp&utm_medium=suggestion_v140&utm_campaign=2026-05-mcp-tools-v140"
}
}If the per-IP rate limit is hit, the response is a structured ratelimitexceeded payload with subscribe and account URLs.
optimize_prompt (Pro subscription required)
Rewrites a prompt to score higher and runs both versions through a frontier model so the user can see the before/after output. Returns the optimized prompt, before/after dimension scores (with totals), improvement_pct, and side-by-side sample outputs.
Pro subscription required ($19.99/mo, 1,000 calls/mo, includes batch + A/B comparison). Subscribe at promptqualityscore.com/pricing.
If the API key is missing, invalid, or on the Free tier, the tool returns a structured error pointing the user at the right URL. No silent failures, no inventing keys. Errors emitted:
- apikeyrequired: no api_key argument was sent
- apikeyinvalid: key not recognized
- subscription_required: key is valid but Free tier (subscribe to upgrade)
- rate_limited: per-minute burst limit reached (Pro is rate-limited per minute, not per month) or temporary upstream capacity issue
- service_unavailable: upstream 5xx
Quality Gate Pattern
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Pqs: common questions
- Is Pqs MCP server safe?
- Mostly: it is graded B (84/100). Read the Pqs safety report
- How do I install Pqs?
- It runs remotely at promptqualityscore.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Pqs need an API key?
- Yes. The registry entry asks for
PQS_API_KEY. - Is Pqs maintained?
- The last commit was 161 days ago (2026-05-27). The latest release is v1.4.0.
- Is Pqs up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Pqs?
- Servers from other publishers that do the same job: Figma Context MCP server, Commonly MCP server and Decionis MCP server.
- How does Pqs compare with other AI and agents MCP servers?
- safety score 84/100 (higher than 70% of 4,460 AI and agents servers); tools 2 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Pqs
Same job from other publishers: the closest match first, then the best rated.
- Figma ContextGive your coding agent access to your Figma data. Implement designs in any framework in one-shot.not reviewedWidely usedB
- CommonlyRead Commonly pods and post as a Commonly agent you create, with a token from your Commonly account.not reviewedEstablishedA
- DecionisAuthorize consequential AI agent actions before executionnot reviewedEstablishedA
- Agent-Native AnalyticsAgent-Native Amplitude/Mixpanel - connect data sources, prompt for chartsnot reviewedEstablishedA
- IWE (iwe.md)Markdown knowledge base as agent memory. Runs against the notes directory it is started in.not reviewedEstablishedA