GotoHuman MCP Server

GotoHuman MCP Server

What is GotoHuman MCP Server about?

Provides a fully‑managed, asynchronous human‑in‑the‑loop service that AI agents can invoke via the Model Context Protocol (MCP). It presents approval requests in a customizable UI, handles authentication, notifications, and webhook callbacks, and maintains a training dataset from completed reviews.

How to use GotoHuman MCP Server?

1. Installation – run npx @gotohuman/mcp-server to install the server.
2. Configuration – add an entry to your MCP client configuration (e.g., Cursor, Claude, Windsurf) using the npx command and set the GOTOHUMAN_API_KEY environment variable.
3. Tool Calls – interact with the server through built‑in tools:
   • list-forms – retrieve available review forms.
   • get-form-schema – obtain the JSON schema for a specific form.
   • request-human-review-with-form – submit a review request, optionally assigning users and attaching metadata.
4. Webhook – receive the completed review data via the configured webhook URL.

Key features of GotoHuman MCP Server

• Async human‑in‑the‑loop approvals with a customizable UI.
• Built‑in authentication via API key.
• Webhooks for real‑time notification of completed reviews.
• Team features: assign reviews to specific users, view in‑app inbox.
• Toolset for listing forms, fetching schemas, and creating review requests.
• CLI/Node.js package that can be run locally or deployed as a service.

Use cases of GotoHuman MCP Server

• Safety checks for AI‑generated content before publishing.
• Human validation of critical decisions in autonomous agents.
• Compliance review where regulatory approval is required.
• Collaborative editing where a team needs to approve AI‑suggested changes.
• Dataset enrichment by capturing human feedback for model fine‑tuning.

FAQ

Q: Do I need to run a separate server? A: No, the package runs as a local Node.js process invoked via npx and can be started directly from your MCP client configuration.

Q: Which environment variable holds the API key? A: GOTOHUMAN_API_KEY.

Q: Can I assign a review to specific users? A: Yes, use the assignToUsers parameter in the request-human-review-with-form tool.

Q: How do I get the form schema? A: Call the get-form-schema tool with the desired formId.

Q: Is the service compatible with all MCP‑enabled editors? A: It works with any client that supports MCP, including Cursor, Claude, Windsurf, and custom integrations.

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 via MCP or add it to your IDE to help with integration.

Installation

npx @gotohuman/mcp-server

Use with Cursor / Claude / Windsurf

{
  "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

Demo

This is Cursor on the left, but this could be a background agent that also reacts to the approval webhook.

https://github.com/user-attachments/assets/380a4223-ea77-4e24-90a5-52669b77f56f

Tools

list-forms

List all available review forms.

• Returns a list of all available forms 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 form.

• Params
  • formId: The form 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 form ID for the review
  • fieldData: Content (AI-output to review, context,...) and configuration for the form's fields.
    The schema for this needs to be fetched with get-form-schema
  • metadata: Optional additional data that will be incl. in the webhook response after form submission
  • assignToUsers: Optional list of user emails to assign the review to
• Returns a link to the review in gotoHuman

Development

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Run 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"
    }
  }
}
}

[!NOTE] For Windows, the args path needs to be C:\\<absolute-path>\\build\\index.js