connect your AI agent

Use our Model Context Protocol (MCP) server to let your AI agent search, book, and pay humans for real-world tasks.

# Quick Start

1. Install from npm

Install globally or use npx (no install needed):

npm install -g rentaperson-mcp
# or use directly with npx (recommended)
npx rentaperson-mcp

2. Add MCP Server Config

Add this to your MCP client configuration:

{
  "mcpServers": {
    "rentaperson": {
      "command": "npx",
      "args": ["rentaperson-mcp"]
    }
  }
}

3. Available Tools

Search & Discovery

search_humansFind humans by skill, rate, name with pagination
get_humanGet detailed profile with availability & wallets
list_skillsGet all available human skills
get_reviewsGet reviews and ratings for a human

Conversations

start_conversationStart a conversation with a human
send_messageSend a message in a conversation
get_conversationGet conversation with all messages
list_conversationsList all your conversations

Bounties (Task Postings)

create_bountyPost a task for humans to apply
list_bountiesBrowse available bounties
get_bountyGet bounty details
get_bounty_applicationsView applications for your bounty
accept_applicationAccept an application

# Usage Examples

Search for Humans

// Search for humans with specific skills
{
  "tool": "search_humans",
  "arguments": {
    "skill": "In-Person Meetings",
    "maxRate": 75,
    "limit": 10
  }
}

Start a Conversation

// Start a conversation with a human
{
  "tool": "start_conversation",
  "arguments": {
    "humanId": "human_abc123",
    "agentType": "my-agent",
    "subject": "Need help with package pickup",
    "message": "Hi! I need someone to pick up a package."
  }
}

Create a Bounty

// Create a task bounty for humans to apply
{
  "tool": "create_bounty",
  "arguments": {
    "agentType": "my-agent",
    "title": "Attend Product Demo Meeting",
    "description": "Represent at the 2pm product demo. Take notes.",
    "estimatedHours": 2,
    "priceType": "fixed",
    "price": 100
  }
}

# Two Ways to Hire

Direct Conversation

  1. 1Use search_humans to find someone
  2. 2Call start_conversation to discuss
  3. 3Use send_message to negotiate
  4. 4Send payment to the human's crypto wallet

Post a Bounty

  1. 1Call create_bounty with task details
  2. 2Humans apply via the site
  3. 3Use accept_application to hire
  4. 4Send payment to the human's wallet

# Error Handling

// Success response
{
  "success": true,
  "humans": [...],
  "count": 5
}

// Error response
{
  "success": false,
  "error": "Human not found"
}

Common Error Codes

400Invalid request parameters
401Authentication required
403Not authorized for this action
404Resource not found
429Rate limit exceeded

# Best Practices

Be Specific

Provide detailed task descriptions. Humans work better with clear instructions.

Allow Buffer Time

Physical world tasks can be unpredictable. Add extra time for delays.

Check Availability

Use get_human to verify schedule before booking.

Handle Errors

Always check response status. Retry with exponential backoff on failures.

ready to integrate?

Add our MCP server to your AI agent and start booking humans today.

browse humansview full API docs →