gotoHuman MCP
OfficialUse gotoHuman MCP to add async human-in-the-loop approvals to AI workflows via MCP clients.
List all available review forms/review types.
Fetch a form’s field schema to know what data to provide.
Request a human review using a form ID and field data.
Include optional metadata for webhook follow-up and assign reviews to user emails.
Receive a
reviewIdandreviewLinkto track/access the approval.
Supports installation and building of the MCP server through npm package management, with commands for dependencies, building, and running the inspector.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gotoHuman MCP request a human review for this blog post draft using the 'content-review' form"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gotoHuman MCP Server
gotoHuman makes it easy to add human approvals to AI agents and agentic workflows.
A fully-managed async human-in-the-loop workflow with a customizable approval UI.
Enjoy built-in auth, webhooks, notifications, team features, and an evolving training dataset.
Use our MCP server to request human approvals from your AI workflows or use it to help with integration.
Usage
Available on npm as:
@gotohuman/mcp-serverSetup in Cursor / Claude / etc.
{
"mcpServers": {
"gotoHuman": {
"command": "npx",
"args": ["-y", "@gotohuman/mcp-server"],
"env": {
"GOTOHUMAN_API_KEY": "your-api-key"
}
}
}
}Get your API key and set up an approval step at app.gotohuman.com
Related MCP server: final-approval
Tools
list-forms
List all available review types.
Returns a list of all available review types in your account incl. high-level info about the added fields
get-form-schema
Get the schema to use when requesting a human review for a given review type.
Params
formId: The review type ID to fetch the schema for
Returns the schema, considering the incl. fields and their configuration
request-human-review-with-form
Request a human review. Will appear in your gotoHuman inbox.
Params
formId: The ID of the review type to usefieldData: Content (AI-output to review, context,...) and configuration for the review type's fields.
The schema for this needs to be fetched withget-form-schemaconfig: Configuration for the review type. Optional. The schema for this needs to be fetched withget-form-schematitle: Optional title shown in the inbox and notificationswebhookUrl: Optional webhook URL for this request (Static URLs can be set on the review type or the agent in gotoHuman)workflow: Optional object linking this review to a multi-step agentic workflow:runId: Unique ID for the current workflow run to link multiple steps.
metadata: Optional additional data that will be incl. in the webhook response after review template submissionassignToUsers: Optional list of user emails to assign the review to
Returns
reviewIdandreviewLink
Development
# Install dependencies
npm install
# Build the server
npm run build
# For testing: Run the MCP inspector
npm run inspectorRun locally in MCP Client (e.g. Cursor / Claude / Windsurf)
{
"mcpServers": {
"gotoHuman": {
"command": "node",
"args": ["/<absolute-path>/build/index.js"],
"env": {
"GOTOHUMAN_API_KEY": "your-api-key",
"GOTOHUMAN_AGENT_ID": "your-agent-id"
}
}
}
}For Windows, theargs path needs to be C:\\<absolute-path>\\build\\index.js
Available Tools
3 toolsget-form-schemaA
Get the schema to use for the 'fields' property when requesting a human review with a form.
Inputs: formId (required).
list-formsA
List all available review forms. NOTE: You need to fetch the schema for the form fields first using the get-form-schema tool.
Inputs: no named parameters.
request-human-review-with-formA
Request a human review with a form. NOTE: If you don't have a form ID yet, list all available forms using the list-forms tool first. To know what to pass for fieldData, you need to fetch the schema for the form fields using the get-form-schema tool.
Inputs: formId (required), fieldData (required), metadata, assignToUsers.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: get-form-schema retrieves schema information, list-forms enumerates available forms, and request-human-review-with-form submits a review request. There is no overlap in functionality, and the descriptions explicitly guide agents on when to use each tool, preventing misselection.
The tool names follow a consistent verb-noun pattern with hyphens (e.g., get-form-schema, list-forms, request-human-review-with-form), making them readable and predictable. The minor deviation is that request-human-review-with-form includes a prepositional phrase, but this does not significantly impact consistency.
With 3 tools, this server is well-scoped for its purpose of handling human reviews with forms. Each tool earns its place by covering essential steps: schema retrieval, form listing, and review submission, without being overly sparse or bloated.
The tool set provides complete coverage for the domain of requesting human reviews with forms. It includes all necessary CRUD-like operations: retrieving schema (read), listing forms (read), and submitting reviews (create), with no obvious gaps that would cause agent failures in this workflow.
Maintenance
Related MCP Connectors
Give any AI agent a way to ask a person — for approval, a decision, an answer or a review.
Set up human approval for your AI agents' tool calls.
Human approvals, notifications, inbound webhooks, wake-ups for headless agents. Free trial: /try
Human-in-the-loop API for AI agents. CAPTCHA, OTP, KYC, and approvals by real humans.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceHuman-in-the-Loop authorization gateway for AI Agents. Securely pause MCP workflows and route high-risk actions to human approvers via Slack or Email.56 npm1MIT
- AlicenseAqualityDmaintenanceHuman-in-the-loop approval gate for AI agents. Your agent calls submit_approval before any irreversible action; a human reviews on a branded page; a signed webhook fires back with the decision.11MIT
- AlicenseNot gradedqualityDmaintenanceProvides a human approval gate for AI agents, enabling interactive inline cards for approving, editing, or rejecting actions before they are executed.MIT
- AlicenseNot gradedqualityDmaintenancePauses AI agent execution and routes approval requests to humans via Slack or email, with cryptographically signed proof of the human's decision.MIT