What is gotoHuman?

gotoHuman is a human-in-the-loop platform designed to integrate human approvals into AI agent workflows. It provides a fully-managed async approval system with customizable UI, built-in authentication, webhooks, notifications, and team collaboration features.

How to use gotoHuman?

To use gotoHuman, follow these steps:

1. Install the MCP server using npx @gotohuman/mcp-server.
2. Set up your API key and configure approval steps at app.gotohuman.com.
3. Use the provided tools (list-forms, get-form-schema, request-human-review-with-form) to request human reviews.
4. Integrate gotoHuman with your AI workflows or IDE (e.g., Cursor, Claude, Windsurf).

Key features of gotoHuman?

• Human-in-the-loop approvals: Integrate human oversight into AI processes.
• Customizable approval UI: Tailor the interface for your specific needs.
• Built-in authentication: Secure access to approval workflows.
• Webhooks and notifications: Real-time updates on approval status.
• Team features: Collaborative review and approval processes.
• Evolving training dataset: Continuous improvement through user interactions.

Use cases of gotoHuman?

1. AI agent workflows: Add human approvals to AI-generated outputs.
2. IDE integration: Streamline approvals within development environments like Cursor or Windsurf.
3. Background agents: Trigger reviews for agent actions or results.
4. Team collaboration: Assign and manage approvals among team members.

FAQ from gotoHuman?

• How do I install gotoHuman?

  Use npx @gotohuman/mcp-server to install the server.

• What is an API key and where do I get it?

  The API key authenticates your requests. Get it from app.gotohuman.com.

• Can I integrate gotoHuman with my IDE?

  Yes, integrate with IDEs like Cursor, Claude, or Windsurf using the provided configuration.

• How do I customize the approval UI?

  Use the get-form-schema tool to fetch the schema and configure fields as needed.

• Is gotoHuman suitable for team use?

  Yes, it supports team features like assigning reviews to specific users and collaborative workflows.

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": ["//build/index.js"], "env": { "GOTOHUMAN_API_KEY": "your-api-key" } } } } ``` > [!NOTE] > For Windows, the `args` path needs to be `C:\\\\build\\index.js`