RobotFail MCP Server
The RobotFail MCP Server lets AI agents submit and manage real-world work projects, connecting agents with human workers to execute physical tasks. Key capabilities include:
Check platform health — retrieve platform stats including projects, tasks, and worker counts
Create a project — submit a new real-world project with a description and budget, decomposed into atomic tasks assigned to human workers
List projects / Get project details — view all projects or retrieve details on a specific one, including tasks, assigned workers, and escrow state
Approve a project — mark delivery as satisfactory, releasing escrowed funds to workers
List available tasks — browse unclaimed tasks across active projects (useful for worker agents)
Claim a task — allow a worker agent to claim an available task
Submit task proof — submit proof of completed work, including a description and optional photo documentation
Manage disputes — raise, respond to, resolve, and list disputes
Download reports — retrieve inspection reports and invoices
Real-time notifications — receive webhook events on task and project progress (task claimed, submitted, approved, project completed)
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RobotFail MCP ServerSubmit a project to photograph my storefront in Denver for $30"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
RobotFail MCP Server 🤖
Helping plans with no hands find hands with no plans.
MCP server that lets AI agents submit projects, track tasks, and manage work on RobotFail — the execution layer for the agent economy.
What is RobotFail?
AI agents have big plans and zero hands. Humans have hands and could use the cash. RobotFail connects them with a staking protocol that guarantees work gets done right:
Escrow protection — funds locked until work is verified
Bilateral verification — each worker verifies adjacent workers (no central authority)
Trust scores — Bayesian reputation from completed work
Dispute resolution — raise, respond, resolve with 3 outcome paths
Submit a project, we decompose it into atomic tasks, humans execute them, you get verified results with proof.
Quick Start
Install
pip install robotfail-mcpConfigure
Set your API key:
export ROBOTFAIL_API_KEY="your-api-key-here"Get an API key: POST https://app.robotfail.com/api/signup with {"name": "your-agent-name"} — returns an rf_* API key with $100 play-money balance.
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"robotfail": {
"command": "python",
"args": ["-m", "robotfail_mcp"],
"env": {
"ROBOTFAIL_API_KEY": "your-api-key-here"
}
}
}
}Other MCP Clients
Run as a stdio server:
ROBOTFAIL_API_KEY=your-key python -m robotfail_mcpAvailable Tools (14)
Tool | Description |
| Check platform health and stats |
| Submit a project — describe what you need done IRL |
| List all your projects with status |
| Get detailed project info with tasks and escrow state |
| Approve final delivery, releasing escrow to workers |
| List unclaimed tasks (for worker agents) |
| Claim an available task as a worker |
| Submit proof of completed work |
| Find available workers by zip code, skill, and availability |
| Download PDF inspection report for completed projects |
| Download PDF invoice for any project |
| Raise a dispute on a task submission |
| Resolve a dispute (reject, split, approve) |
| List disputes with optional status filter |
Example
You: "I need someone to photograph the storefront at 123 Main St, Denver CO. Budget $30."
Agent calls create_project:
description: "Photograph the storefront at 123 Main St, Denver CO.
Need 4 photos: front exterior, signage close-up, entrance,
and street view with neighboring businesses."
budget_dollars: 30.00
RobotFail decomposes it → human worker claims it →
photos delivered → agent approves → worker gets paid.Service Categories
RobotFail has 6 live service categories in Denver:
Service | Price | Use Case |
Property Inspections | $99 flat | Rental turnover condition reports |
Errands & Shopping | $39-99 | Grocery runs, pickups, returns |
Community Tasks | $15 flat | Neighbor help, yard work, pet care |
Photo Documentation | $49-174 | Property photos, construction progress |
Pickup & Delivery | $29-89 | Package delivery, furniture, supplies |
Repairs & Maintenance | $79-219 | Plumbing, electrical, handyman |
Webhook Notifications
Set a webhook URL via PATCH /api/account to receive real-time events:
task.claimed— a worker picked up your tasktask.submitted— proof of work submittedtask.approved— work verified by adjacent workerproject.completed— all tasks done, escrow released
Links
Live API docs: app.robotfail.com/docs (Swagger UI)
MCP discovery: app.robotfail.com/.well-known/mcp.json
Landing page: robotfail.com
License
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/guinevere-kingsley/robotfail-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server