# KirokuForms

> Online forms for small businesses: contact forms, surveys and signup forms you
> build by dragging fields into place. AI agents can create forms and send a task
> for a person to review, through our MCP server.

KirokuForms publishes forms on a website or by email, collects the responses, and
routes work that needs a human decision to a person. The agent-facing half is a
Model Context Protocol server: an agent can generate a form, ask a named person
to review something, and read the answer back when they have replied.

Free for 500 responses a month, no card required. Paid plans add popups, file
uploads, custom branding and unlimited forms.

## For agents and developers

Every endpoint under `/api/mcp/` requires a Bearer token. There is no anonymous
access, by design: a task is addressed to a real person and the response is
somebody's data.

- Get a token: sign in and open https://www.kirokuforms.com/dashboard/developer
- Send it as `Authorization: Bearer <key>` on every request.
- Unauthenticated requests return `401`.

### MCP endpoints

- `POST /api/mcp` — MCP protocol entry point
- `POST /api/mcp/tools/request-human-review` — ask a person to review something;
  returns a task id
- `GET  /api/mcp/resources/hitl/tasks` — list tasks
- `GET  /api/mcp/resources/hitl/tasks/{taskId}` — poll one task. `status` says
  whether it is answered; `submission.data` holds the person's answer;
  `template.name` is the task title
- `POST /api/mcp/resources/hitl/tasks/{taskId}/cancel` — cancel a task
- `POST /api/mcp/events/{eventType}` — event intake
- `POST /api/mcp/callbacks/task-completed` — completion callback

These field names are a stable contract. Changes are additive; nothing a client
reads is renamed or removed without a deprecation window.

### Documentation

- https://www.kirokuforms.com/ai/mcp — MCP server guide
- https://www.kirokuforms.com/ai/langgraph — LangGraph integration
- https://www.kirokuforms.com/ai/hitl-examples — worked human-in-the-loop examples
- https://www.kirokuforms.com/ai/docs — API documentation
- https://www.kirokuforms.com/ai/enterprise — enterprise options

### Python client

An official client library wraps the endpoints above:
https://github.com/ChelseaAIVentures/langgraph-kirokuforms

## For people

- https://www.kirokuforms.com/ — what it does
- https://www.kirokuforms.com/pricing — plans and prices
- https://www.kirokuforms.com/templates — ready-made forms
- https://www.kirokuforms.com/features — full feature list

## Contact

info@kirokuforms.com