GotoHuman MCP Server

What is GotoHuman MCP Server about?

GotoHuman MCP Server provides a fully‑managed service that lets AI applications request human reviews. It exposes MCP endpoints for listing forms, fetching form schemas, and submitting review requests, then delivers the results back through webhooks.

How to use GotoHuman MCP Server?

1. Install the server via npm:

   npx @gotohuman/mcp-server
   

2. Configure the required environment variable with your API key:

   {
     "mcpServers": {
       "gotoHuman": {
         "command": "npx",
         "args": ["-y", "@gotohuman/mcp-server"],
         "env": { "GOTOHUMAN_API_KEY": "your-api-key" }
       }
     }
   }
   

3. Call the provided tools (list-forms, get-form-schema, request-human-review-with-form) from your AI workflow or IDE integration.

Key Features of GotoHuman MCP Server

• Human‑in‑the‑loop approvals for any AI output.
• Customizable review forms with schema‑driven field definitions.
• Built‑in authentication using your GotoHuman API key.
• Webhook callbacks delivering completed review data.
• Team assignment allowing reviews to be routed to specific users.
• CLI‑compatible MCP server that runs locally or in the cloud.

Use Cases of GotoHuman MCP Server

• Safety gating for LLM‑generated content before publishing.
• Quality assurance in autonomous agents that produce code or documentation.
• Regulatory compliance where a human must sign off on decisions.
• Collaborative editing where multiple reviewers can approve or reject AI suggestions.

FAQ

Q: Which environment variable is required? A: GOTOHUMAN_API_KEY must contain a valid API key from app.gotohuman.com.

Q: Can I run the server locally? A: Yes. After installing, launch it with the MCP client configuration pointing to the built index.js file or use the npx command directly.

Q: How do I retrieve the form schema? A: Use the get-form-schema tool with the desired formId; the response includes all field definitions and validation rules.

Q: What does the request-human-review-with-form tool return? A: It returns a URL linking directly to the review in the GotoHuman UI and triggers a webhook once the review is completed.

Q: Is the server compatible with Cursor, Claude, or Windsurf? A: Yes. The README provides a ready‑to‑paste JSON snippet for each of those environments.

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