QubeSurvey local Survey MCP

Keep all package files together. Node.js 22 or later is required.
No npm installation, Rust toolchain or repository checkout is needed.
Verify: node /absolute/path/survey-mcp.mjs --verify
Configure your client to launch Node with the absolute launcher path and --legacy.
The compatibility protocol is MCP 2025-11-25. Clients supporting MCP 2026-07-28
can omit --legacy. Both expose the same local language tools.

Start with qube_workflow_get for research, survey or assessment guidance.
Use qss_guide_get and qss_check for QubeScript; use odin.* for Odin.
Review the source and test behavior in the QubeSurvey interview runner.
Local script checks require no QubeSurvey sign-in. Your model provider's
own data settings and charges apply to source you share with your agent.

In VS Code run QubeSurvey: Set up local MCP for client-specific configuration.
The setup command previews snippets; you review and merge them yourself.
Standalone clients can use the server bundled with the extension.
Optional private methodology: --mr-root /absolute/path/to/KB reads reviewed
local synthesis notes. This package contains no private knowledge base.

Optional aggregate fieldwork reads need separate explicit authorization.
QubeSurvey: Allow MCP Fieldwork Reads enables the editor bridge after consent;
QubeSurvey: Disable MCP Fieldwork Reads revokes that local bridge.
The editor retains its bearer; the child gets only a revocable local capability.
The default-false setting alone grants no access. Permissions are rechecked.
Reads cannot initialize, edit or activate Runs. Hosted OAuth is not needed
for local authoring.

Setup guide: https://docs.qubesurvey.com/mcp
Third-party notices and the supplied extension license accompany this package.
