quantum-suitability-validator-mcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## [1.0.0] - 2026-05-04
+
+### Added
+- Initial release
+- `quantum_assess_problem` tool: AI-assisted quantum triage with 7-verdict system (RECOMMENDED_NOW through NOT_QUANTUM_AMENABLE)
+- `quantum_readiness_report` tool (Pro): full formulation guidance, hardware family fit, error budget, validation plan
+- Free tier: 5 quantum_assess_problem calls/month per IP, no API key required
+- Refusal-first assessment engine encoding real expert heuristics: QUBO failure patterns, penalty dominance detection, hype language flags
+- Streamable HTTP transport (Railway) + stdio transport (npm/Claude Desktop)
+- Stripe webhook integration for Pro key provisioning
+- UptimeRobot-compatible /health endpoint (GET + HEAD)
+- Anthropic Registry, Smithery, and npm published

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kord Agencies Pte Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+[![smithery badge](https://smithery.ai/badge/OjasKord/quantum-suitability-validator-mcp-server)](https://smithery.ai/servers/OjasKord/quantum-suitability-validator-mcp-server)
+
+# Quantum Suitability Validator MCP
+
+MCP server that screens quantum computing POC proposals against expert decision rules -- before your agent escalates any initiative to a committee, allocates budget, or routes to a specialist.
+
+## What it does
+
+Enterprise innovation agents and R&D workflow agents process backlogs of proposed technology initiatives tagged as potential quantum computing candidates. Before escalating any candidate to a human committee, allocating POC budget, or routing to a quantum specialist, the agent calls `quantum_assess_problem` to produce an auditable triage verdict.
+
+This server is **refusal-first by design**. It downgrades or refuses more often than it approves. Every verdict is auditable and machine-readable.
+
+## Tools
+
+### `quantum_assess_problem` (Free: 5/month, no key required)
+
+Screens a quantum computing proposal against expert decision rules. Returns:
+
+- `verdict`: RECOMMENDED_NOW | BENCHMARK_ONLY | HYBRID_ONLY | SIMULATOR_ONLY | NOT_RECOMMENDED | NOT_QUANTUM_AMENABLE | INSUFFICIENT_INFORMATION
+- `suitability_score`: 0.0-1.0
+- `confidence_score`: 0.0-1.0
+- `problem_class`: combinatorial_optimisation | portfolio_optimisation | molecular_simulation | ml_kernel | cryptography_pqc | sampling_monte_carlo | other
+- `dominant_blockers`: specific reasons why the problem fails screening
+- `hype_flags`: detected hype language patterns
+- `baseline_question`: always "What is your classical baseline today, and what metric must improve for this to matter?"
+- `agent_action`: ESCALATE_TO_POC | ROUTE_TO_SIMULATOR | DEFINE_BASELINE_FIRST | REJECT | REQUEST_MORE_INFORMATION
+
+### `quantum_readiness_report` (Pro only)
+
+Full auditable Quantum Readiness Report. Everything from `quantum_assess_problem` plus:
+
+- `recommended_workflow`: CLASSICAL_ONLY | HYBRID | SIMULATOR_ONLY | ANNEALING_PATH | GATE_MODEL_VARIATIONAL
+- `formulation_guidance`: QUBO/Ising/variational suitability, estimated binary variables, penalty dominance risk
+- `hardware_recommendations`: hardware family fit scores with access routes (D-Wave Leap, IBM Cloud, IonQ Cloud)
+- `error_budget_assessment`: viability against current noise floors
+- `classical_baseline_assessment`: baseline strength and minimum benchmark requirement
+- `validation_plan`: ordered steps for technical review board submission
+
+## Connect
+
+### HTTP (Railway -- no install)
+```json
+{"type": "http", "url": "https://quantum-suitability-validator-mcp-production.up.railway.app"}
+```
+
+### stdio (npm -- requires ANTHROPIC_API_KEY)
+```bash
+npx quantum-suitability-validator-mcp
+```
+
+## Pricing
+
+- **Free**: 5 `quantum_assess_problem` calls/month per IP -- no API key required
+- **Pro**: $199/month -- unlimited `quantum_assess_problem` + full `quantum_readiness_report`
+- **Enterprise**: $499/month -- volume + SLA
+
+Upgrade: [kordagencies.com](https://kordagencies.com)
+
+## Legal
+
+AI-assisted triage -- NOT a substitute for experimental physicist review. Results are for informational and planning purposes only and do not constitute expert quantum computing advice. Full terms: kordagencies.com/terms.html
+
+Kord Agencies Pte Ltd, Singapore

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,YAAY,4BAA4B,CAAC;AACtD,eAAO,MAAM,eAAe,mDAAmD,CAAC;AAChF,eAAO,MAAM,sBAAsB,mDAAmD,CAAC;AAEvF,eAAO,MAAM,gBAAgB,QAMc,CAAC;AAE5C,eAAO,MAAM,aAAa,QAsEgC,CAAC;AAE3D,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/constants.js

@@ -0,0 +1,86 @@
+export const VERSION = '1.0.0';
+export const CHARACTER_LIMIT = 25000;
+export const FREE_TIER_LIMIT = 5;
+export const PERSIST_FILE = '/tmp/quantum_stats.json';
+export const PRO_UPGRADE_URL = 'https://buy.stripe.com/cNi28q27P9Hnegk2paebu0x';
+export const ENTERPRISE_UPGRADE_URL = 'https://buy.stripe.com/7sY14m7s98Djfko4xiebu0y';
+export const LEGAL_DISCLAIMER = 'This assessment is generated by AI reasoning against an encoded expert decision framework. ' +
+    'It is for informational and planning purposes only and does not constitute expert quantum computing advice. ' +
+    'Results reflect heuristic rules, not experimental validation on physical hardware. ' +
+    'We do not log or store your problem description. ' +
+    'Provider maximum liability is limited to subscription fees paid in the preceding 3 months. ' +
+    'Full terms: kordagencies.com/terms.html';
+export const SYSTEM_PROMPT = 'You are a quantum computing triage expert. Your role is to screen proposed quantum computing ' +
+    'initiatives against real expert decision rules. You are REFUSAL-FIRST: default to refuse or ' +
+    'downgrade. Approve only when all of these exist: classical baseline, measurable success metric, ' +
+    'reducible benchmark instance, and validation path.\n\n' +
+    'AUTOMATIC REFUSAL -- return NOT_QUANTUM_AMENABLE or NOT_RECOMMENDED immediately if any:\n' +
+    '- No classical baseline stated or inferable from context\n' +
+    '- No measurable success metric provided or inferable\n' +
+    '- No possibility of a reduced benchmark instance\n' +
+    '- Validation of results would be impossible\n' +
+    '- Constraint overhead clearly dominates the objective\n' +
+    '- Motivation is signalling, optics, or competitor-following\n' +
+    '- Economic upside unclear even if quantum worked perfectly\n\n' +
+    'HYPE LANGUAGE DETECTION -- populate hype_flags when detected:\n' +
+    '- "quantum advantage" without specific baseline and metric\n' +
+    '- "competitors are doing quantum so we must"\n' +
+    '- "vendor says it will work"\n' +
+    '- "we already have a QUBO" but no penalty scaling explanation\n' +
+    '- "quantum initiative for board/optics/PR"\n' +
+    '- "quantum breakthrough" with no problem-specific grounding\n' +
+    '- "quantum will solve" without naming what classical cannot\n\n' +
+    'BASELINE QUESTION -- always populate baseline_question with:\n' +
+    '"What is your classical baseline today, and what metric must improve for this to matter?"\n' +
+    'If unanswerable from input, set agent_action to DEFINE_BASELINE_FIRST.\n\n' +
+    'PROBLEM CLASS RULES:\n\n' +
+    'Combinatorial optimisation:\n' +
+    'GOOD: reducible to 50-300 binary variables; clean binary assignment; sponsor names classical ' +
+    'baseline (MIP/CP-SAT + heuristics) and defines success metric.\n' +
+    'BAD: constraint overhead dominates; equality constraints cause auxiliary variable explosion; ' +
+    'no baseline; no validation path.\n\n' +
+    'Portfolio optimisation:\n' +
+    'GOOD: discreteness essential (cardinality, turnover, lot sizes); constraints explicit; clear KPI; ' +
+    'backtesting plan exists.\n' +
+    'BAD: constraints subjective or constantly changing; baseline already strong with no improvement ' +
+    'target; no acceptance criteria.\n' +
+    'Benchmark start: 30-150 instruments with discrete constraints.\n\n' +
+    'Molecular simulation:\n' +
+    'GOOD: tight scientific scope; reduced Hamiltonian feasible; domain experts available; staged roadmap agreed.\n' +
+    'BAD: simulate everything with no reduction; no classical gold-standard comparison.\n\n' +
+    'ML / kernel methods:\n' +
+    'GOOD: narrow testable hybrid subroutine; measurable evaluation protocol; expectation is ' +
+    'benchmarking not production replacement.\n' +
+    'BAD: quantum replaces ML narrative; no baseline; no evaluation plan.\n\n' +
+    'Cryptography / PQC:\n' +
+    'Near-term value is PQC migration governance only. Flag and refuse conflation of quantum computing ' +
+    'with PQC -- these are completely separate problems.\n\n' +
+    'Sampling / Monte Carlo:\n' +
+    'GOOD: sampling is dominant cost; statistical success criteria exist.\n' +
+    'BAD: no verifiable metric; no classical baseline.\n\n' +
+    'QUBO FAILURE PATTERNS -- flag in dominant_blockers:\n' +
+    '- Heavy equality constraints or repeated exactly-one constraints at scale\n' +
+    '- Many if/then rules causing auxiliary variable explosion\n' +
+    '- Dense interaction graph post-encoding causing embedding blow-up\n' +
+    '- Penalty-dominated objectives: valid mathematically, meaningless commercially\n\n' +
+    'HARDWARE RULES (quantum_readiness_report only):\n' +
+    '- QUBO/Ising viable + new team: annealing/hybrid first (D-Wave Leap)\n' +
+    '- QAOA/variational: default simulator-only unless shallow circuit confirmed\n' +
+    '- New team or no baseline: simulator-only until baseline + reduction + validation exist\n' +
+    '- Key metric: two-qubit fidelity + effective depth survivability, NOT qubit count\n' +
+    '- Never recommend paid cloud hardware below suitability score 0.6\n\n' +
+    'SCORING:\n' +
+    '0.8+: all conditions met -- recommend structured pilot\n' +
+    '0.6-0.79: worth pilot with validation plan -- minimum for paid cloud run\n' +
+    '0.2-0.4: plausible class but baseline unclear -- needs reformulation\n' +
+    '0.05 or below: refuse immediately\n\n' +
+    'NEVER:\n' +
+    '- Use "quantum advantage" without problem-specific grounding\n' +
+    '- Promise quantum beats classical without a defined baseline\n' +
+    '- Recommend production hardware without prior simulator result\n' +
+    '- Present simulator wins as hardware wins\n' +
+    '- Recommend a pilot when motivation is investor optics';
+export function nowISO() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,gDAAgD,CAAC;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,gDAAgD,CAAC;AAEvF,MAAM,CAAC,MAAM,gBAAgB,GAC3B,6FAA6F;IAC7F,8GAA8G;IAC9G,qFAAqF;IACrF,mDAAmD;IACnD,6FAA6F;IAC7F,yCAAyC,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GACxB,+FAA+F;IAC/F,8FAA8F;IAC9F,kGAAkG;IAClG,wDAAwD;IACxD,2FAA2F;IAC3F,4DAA4D;IAC5D,wDAAwD;IACxD,oDAAoD;IACpD,+CAA+C;IAC/C,yDAAyD;IACzD,+DAA+D;IAC/D,gEAAgE;IAChE,iEAAiE;IACjE,8DAA8D;IAC9D,gDAAgD;IAChD,gCAAgC;IAChC,iEAAiE;IACjE,8CAA8C;IAC9C,+DAA+D;IAC/D,iEAAiE;IACjE,gEAAgE;IAChE,6FAA6F;IAC7F,4EAA4E;IAC5E,0BAA0B;IAC1B,+BAA+B;IAC/B,+FAA+F;IAC/F,kEAAkE;IAClE,+FAA+F;IAC/F,sCAAsC;IACtC,2BAA2B;IAC3B,oGAAoG;IACpG,4BAA4B;IAC5B,kGAAkG;IAClG,mCAAmC;IACnC,oEAAoE;IACpE,yBAAyB;IACzB,gHAAgH;IAChH,wFAAwF;IACxF,wBAAwB;IACxB,0FAA0F;IAC1F,4CAA4C;IAC5C,0EAA0E;IAC1E,uBAAuB;IACvB,oGAAoG;IACpG,yDAAyD;IACzD,2BAA2B;IAC3B,wEAAwE;IACxE,uDAAuD;IACvD,uDAAuD;IACvD,6EAA6E;IAC7E,6DAA6D;IAC7D,qEAAqE;IACrE,oFAAoF;IACpF,mDAAmD;IACnD,wEAAwE;IACxE,+EAA+E;IAC/E,2FAA2F;IAC3F,qFAAqF;IACrF,uEAAuE;IACvE,YAAY;IACZ,0DAA0D;IAC1D,4EAA4E;IAC5E,wEAAwE;IACxE,uCAAuC;IACvC,UAAU;IACV,gEAAgE;IAChE,gEAAgE;IAChE,kEAAkE;IAClE,6CAA6C;IAC7C,wDAAwD,CAAC;AAE3D,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}