← HumanSurvey
FAQDocs

Changelog

What's shipped.

Dated releases since the MVP. Tracked publicly so humans and agents alike can tell the project is alive and moving.

Topical cluster completion + markdown twins + Organization graph

  • Added two long-form use-case walkthroughs: /use-cases/product-launch (indie maker / PM) and /use-cases/events (conference / meetup organizer).
  • Each use-case page has an Article JSON-LD node with a dated worked example (schema in → synthesis out).
  • Shipped markdown twins at /faq.md, /use-cases.md, /use-cases/community-feedback.md, /use-cases/product-launch.md, /use-cases/events.md — served alongside each HTML page for LLM crawlers that prefer markdown.
  • Wired content negotiation via Next.js alternates.types so well-behaved agents can request the markdown form of any canonical page.
  • Upgraded the site-wide JSON-LD to a @graph with an Organization node (sameAs: GitHub, npm, Glama) and a SoftwareApplication node linked via publisher — stronger entity signal for search and LLM indexes.
  • Sitemap now enumerates all HTML routes and .md twin URLs.

Landing rewrite + FAQ for external-audience personas

  • Retargeted the landing page to community/brand managers and indie makers — external audiences, not internal teams.
  • Added a /faq page with 11 natural-language Q&As and schema.org FAQPage JSON-LD.
  • Expanded /llms.txt with user-phrasing examples, comparison vs form builders, and an explicit distribution-boundary statement.
  • Added a worked community-feedback use case walkthrough at /use-cases/community-feedback.
v0.2.0

create_key MCP tool — agents self-provision API keys

  • New create_key MCP tool lets agents provision their own HumanSurvey API key with optional owner email and CAIP-10 wallet address.
  • No human setup required — an agent can bootstrap the full create_survey → get_results loop from a single Claude Code install.
  • Wallet address captured up front for future x402-style agent-native billing.

Observability, demo hardening, and packaging

  • Daily metrics script + GitHub Actions workflow; Telegram push notifications.
  • Tagged demo-origin surveys with a source column to keep production metrics clean.
  • Added Dockerfile and glama.json for Glama MCP directory listing.
  • Renamed API key prefix from mts_sk_ to hs_sk_ (and all env vars) alongside the HumanSurvey rebrand.

humansurvey.co launch — schema-only API and agent-first UX

  • Rebranded from markdown-to-survey (MTS) to HumanSurvey; live at humansurvey.co.
  • Switched to a schema-only API surface — markdown parsing moved to an LLM demo endpoint.
  • MCP package published as humansurvey-mcp on npm.
  • Webhooks fire on survey close; mobile layout + copy-button fixes for the demo panel.
  • Repositioned as "feedback collection for AI agents" end-to-end in docs and product copy.
v0.1.0

MVP — markdown to survey, MCP server, results dashboard

  • Initial monorepo (parser + Next.js app + MCP server).
  • Markdown-to-schema parser with single_choice, multi_choice, text, scale, and matrix question types.
  • Public respondent page at /s/{id} with localStorage draft recovery.
  • Results page at /r/{result_id} with live Supabase Realtime updates.
  • MCP server shipped with create_survey and get_results tools.

For the live commit log, see the GitHub history.