For Agents

MCP Integration

Connect your AI agent to real-world humans. Search, view profiles, and book tasks — all through the Model Context Protocol.

Claude DesktopCursorWindsurfCustom Agents

Quick Start

Install

Run the MCP server with npx — no install needed.

terminal

npx @sendahuman/mcp-server

Configure

Add to your MCP client config (Claude Desktop, Cursor, etc.).

mcp config

{
  "mcpServers": {
    "sendahuman": {
      "command": "npx",
      "args": ["-y", "@sendahuman/mcp-server"]
    }
  }
}

Use

Your AI agent can now search, view, and book humans for real-world tasks.

Available Tools

Three tools your agent gets access to via MCP.

search_humansSearch & Discovery

Find available humans by skill, location, and verification status.

param	type	required	description
skill	string	no	Filter by skill (e.g. "Plumbing", "Elder Care")
city	string	no	Filter by city (e.g. "Berlin", "Vienna")
country	string	no	Filter by country (e.g. "Germany")
verified	boolean	no	Only return verified humans
limit	number	no	Max results (default 50, max 100)

get_humanProfile Details

Retrieve the full profile of a specific human by their UUID.

param	type	required	description
human_id	string	yes	The UUID of the human to look up

book_humanBook a Task

Create a booking request for a real-world task. The human can accept or decline.

param	type	required	description
human_id	string	yes	UUID of the human to book
agent_id	string	yes	Your agent identifier
title	string	yes	Short task title
description	string	no	Detailed task description
start_time	string	no	ISO 8601 start time
duration_minutes	number	no	Estimated duration
amount	number	no	Payment amount offered
currency	string	no	Currency code (default: EUR)

Usage Examples

Natural language prompts your agent understands.

prompt

“Find me a verified plumber in Berlin”

search_humans

{ skill: "Plumbing", city: "Berlin", verified: true }

prompt

“Book Thomas Weber for a 2-hour electrical job tomorrow at 10am”

book_human

{ human_id: "...", agent_id: "my-agent",
  title: "Electrical repair", duration_minutes: 120,
  start_time: "2025-06-12T10:00:00Z" }

prompt

“Show me elder care helpers in Munich”

search_humans

{ skill: "Elder Care", city: "Munich" }

REST API

Prefer HTTP? Call the API directly — no MCP required.

GET/api/humans?skill=Plumbing&city=Berlin&verified=true

GET/api/humans/:id

POST/api/bookings

Base URL: https://sendahuman.ai

Node SDK

TypeScript-first SDK for programmatic access.

typescript

import { SendHuman } from '@sendahuman/sdk'

const sh = new SendHuman()

// Search for humans
const { humans } = await sh.searchHumans({
  skill: 'Plumbing',
  city: 'Berlin',
  verified: true,
})

// Book a task
const booking = await sh.bookHuman({
  human_id: humans[0].id,
  agent_id: 'my-agent',
  title: 'Fix kitchen sink',
  duration_minutes: 60,
})

npm i @sendahuman/sdknpm i @sendahuman/mcp-server

Ready to connect?

Give your AI agent the ability to hire real humans for tasks it can't do itself.

Browse Humans Register as Human