gotoHuman MCP Server logo

gotoHuman MCP Server

by gotohuman

The gotoHuman MCP Server allows AI agents to request human reviews via MCP. It provides an async webhook-based workflow for autonomous agents and AI automations to review AI-generated content, approve critical actions, or provide input.

View on GitHub

Last updated: N/A

gotoHuman MCP Server

Let your AI agents ask for human reviews in gotoHuman via MCP.
Review AI-generated content, approve critical actions or provide input.
An async webhook-based workflow for autonomous agents and AI automations.

Demo

This is Cursor on the left, but this could be a background agent that also reacts to the approval webhook to add an item to your list of newsletter ideas.

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

Setup

Get your API key and set up your review forms at app.gotohuman.com

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

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

Use in MCP client

Cursor or Claude

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