Gadfly is an API for generating high‑quality question sets from user input. It is designed primarily for users to use with LLM chat tools and coding agents (e.g., ChatGPT, Claude, Cursor) to call with a CLI or MCP.

What it is

  • API for Hypandra question generation
  • Optimized for work tasks (e.g., research, product development)
  • Usable manually for quick exploration

How it works

  • In the context of a user+agent conversation, the user asks the agent to use Gadfly for a particular task
  • Agent supplies some form of that task request as user_input and compiles relevant context (following Gadfly's Help instructions)
  • Gadfly returns a question set with four groups of increasing sophistication (a sort of maturity model)
  • Each group includes review, search, and discussion questions
  • The user can request the agent to use the question set in various ways

Response structure

Each response contains four tiers of question sets. Within each tier:

  • Review: for the LLM to walk the user through clarifications and tradeoffs
  • Search: queries the user can explore further as needed
  • Discussion: prompts to facilitate planning and alignment with the user and their LLM tool

MCP API Endpoint

The Gadfly MCP server is available at:

/api/v1/gadfly/mcp

Configure your MCP client with:

  • Transport: HTTP
  • Method: POST
  • Protocol: JSON-RPC 2.0
  • Authentication: Bearer token in Authorization header