pqs-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,33 @@
+# PQS MCP Server
+
+The world's first named AI prompt quality score — as an MCP server.
+
+Score, optimize, and compare LLM prompts before they hit any model. Built on PEEM, RAGAS, G-Eval, and MT-Bench frameworks.
+
+## Install
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "pqs": {
+      "command": "npx",
+      "args": ["pqs-mcp-server"]
+    }
+  }
+}
+```
+
+## Tools
+
+- **score_prompt** — Free. Score any prompt, get grade + percentile. No API key needed.
+- **optimize_prompt** — $0.025 USDC via x402. Full dimension breakdown + optimized prompt.
+- **compare_models** — $0.50 USDC via x402. Claude vs GPT-4o head-to-head.
+
+## Get an API Key
+
+pqs.onchainintel.net
+
+## Built by
+
+John / OnChainIntel — @OnChainAIIntel

package/index.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const PQS_BASE = "https://pqs.onchainintel.net";
+
+const server = new Server(
+  {
+    name: "pqs-mcp-server",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "score_prompt",
+        description:
+          "Score any LLM prompt for quality using PQS (Prompt Quality Score). Returns a grade (A-F), score out of 40, and percentile. Free tier — no payment required. Use this before sending any prompt to an LLM to check if it is worth running.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            prompt: {
+              type: "string",
+              description: "The prompt to score",
+            },
+            vertical: {
+              type: "string",
+              enum: ["software", "content", "business", "education", "science", "crypto", "general"],
+              description: "The domain context for scoring. Defaults to general.",
+            },
+          },
+          required: ["prompt"],
+        },
+      },
+      {
+        name: "optimize_prompt",
+        description:
+          "Score AND optimize any LLM prompt using PQS. Returns the original score, an optimized version of the prompt, and dimension-by-dimension breakdown across 8 quality dimensions based on PEEM, RAGAS, G-Eval, and MT-Bench frameworks. Costs $0.025 USDC via x402. Use this when you want to improve a prompt before running it.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            prompt: {
+              type: "string",
+              description: "The prompt to optimize",
+            },
+            vertical: {
+              type: "string",
+              enum: ["software", "content", "business", "education", "science", "crypto", "general"],
+              description: "The domain context for optimization. Defaults to general.",
+            },
+            api_key: {
+              type: "string",
+              description: "PQS API key for authentication. Get one at pqs.onchainintel.net",
+            },
+          },
+          required: ["prompt", "api_key"],
+        },
+      },
+      {
+        name: "compare_models",
+        description:
+          "Compare how Claude vs GPT-4o handles the same prompt using PQS. Both models are scored head-to-head by a third model judge. Returns winner, scores, and recommendation on which model to use for this prompt type. Costs $0.50 USDC via x402.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            prompt: {
+              type: "string",
+              description: "The prompt to compare across models",
+            },
+            vertical: {
+              type: "string",
+              enum: ["software", "content", "business", "education", "science", "crypto", "general"],
+              description: "The domain context. Defaults to general.",
+            },
+            api_key: {
+              type: "string",
+              description: "PQS API key for authentication. Get one at pqs.onchainintel.net",
+            },
+          },
+          required: ["prompt", "api_key"],
+        },
+      },
+    ],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  if (name === "score_prompt") {
+    const response = await fetch(`${PQS_BASE}/api/score/free`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        prompt: args.prompt,
+        vertical: args.vertical || "general",
+      }),
+    });
+    const data = await response.json();
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(data, null, 2),
+        },
+      ],
+    };
+  }
+
+  if (name === "optimize_prompt") {
+    const response = await fetch(`${PQS_BASE}/api/score/full`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": args.api_key,
+      },
+      body: JSON.stringify({
+        prompt: args.prompt,
+        vertical: args.vertical || "general",
+      }),
+    });
+    const data = await response.json();
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(data, null, 2),
+        },
+      ],
+    };
+  }
+
+  if (name === "compare_models") {
+    const response = await fetch(`${PQS_BASE}/api/score/compare`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": args.api_key,
+      },
+      body: JSON.stringify({
+        prompt: args.prompt,
+        vertical: args.vertical || "general",
+      }),
+    });
+    const data = await response.json();
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(data, null, 2),
+        },
+      ],
+    };
+  }
+
+  throw new Error(`Unknown tool: ${name}`);
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("PQS MCP Server running on stdio");
+}
+
+main().catch(console.error);

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "pqs-mcp-server",
+  "version": "1.0.0",
+  "description": "PQS (Prompt Quality Score) MCP server \u2014 score, optimize, and compare LLM prompts before they hit any model. x402-native, built on PEEM, RAGAS, G-Eval, and MT-Bench.",
+  "main": "index.js",
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "prompt",
+    "quality",
+    "score",
+    "llm",
+    "x402",
+    "pqs",
+    "ai",
+    "claude",
+    "gpt"
+  ],
+  "author": "OnChainIntel",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "node-fetch": "^3.3.2"
+  },
+  "bin": {
+    "pqs-mcp-server": "./index.js"
+  },
+  "homepage": "https://pqs.onchainintel.net",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OnChainAIIntel/pqs-mcp-server"
+  }
+}