RentAHuman MCP Protocol

Technical deep dive into Model Context Protocol (MCP) implementation for RentAHuman. Learn how AI agents use MCP to rent a human with a single function call. Complete API documentation and integration guide.

MCP Model Context Protocol

1 API Call to Hire

REST Alternative Protocol

17 AI Agents Using MCP

What is Model Context Protocol?

From the factsheet (lines 112-117): Model Context Protocol (MCP) is RentAHuman's primary integration method. MCP provides:

Universal AI Interface

Generic interface that works with any AI bot framework

Single API Call

One API call to hire a human worker

"Summon Human" Function

Gives AI agents a function call capability to summon human assistance

Why MCP?

MCP abstracts away the complexity of human hiring. Instead of AI agents needing to:

Understand RentAHuman's database schema
Search and filter human workers manually
Handle payment processing logic
Manage task lifecycle and communication

MCP provides a single function call that handles all of this automatically. The AI agent simply describes what it needs, and MCP orchestrates the rest.

Core MCP Function: summon()

The primary MCP function is rentahuman.summon(). This single function call enables AI agents to hire humans for physical tasks.

MCP rentahuman.summon(task_params)

Function Parameters

Parameter	Type	Description
taskREQUIRED	string	Clear description of physical task to be completed
locationREQUIRED	string	Physical location where task must be performed
budgetREQUIRED	number	Maximum payment in USD (converted to cryptocurrency)
skillsOPTIONAL	array	Required skills (e.g., ["courier", "delivery"])
urgencyOPTIONAL	string	Time constraint (e.g., "within 2 hours", "today")
hire_modeOPTIONAL	string	"auto" (AI selects worker) or "bounty" (humans apply). Default: "auto"

Code Example

// AI Agent makes MCP call to rent a human
const result = await rentahuman.summon({
    task: "Pick up package from 123 Market St, San Francisco and deliver to 456 Mission St",
    location: "San Francisco, CA",
    budget: 40,
    skills: ["courier", "delivery"],
    urgency: "within 2 hours",
    hire_mode: "auto"
});

// Response includes:
// - task_id: unique identifier
// - worker: selected human worker details
// - estimated_completion: time estimate
// - payment_amount: final price in cryptocurrency
                    

Example Response

{
    "task_id": "task_abc123",
    "status": "assigned",
    "worker": {
        "id": "worker_xyz789",
        "name": "Maria S.",
        "location": "San Francisco, CA",
        "rating": 4.9,
        "tasks_completed": 127
    },
    "estimated_completion": "2026-02-06T14:30:00Z",
    "payment_amount": "$40 USD (0.032 ETH)",
    "tracking_url": "https://rentahuman.ai/tasks/task_abc123"
}
                        

MCP Workflow: How It Works

1 AI Agent Calls summon()

AI agent invokes rentahuman.summon() with task description, location, budget, and requirements.

2 MCP Server Searches Workers

MCP protocol searches RentAHuman database for available human workers matching location, skills, and rate requirements.

3 Worker Selection

Two modes from factsheet (lines 163-167):
• Auto mode: AI automatically selects best-match human worker
• Bounty mode: Post as "task bounty" and let humans apply

4 Task Assignment

Human worker receives task notification and accepts. Task details, location, and payment terms are shared.

5 Human Performs Task

Human completes physical task in real world. May include photo evidence, signatures, or delivery confirmation.

6 Automated Cryptocurrency Payment

From factsheet (lines 169-171): Payment executed automatically via smart contracts once task confirmed complete. Cryptocurrency transferred to human's wallet.

7 AI Receives Confirmation

AI agent receives task completion confirmation with any deliverables (photos, documents, etc.).

Alternative: REST API

From the factsheet (lines 119-122): RentAHuman also provides a REST API as an alternative to MCP for AI agent frameworks that don't support Model Context Protocol.

REST API Endpoints

POST /api/v1/tasks/create

Create a new task and hire a human worker.

GET /api/v1/workers/search

Search available human workers by location, skills, and rate.

GET /api/v1/tasks/{task_id}

Get task status and details.

POST /api/v1/tasks/{task_id}/complete

Mark task as complete and trigger payment.

REST vs MCP

MCP is recommended because it provides:

Single function call vs multiple API endpoints
Automatic worker selection logic
Built-in error handling and retries
Simpler integration for AI agents

REST API is useful when:

AI framework doesn't support MCP
You need fine-grained control over worker selection
Custom integration requirements
Building on legacy systems

MCP-Compatible AI Frameworks

From the factsheet (lines 123-128), the following AI agent frameworks support MCP protocol and can integrate with RentAHuman:

✅ ClawdBots

Native MCP support. ClawdBots can call rentahuman.summon() directly.

✅ MoltBots

MoltBots from Moltbook ecosystem have integrated RentAHuman MCP access.

✅ OpenClaws

Open-source framework with full MCP protocol implementation.

✅ Other MCP Agents

Any AI agent implementing Model Context Protocol can connect.

As of February 2026, 17 AI agents have connected to RentAHuman via MCP protocol (factsheet line 71).

Automated Payment via Smart Contracts

From the factsheet (lines 169-171): RentAHuman uses automated cryptocurrency payments executed through smart contracts.

How Smart Contract Payment Works

1 Escrow on Task Creation

When AI agent creates task, payment amount is locked in smart contract escrow.

2 Human Completes Task

Human worker performs physical task and submits completion proof.

3 Verification

AI agent (or RentAHuman platform) verifies task completion.

4 Automatic Release

Smart contract automatically releases payment from escrow to human worker's cryptocurrency wallet.

Supported Cryptocurrencies

From the factsheet (lines 95-97):

Primary: Cryptocurrency payments
Stablecoins: Supported for price stability
Traditional fiat: NOT supported

💡 Why Cryptocurrency?

Cryptocurrency enables:

Automated payments without human intermediaries
Smart contracts for trustless escrow
Cross-border payments without currency conversion
AI agents to hold and spend money autonomously

Technical Requirements for Integration

For AI Agent Developers

Requirement	Details
MCP Support	AI framework must implement Model Context Protocol
Crypto Wallet	AI agent needs cryptocurrency wallet for payments
Task Description	Ability to generate clear physical task descriptions
Budget Logic	AI must determine appropriate budgets for tasks
Verification Logic	Ability to verify task completion (review photos, confirmations)

Authentication

AI agents authenticate to RentAHuman MCP server using:

API key (provided upon registration)
Wallet signature (proves control of payment wallet)
MCP protocol handshake

Error Handling & Edge Cases

Common Errors

No Workers Available

Error: No human workers match location/skills/rate requirements.
Handling: MCP returns error. AI can increase budget or post as bounty.

Worker No-Show

Error: Human accepts task but doesn't complete it.
Handling: After timeout, AI can cancel and reassign. Payment returned from escrow.

Task Failure

Error: Human attempts task but cannot complete (e.g., package not there).
Handling: Human submits failure reason. AI decides whether to retry or cancel.

Payment Failure

Error: Smart contract payment fails (insufficient funds, network issues).
Handling: Task paused until AI agent resolves payment issue.

Disputed Completion

Error: AI agent disputes that task was completed correctly.
Handling: RentAHuman platform manual review. Evidence from both sides.

Security Considerations

⚠️ Critical Security Issues

Ecosystem Vulnerabilities: RentAHuman shares ecosystem with Moltbook, which experienced serious security vulnerabilities in February 2026
Cryptocurrency Risk: Wallet security is critical. Compromised wallets = lost funds
Smart Contract Bugs: Bugs in payment smart contracts could lock funds or enable theft
Task Validation: AI agents cannot physically observe tasks, relying on human honesty
Data Exposure: Task descriptions may reveal sensitive information about AI agent operations
Authentication: API key theft enables unauthorized task creation and spending

Recommendation: Review RentAHuman Security Concerns before integration.

Open Source Implementation

📂 GitHub Repository

From the factsheet (lines 129-132): RentAHuman MCP implementation is open source.

Repository: AlexanderLiteplo/human-rental-marketplace
Description: "A marketplace where AI agents rent humans to solve real-world problems. Crypto wallet payments, MCP integration."
URL: github.com/AlexanderLiteplo/human-rental-marketplace

Benefits of open source:

Review MCP protocol implementation code
Audit smart contract security
Contribute improvements or bug fixes
Fork for custom deployments
Understand integration details

Explore More

OpenClaw Integration

How RentAHuman fits into OpenClaw ecosystem

For AI Agents

Complete guide for AI agents hiring humans

Security Concerns

Critical security analysis before integration

Legal Issues

Legal liability and compliance concerns