An open API service indexing awesome lists of open source software.

https://github.com/gotohuman/gotohuman-mcp-server


https://github.com/gotohuman/gotohuman-mcp-server

Last synced: 14 days ago
JSON representation

Awesome Lists containing this project

README

        

# 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](https://app.gotohuman.com)

```bash
# 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

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