About Elicitly
Elicitly is an open-source local MCP server and toolkit for adding human input to agent prompts and skills. It provides confirmation and form dialogs, plus a diagnostic for checking host support for elicitation.
Key features
- 01Confirmation dialogs
- 02Schema-based forms
- 03Host elicitation diagnostics
- 04Inline LiquidJS templates
- 05Embeddable elicitation toolkit
Use cases
- 01Ask a person to approve an agent action
- 02Collect structured answers during a workflow
- 03Check whether an MCP host supports elicitation
MCP support
Elicitly exposes elicitation tools through a local stdio MCP server. The @elicitly/tools package also lets developers register those tools on their own McpServer.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| labels | object | No | Relabel or localize the OK/Cancel buttons. Each label is trimmed, 1-40 characters; unknown keys are rejected. Button placement and styling stay fixed. |
| labels.ok | string | No | Replacement label for the OK button (e.g. "Aceptar"). |
| labels.cancel | string | No | Replacement label for the Cancel button (e.g. "Cancelar"). |
| message | string | Yes | The yes/no question shown to the user in the host's elicitation dialog. |
| timeoutSeconds | number | No | How long to wait for the answer, in seconds (default 300, clamped 60-3600). |
Details
From the project READMEElicitly — Free Edition
Your AI has questions. Your users have answers. Elicitly connects them — human-in-the-loop for prompts and Agent Skills over MCP elicitation.
This repository is the open-source Free Edition: the elicitly local MCP
server and the @elicitly/tools library. The hosted Pro Edition — durable
approvals with review pages, an audit trail, and organization dashboards —
lives at elicitly.ai.
Quick start
Run the local (stdio) MCP server straight from npm — no clone, no config:
npx -y elicitly
Register it in your MCP host (Claude Code shown; any stdio host works):
claude mcp add elicitly -- npx -y elicitly
Or skip the command line: in Claude Desktop, download elicitly.mcpb from
the latest release
and open it — a one-click, self-contained
desktop extension.
Then ask your agent to call elicit_confirm ("Ship it?"), elicit_form
(your own JSON schema), elicit_doctor (does this host actually support
elicitation?), or elicit_display (show a LiquidJS template rendered inline as an
MCP App).
Packages
| Package | What it is |
|---|---|
elicitly | The local stdio MCP server (npx -y elicitly) |
@elicitly/tools | Embeddable toolkit: register the elicitation tools on your own McpServer |
Why
MCP has a native answer for asking a human — elicitation — but host support is
inconsistent, and only an MCP server can trigger it. Nobody wants to roll
their own server just to ask a question. Elicitly is that server (or, via
@elicitly/tools, the toolkit inside yours), plus the diagnostic
(elicit_doctor) that makes real-world host support visible — feeding the
public Support Matrix.
Develop
pnpm install
pnpm build # tsdown builds both packages
pnpm test # vitest
pnpm test:coverage # vitest + v8 coverage (thresholds enforced; HTML report in coverage/)
pnpm typecheck # tsc
pnpm check # biome
License
Elicitly™ is a trademark of Preneur LLC — see TRADEMARKS.md.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.