{
  "markdown": "# Quesen — Developer Portal\n\n[![MCP compatible](https://img.shields.io/badge/MCP-2025--03--26-8B5CF6?labelColor=1F2937)](https://spec.modelcontextprotocol.io/)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.Shxnque%2Fquesen-8B5CF6?labelColor=1F2937)](https://registry.modelcontextprotocol.io/v0/servers?search=quesen)\n[![Smithery](https://img.shields.io/badge/Smithery-%40shinque03%2Fquesen-6366F1?labelColor=1F2937)](https://smithery.ai/server/@shinque03/quesen)\n[![ASP version](https://img.shields.io/badge/ASP-1.0-06B6D4?labelColor=1F2937)](docs/api-reference.md)\n[![Engine version](https://img.shields.io/badge/engine-1.10.0-16A34A?labelColor=1F2937)](https://web-production-aa5ba.up.railway.app/version)\n[![PyPI](https://img.shields.io/pypi/v/quesen-sdk?label=pypi%20quesen-sdk&labelColor=1F2937&color=3775A9)](https://pypi.org/project/quesen-sdk/)\n[![npm](https://img.shields.io/npm/v/quesen-sdk?label=npm%20quesen-sdk&labelColor=1F2937&color=CB3837)](https://www.npmjs.com/package/quesen-sdk)\n[![Verified receipts](https://img.shields.io/badge/receipts-independently%20verifiable-16A34A?labelColor=1F2937)](verify/README.md)\n[![License](https://img.shields.io/badge/license-MIT-6B7280?labelColor=1F2937)](./LICENSE)\n\n> **Quesen** is the **deterministic decision-and-receipt core for agent actions** —\n> a typed security context in, a `PASS / REVIEW / BLOCK / SKIP` verdict out, with\n> machine reason codes and a receipt you can **re-run byte-for-byte and prove**.\n> No model inference is in the scoring path, so the same input always yields the\n> same verdict. It is built to sit **behind** injection detection, **on top of**\n> agent identity, and to **bill per decision** (ASP/402).\n>\n> Unlike log-based governance layers whose audit trail is *their word, kept by\n> them*, a Quesen receipt is **independently verifiable by the caller** —\n> recomputable, and (engine signing enabled) Ed25519-signed. See\n> [`docs/architecture-gap-closers.md`](docs/architecture-gap-closers.md) and\n> client-side **enforcement + receipt verification** in `quesen-sdk` ≥ 0.5.0.\n>\n> This repository is the **public developer portal**. It contains **only**\n> documentation, integration guides, examples, registry manifests, and\n> reference links. **No engine source code lives here.** Quesen's engine\n> implementation is sovereign, non-public infrastructure.\n\n**Live production**\n\n| Surface | URL |\n| :--- | :--- |\n| REST API | `https://web-production-aa5ba.up.railway.app` |\n| MCP (Streamable HTTP) | `https://web-production-aa5ba.up.railway.app/mcp` |\n| OpenAPI 3.1 | `https://web-production-aa5ba.up.railway.app/openapi.json` |\n| Swagger UI | `https://web-production-aa5ba.up.railway.app/docs` |\n| Health | `https://web-production-aa5ba.up.railway.app/health` |\n| Version | `https://web-production-aa5ba.up.railway.app/version` |\n\n---\n\n## Quick start (30 seconds)\n\n**Fastest path — no install, no signup, no card.** Self-serve a free sandbox key and run a\nreal deterministic decision against production. Full guide: [`docs/QUICKSTART.md`](docs/QUICKSTART.md)\n· try it in the browser at [senueren.co.za/try](https://senueren.co.za/try).\n\n```bash\n# 1 · get a free sandbox key\ncurl -X POST https://web-production-aa5ba.up.railway.app/sandbox/keys\n\n# 2 · evaluate an action (use the api_key from step 1)\ncurl -X POST https://web-production-aa5ba.up.railway.app/validate \\\n  -H \"X-API-Key: sk_sandbox_...\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"domain_age_days\": 1, \"engagement_ratio\": 0.95, \"scam_keyword_count\": 4}'\n# -> {\"decision\":\"SKIP\",\"risk_score\":1.0,\"conflict_triggers\":[...],\"input_snapshot_hash\":\"...\"}\n```\n\n### SDKs\n\n> **Published.** The SDKs are live on PyPI and npm (`quesen-sdk` `0.5.0` / npm `0.5.0`;\n> `quesen-langchain`, `quesen-crewai`, `quesen-autogen` `0.3.0`). The\n> `base_url` + `X-API-Key` (including the sandbox key above) are identical across all SDKs.\n\n### Python\n\n```bash\npip install quesen-sdk   # PyPI: https://pypi.org/project/quesen-sdk/\n```\n\n```python\nfrom quesen_sdk import QuesenClient\n\nq = QuesenClient(base_url=\"https://web-production-aa5ba.up.railway.app\",\n                 api_key=\"YOUR_KEY\")   # a sandbox key from /sandbox/keys works here\n\nverdict = q.validate(domain_age_days=1, engagement_ratio=0.95, scam_keyword_count=4)\nif verdict.decision == \"SKIP\":\n    return  # respect the deterministic answer\n```\n\n### JavaScript / TypeScript\n\n```bash\nnpm i quesen-sdk   # npm: https://www.npmjs.com/package/quesen-sdk\n```\n\n```ts\nimport { QuesenClient } from \"quesen-sdk\";\n\nconst q = new QuesenClient({\n  baseUrl: \"https://web-production-aa5ba.up.railway.app\",\n  apiKey: process.env.QUESEN_API_KEY,\n});\n\nconst verdict = await q.validate({\n  domain_age_days: 1,\n  engagement_ratio: 0.95,\n  scam_keyword_count: 4,\n});\n```\n\n### Framework wrappers\n\n| Framework | Package | Repository |\n| --- | --- | --- |\n| LangChain / LangGraph | `quesen-langchain` | [Shxnque/quesen-langchain](https://github.com/Shxnque/quesen-langchain) |\n| CrewAI | `quesen-crewai` | [Shxnque/quesen-crewai](https://github.com/Shxnque/quesen-crewai) |\n| AutoGen v0.4+ | `quesen-autogen` | [Shxnque/quesen-autogen](https://github.com/Shxnque/quesen-autogen) |\n| Python (core) | `quesen-sdk` | [Shxnque/quesen-sdk-py](https://github.com/Shxnque/quesen-sdk-py) |\n| JavaScript / TypeScript | `quesen-sdk` (npm) | [Shxnque/quesen-sdk-js](https://github.com/Shxnque/quesen-sdk-js) |\n\n### MCP (Claude Desktop, Cursor, Windsurf, etc.)\n\nQuesen exposes **five** MCP tools over the production endpoint. See\n[`docs/mcp.md`](docs/mcp.md) for the client-config snippet.\n\n---\n\n## Why Quesen?\n\nAutonomous agents make more decisions per second than any human oversight can\naudit. When those decisions involve capital — launching a token, opening a\nposition, executing a trade, greenlighting a smart-contract deployment — the\nmarginal cost of a bad decision is fatal.\n\n**Quesen answers exactly one question:**\n\n> *Should the calling agent proceed with this action?*\n\nInputs are typed. Outputs are one of `PROCEED`, `REVIEW`, `SKIP`, always with a\n`risk_score` in `[0.0, 1.0]`, a `confidence` in `[0.0, 1.0]`, and the exact\nconflict rules that fired. **Same inputs → same output. Every time.** Every\nresponse embeds `engine_version`, `weights`, and `thresholds`. Fully\nreproducible. Fully auditable.\n\n### What Quesen is not\n\n- **Not an LLM wrapper.** No prompts. No probabilities.\n- **Not a chatbot.** It is A2A infrastructure.\n- **Not a KYC/identity system.** It scores risk, not identity.\n- **Not chain-locked / framework-locked / LLM-locked.** Ecosystem-neutral by design.\n\n---\n\n## Documentation\n\n- [Quickstart](docs/QUICKSTART.md) — first decision in under 10 minutes (free sandbox key).\n- [Architecture overview](docs/architecture.md)\n- [Integration guide](docs/integrations.md)\n- [API reference](docs/api-reference.md)\n- [MCP setup](docs/mcp.md)\n- [Pricing tiers](docs/pricing.md)\n- [FAQ](docs/faq.md)\n- [Registry status](docs/registries.md)\n\n### Independent verification\n\nPublished receipts are independently reproducible from this repo alone — no\nhosted service or private engine required:\n\n```bash\npython3 verify/verify_receipts.py          # offline, stdlib-only\npython3 verify/verify_receipts.py --live   # also cross-check the live engine\n```\n\nAll six UCP #724 vectors show a byte-for-byte three-way match between the\npublished fixture, the public reference, and the live engine\n([`verify/README.md`](verify/README.md), [`verify/three_way_match.json`](verify/three_way_match.json)).\nThat doc also states honestly where independent verification stops today (the\nproduction ruleset `commit_sha` is not publicly resolvable; receipts are not yet\ncryptographically issuer-signed).\n\nThe **egress/authority decision subset** — the part security integrators gate on —\nis now independently *verdict*-replayable offline too, with **zero network**:\n\n```bash\npython3 evaluation/conformance/verify_conformance.py   # offline; recomputes decision+reasons+hash\n```\n\nSix cases (OWASP-agentic + LoopX prepared-Effect PASS/REVIEW/BLOCK) recompute\nbyte-for-byte from the public reference evaluator, plus a `prod-1→prod-2`\nintegrity-flip check — no signup, key, or hosted call\n([`evaluation/conformance/README.md`](evaluation/conformance/README.md)).\n\n### Tutorials\n\n- [Moltbook post-guard](docs/tutorials/moltbook-post-guard.md) — deterministic pre-post safety gate for autonomous social agents.\n- [OpenClaw MCP plugin](docs/tutorials/openclaw-plugin.md) — wiring Quesen as an MCP-native guardrail into OpenClaw-style agents.\n\n---\n\n## Live status\n\n- Production: `https://web-production-aa5ba.up.railway.app`\n- Health check: `GET /health` returns `{\"status\":\"ok\",\"engine_version\":\"1.10.0\"}`\n- Version snapshot: `GET /version` returns full engine + billing + on-chain flags (ASP/1.0)\n- Uptime and version widget on [senueren.co.za/quesen](https://senueren.co.za/quesen)\n\n---\n\n## Registry presence\n\nQuesen is discoverable via Model Context Protocol registries and the standard\nagent-directory ecosystem. See [`docs/registries.md`](docs/registries.md) for\nthe current state of each submission. Manifests:\n\n- [`smithery.yaml`](./smithery.yaml) — Smithery.ai (canonical)\n- [`mcp.json`](./mcp.json) — MCP.so / generic MCP client (canonical)\n- [`.well-known/ai-plugin.json`](./.well-known/ai-plugin.json) — OpenAI plugin\n  manifest / `.well-known/ai-plugin.json` autodiscovery\n- [`llms.txt`](./llms.txt) — machine-readable summary for LLM crawlers\n\n---\n\n## Contributing\n\nThis is a documentation-only repository. Engine PRs cannot be accepted here.\nIf you have integration-specific feedback, please [open an issue](https://github.com/Shxnque/quesen/issues) or read [`CONTRIBUTING.md`](CONTRIBUTING.md).\n\nSDK contributions belong in the corresponding public SDK repository:\n\n- Python: [Shxnque/quesen-sdk-py](https://github.com/Shxnque/quesen-sdk-py)\n- JavaScript: [Shxnque/quesen-sdk-js](https://github.com/Shxnque/quesen-sdk-js)\n- LangChain: [Shxnque/quesen-langchain](https://github.com/Shxnque/quesen-langchain)\n- CrewAI: [Shxnque/quesen-crewai](https://github.com/Shxnque/quesen-crewai)\n- AutoGen: [Shxnque/quesen-autogen](https://github.com/Shxnque/quesen-autogen)\n\nSecurity issues: please read [`SECURITY.md`](SECURITY.md) before filing publicly.\n\n---\n\n## License\n\nMIT. See [`LICENSE`](LICENSE).\n",
  "bytes": 10288,
  "sha": "202415bdc76b7d544019a268e25debababe04b9ac1daaf0624fc1ec80d6c76a2",
  "repo_slug": "shxnque/quesen",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shxnque_quesen_530824f0/readme"
}