{"_id":"@agentic-survey/mcp-server","_rev":"5-87ae453febb12489711fea9f2952b6d2","name":"@agentic-survey/mcp-server","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@agentic-survey/mcp-server","version":"0.1.0","keywords":["mcp","model-context-protocol","survey","surveys","supabase","ai-agent","forms","cli"],"author":{"name":"Monty Daley","email":"monty@daley.org.nz"},"license":"MIT","_id":"@agentic-survey/mcp-server@0.1.0","maintainers":[{"name":"netmonty","email":"monty@daley.org.nz"}],"homepage":"https://www.mcpsurveys.com","bugs":{"url":"https://github.com/netmonty/agentic-survey-mcp/issues"},"bin":{"agentic-survey":"dist/cli.js"},"dist":{"shasum":"7f030cacf9b7f76940993631f054b95062c5e8ae","tarball":"https://registry.npmjs.org/@agentic-survey/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":11,"integrity":"sha512-w9I78KxnTqE0j23/CGfurNZNS/StmqTKtnXNlHU0F46D/7aTVIM6VRoo2L6TZw299D9IGLwQ8hWP8C6eUqktDQ==","signatures":[{"sig":"MEUCIELAM4GzSLl7Fb/199HLjPrLEWEr3JZ91mdOvZDXAFRGAiEAy6vZVKLsuIlsEKF1f2mkScscZnaU8yxkTXMRlQXsZg0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27354},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"c520397c0a2ab6788853fd45ebb69f01d3b0bff0","scripts":{"test":"node --import tsx --env-file-if-exists=../../.env --test src/**/*.test.ts","build":"tsc -b","start":"node --import tsx src/cli.ts","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"tsc -b"},"_npmUser":{"name":"netmonty","email":"monty@daley.org.nz"},"repository":{"url":"git+https://github.com/netmonty/agentic-survey-mcp.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.2","description":"MCP server (stdio) exposing survey tools over core, plus the agentic-survey CLI.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.23.0","@agentic-survey/core":"^0.1.0","@agentic-survey/schema":"^0.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1781171083383_0.8434510509213891","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agentic-survey/mcp-server","version":"0.1.1","keywords":["mcp","model-context-protocol","survey","surveys","supabase","ai-agent","forms","cli"],"author":{"name":"Monty Daley","email":"monty@daley.org.nz"},"license":"MIT","_id":"@agentic-survey/mcp-server@0.1.1","maintainers":[{"name":"netmonty","email":"monty@daley.org.nz"}],"homepage":"https://www.mcpsurveys.com","bugs":{"url":"https://github.com/netmonty/agentic-survey-mcp/issues"},"bin":{"agentic-survey":"dist/cli.js"},"dist":{"shasum":"81fefea2a2179338241eeea4599a5c92ad1e9226","tarball":"https://registry.npmjs.org/@agentic-survey/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":11,"integrity":"sha512-8pZvjhL676WpJ2a4/HcS/Lb2br5S7zXdL7gvJYE/uJWUF8iy1l+m+Ly7lfQhBCxRpnycwt52YfG9TPP8mrlYgw==","signatures":[{"sig":"MEUCIQDAzzRkSebHLGvyKmA3UJMCoz9qyAIJGoCOYihO+x0KsAIgTjukNLvI1iW3RCJmfVFz1/MSpHJgqJYRzhyrjRrJh70=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27328},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f8dfcce8f310f6366dceb934117f677f03438f45","scripts":{"test":"node --import tsx --env-file-if-exists=../../.env --test src/**/*.test.ts","build":"tsc -b","start":"node --import tsx src/cli.ts","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"tsc -b"},"_npmUser":{"name":"netmonty","email":"monty@daley.org.nz"},"repository":{"url":"git+https://github.com/netmonty/agentic-survey-mcp.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.2","description":"MCP server (stdio) exposing survey tools over core, plus the agentic-survey CLI.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.23.0","@agentic-survey/core":"^0.1.0","@agentic-survey/schema":"^0.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1781171990714_0.7155832368592427","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agentic-survey/mcp-server","version":"0.1.2","keywords":["mcp","model-context-protocol","survey","surveys","supabase","ai-agent","forms","cli"],"author":{"name":"Monty Daley","email":"monty@daley.org.nz"},"license":"MIT","_id":"@agentic-survey/mcp-server@0.1.2","maintainers":[{"name":"netmonty","email":"monty@daley.org.nz"}],"homepage":"https://www.mcpsurveys.com","bugs":{"url":"https://github.com/netmonty/agentic-survey-mcp/issues"},"bin":{"agentic-survey":"dist/cli.js"},"dist":{"shasum":"0eae54efb20ea11fa28819e55660ba8ba89cae4c","tarball":"https://registry.npmjs.org/@agentic-survey/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":11,"integrity":"sha512-zzgWs0M9cb39VT8m8PPK48aLf4JbjYvvxjvnM4PuuwLykWkQhsLzuMYsKYxrmBuVJCcJ1S6louS1lgEW9N6Mew==","signatures":[{"sig":"MEQCIHbyUFTCfYKhE2Sw3HJWgS7Hs8JLcbJ8mG+EkKQTO3ExAiBE9CwKmdXV6mkFhJFE0Io3xV6+NcomOImvgruBhiFuYQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28829},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f573bd49b11b56be69a020bde9c247bf8cabca5e","scripts":{"test":"node --import tsx --env-file-if-exists=../../.env --test src/**/*.test.ts","build":"tsc -b","start":"node --import tsx src/cli.ts","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"tsc -b"},"_npmUser":{"name":"netmonty","email":"monty@daley.org.nz"},"repository":{"url":"git+https://github.com/netmonty/agentic-survey-mcp.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.2","description":"MCP server (stdio) exposing survey tools over core, plus the agentic-survey CLI.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.23.0","@agentic-survey/core":"^0.1.0","@agentic-survey/schema":"^0.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.2_1781173907245_0.5432851955466647","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agentic-survey/mcp-server","version":"0.1.3","keywords":["mcp","model-context-protocol","survey","surveys","supabase","ai-agent","forms","cli"],"author":{"name":"Monty Daley","email":"monty@daley.org.nz"},"license":"MIT","_id":"@agentic-survey/mcp-server@0.1.3","maintainers":[{"name":"netmonty","email":"monty@daley.org.nz"}],"homepage":"https://www.mcpsurveys.com","bugs":{"url":"https://github.com/netmonty/agentic-survey-mcp/issues"},"bin":{"agentic-survey":"dist/cli.js"},"dist":{"shasum":"43bc890a0a67064684d9dffb901a7573ebf965f0","tarball":"https://registry.npmjs.org/@agentic-survey/mcp-server/-/mcp-server-0.1.3.tgz","fileCount":11,"integrity":"sha512-v257pAc2zltxSE7PRnpGj6m3lFVIXa16FkUkgEtXyE8CkM7/wLyofO2XqHkmkJNdI3p+12LGoocowYTx9t2bqA==","signatures":[{"sig":"MEQCIFjzpvi9njSSGHlTfXPMLiox1im7iwvxAo/R/XilBSXYAiB0LVcN3cSLAsx2+VGTmEq5u3asgpH/AYo4IDG0coGdYQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33607},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"28510be76030cffb04c5c5e5ce4fe3c52678a6ae","scripts":{"test":"node --import tsx --env-file-if-exists=../../.env --test src/**/*.test.ts","build":"tsc -b","start":"node --import tsx src/cli.ts","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"tsc -b"},"_npmUser":{"name":"netmonty","email":"monty@daley.org.nz"},"repository":{"url":"git+https://github.com/netmonty/agentic-survey-mcp.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.9.2","description":"MCP server (stdio) exposing survey tools over core, plus the agentic-survey CLI.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.23.0","@agentic-survey/core":"^0.1.0","@agentic-survey/schema":"^0.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.3_1781190318088_0.5895774202611823","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@agentic-survey/mcp-server","version":"0.1.4","description":"MCP server (stdio) exposing survey tools over core, plus the agentic-survey CLI.","license":"MIT","author":{"name":"Monty Daley","email":"monty@daley.org.nz"},"homepage":"https://www.mcpsurveys.com","repository":{"type":"git","url":"git+https://github.com/netmonty/agentic-survey-mcp.git","directory":"packages/mcp-server"},"bugs":{"url":"https://github.com/netmonty/agentic-survey-mcp/issues"},"keywords":["mcp","model-context-protocol","survey","surveys","supabase","ai-agent","forms","cli"],"publishConfig":{"access":"public"},"engines":{"node":">=20"},"type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"bin":{"agentic-survey":"dist/cli.js"},"scripts":{"build":"tsc -b","typecheck":"tsc -p tsconfig.json --noEmit","start":"node --import tsx src/cli.ts","test":"node --import tsx --env-file-if-exists=../../.env --test src/**/*.test.ts","prepublishOnly":"tsc -b"},"dependencies":{"@agentic-survey/core":"^0.1.2","@agentic-survey/schema":"^0.1.0","@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"_id":"@agentic-survey/mcp-server@0.1.4","gitHead":"89ce6859dd7de5ebbc008d18f50dfd204cde791c","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-IZWi1VOvIJuEaJ/yMVbWJ8gonlANLyOCkadQgEOpNU4dYBgEl0EIaUc2u1vkEyqrWSPMGqJlsyQAngj6obOMpw==","shasum":"fa1104d882371959f4b4c01d832d7f1bd822e92a","tarball":"https://registry.npmjs.org/@agentic-survey/mcp-server/-/mcp-server-0.1.4.tgz","fileCount":11,"unpackedSize":33649,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIH2n+p02iCqeUlU0JxMbj7LGZr3pESl7uODWe1U9KsuaAiABG4Q9MBmGxnDqjNbs9VhqCvSh3Y8hHy5Ps4ZPhaJgkA=="}]},"_npmUser":{"name":"netmonty","email":"monty@daley.org.nz"},"directories":{},"maintainers":[{"name":"netmonty","email":"monty@daley.org.nz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.4_1781298825091_0.032509505552475115"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-11T09:44:43.227Z","modified":"2026-06-12T21:13:45.366Z","0.1.0":"2026-06-11T09:44:43.536Z","0.1.1":"2026-06-11T09:59:50.864Z","0.1.2":"2026-06-11T10:31:47.376Z","0.1.3":"2026-06-11T15:05:18.276Z","0.1.4":"2026-06-12T21:13:45.242Z"},"bugs":{"url":"https://github.com/netmonty/agentic-survey-mcp/issues"},"author":{"name":"Monty Daley","email":"monty@daley.org.nz"},"license":"MIT","homepage":"https://www.mcpsurveys.com","keywords":["mcp","model-context-protocol","survey","surveys","supabase","ai-agent","forms","cli"],"repository":{"type":"git","url":"git+https://github.com/netmonty/agentic-survey-mcp.git","directory":"packages/mcp-server"},"description":"MCP server (stdio) exposing survey tools over core, plus the agentic-survey CLI.","maintainers":[{"name":"netmonty","email":"monty@daley.org.nz"}],"readme":"# @agentic-survey/mcp-server\n\nAn open-source ([MIT](./LICENSE)) [MCP](https://modelcontextprotocol.io) server that lets your own AI agent **build surveys and read results**, straight into **your own Supabase**. You own the data, you carry the AI cost, and your keys never leave your machine. It's free.\n\nPart of [agentic-survey-mcp](https://github.com/netmonty/agentic-survey-mcp). Site: [mcpsurveys.com](https://www.mcpsurveys.com).\n\n## Why\n\n- **You own the data.** Surveys, questions, and responses live in *your* Supabase project. Nothing is stored on anyone else's infrastructure.\n- **You carry the AI cost.** Authoring and analysis happen inside *your* agent. There's no AI running server-side, so there's nothing to bill you for.\n- **Bring your own keys.** Your Supabase secret key stays in a local config file. It's never transmitted, never logged, and never a tool argument the agent can read.\n\n## Quick start\n\n```bash\n# 1. Print the schema, paste it into your Supabase SQL editor\nnpx -y @agentic-survey/mcp-server init --print-sql\n\n# 2. Store your keys locally and verify the connection\n#    (typed into your terminal, never sent to the agent)\nnpx -y @agentic-survey/mcp-server init\n```\n\nThen point your MCP client at the server:\n\n```bash\n# Claude Code\nclaude mcp add agentic-survey -- npx -y @agentic-survey/mcp-server\n```\n\n```jsonc\n// Claude Desktop / Cursor / other (claude_desktop_config.json, .cursor/mcp.json, ...)\n{\n  \"mcpServers\": {\n    \"agentic-survey\": { \"command\": \"npx\", \"args\": [\"-y\", \"@agentic-survey/mcp-server\"] }\n  }\n}\n```\n\nNow just talk to your agent:\n\n> \"Build a 4-question customer-satisfaction survey with a 1-5 rating, a yes/no, a multiple choice, and an open comment. Publish it and give me the share link.\"\n\n> \"Summarise the results so far, themes from the comments too.\"\n\nThe agent chains the tools for you: `create_survey` → `add_question` → `publish_survey` → `get_results`.\n\n> Tip: `npm i -g @agentic-survey/mcp-server` gives you the shorter `agentic-survey init` command.\n\n### Do I need to enable RLS / anything in the Supabase dashboard?\n\nNo. The `init --print-sql` migration enables Row Level Security and the access policies for you, on all four tables. **Don't disable RLS:** it's what fences the publishable key (which travels in the share link) so it can *only* read **published** surveys and **insert** responses. It cannot read anyone's responses or your drafts. Your secret key, stored locally on your machine, bypasses RLS for authoring and analysis.\n\n## How it works\n\n```\n  your AI agent ──(MCP / stdio)──▶  mcp-server ──┐\n                                                  ├──▶  your Supabase\n  respondent ──(browser)──▶  page-service ────────┘     (source of truth)\n```\n\nPublishing a survey returns a share link carrying your project ref and publishable key. A respondent opens it, the stateless page-service writes their answers into your Supabase, and your agent reads them back with `get_results`. Supabase is the backend for now; more are planned.\n\n## Tools\n\n`setup_connection`, `create_survey`, `add_question`, `update_question`, `remove_question`, `reorder_questions`, `set_question_logic`, `validate_survey`, `publish_survey`, `get_share_link`, `list_surveys`, `get_survey`, `list_responses`, `get_results`.\n\nQuestion types: `single_choice`, `multi_choice`, `rating`, `yes_no`, `number`, `short_text`, `long_text`, `date`, `time` (24-hour), `slider` (0–100 percentage by default).\n\n### Branching / skip logic\n\n`set_question_logic` makes a question conditional: it shows (or hides) based on the answers to **earlier** questions — e.g. only ask the follow-up if someone rated you ≤ 2. The page-service evaluates this live and submission validation respects it (a hidden required question isn't required; answers to hidden questions are rejected). Run `validate_survey` after wiring logic and before `publish_survey` — it catches forward/dangling references, conditions citing options that don't exist (so a question could never appear), and choice questions with no options.\n\n## License\n\n[MIT](./LICENSE). Built by [Monty](https://montymakesthings.com). Source and issues on [GitHub](https://github.com/netmonty/agentic-survey-mcp).\n","readmeFilename":"README.md"}