Allows AI agents to hire human workers for real-world tasks like physical verification, creative judgment, and legal signing.
Also known as ReverseCentaurAI/mcp-server, mcp-server
- Stars
- 0
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Sep 18, 2026
- License
- MIT
What is Reverse Centaur MCP?
Reverse Centaur allows AI agents to hire human workers for real-world tasks like physical verification, creative judgment, and legal signing. It exposes 10 tools, such as title, description, category.
Summary generated from the project's README
About Reverse Centaur MCP server
Connecting AI agents to human workers for physical or subjective tasks is what reversecentaur-mcp enables. Developers can use this server to bridge the gap between digital intelligence and the real world, allowing agents to request help with things like verifying physical locations, exercising creative judgment, or signing legal documents. It works via stdio for local clients like Claude Desktop and Cursor, or through an HTTP transport for remote clients and web-based environments.
Setting up the server requires a REVERSECENTAUR_API_KEY and can be run using npx. The system includes built-in protections such as a server-enforced pay floor and an escrow system that ensures workers are paid even if an agent disconnects. Users can manage the lifecycle of a request through specific tools like post_task, check_task, and cancel_task. For testing purposes, a mock mode is available to simulate task completion without making actual API calls or incurring costs.
What you can do with it
- 1Physical world verificationAsk an agent to confirm real-world details like whether a specific business is currently open and what they have in stock.
- 2Executing legal requirementsInstruct an AI to hire a person to handle the signing of official documents.
- 3Obtaining sensory feedbackRequest a human to perform a subjective evaluation, such as tasting a product.
- 4Managing task communicationDirect an AI to send specific instructions or messages to a human worker during an active assignment.
Written from the project's README. Every use case is checked against a quote from it.
How to install Reverse Centaur MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Reverse Centaur MCP in Claude Code
$ claude mcp add --env 'REVERSECENTAUR_API_KEY=<YOUR_REVERSECENTAUR_API_KEY>' mcp-server -- npx -y reversecentaur-mcpInstall Reverse Centaur MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"reversecentaur-mcp"
],
"env": {
"REVERSECENTAUR_API_KEY": "<YOUR_REVERSECENTAUR_API_KEY>"
}
}
}
}Install Reverse Centaur MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"reversecentaur-mcp"
],
"env": {
"REVERSECENTAUR_API_KEY": "<YOUR_REVERSECENTAUR_API_KEY>"
}
}
}
}Install Reverse Centaur MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","reversecentaur-mcp"],"env":{"REVERSECENTAUR_API_KEY":"<YOUR_REVERSECENTAUR_API_KEY>"}}'Install Reverse Centaur MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"reversecentaur-mcp"
],
"env": {
"REVERSECENTAUR_API_KEY": "<YOUR_REVERSECENTAUR_API_KEY>"
}
}
}
}Install Reverse Centaur MCP in Codex
$ codex mcp add mcp-server --env 'REVERSECENTAUR_API_KEY=<YOUR_REVERSECENTAUR_API_KEY>' -- npx -y reversecentaur-mcpInstall Reverse Centaur MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "reversecentaur-mcp"] [mcp_servers.mcp-server.env] REVERSECENTAUR_API_KEY = "<YOUR_REVERSECENTAUR_API_KEY>"
Install Reverse Centaur MCP in Gemini CLI
$ gemini mcp add -s user -e 'REVERSECENTAUR_API_KEY=<YOUR_REVERSECENTAUR_API_KEY>' mcp-server npx -- -y reversecentaur-mcpInstall Reverse Centaur MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"reversecentaur-mcp"
],
"env": {
"REVERSECENTAUR_API_KEY": "<YOUR_REVERSECENTAUR_API_KEY>"
}
}
}
}Reverse Centaur MCP tools 10
Detected from the READMEtitledescriptioncategorybudget_usddeadline_minutesdeliverable_formatcallback_urltask_idreasonbody
| title | — | |
| description | — | |
| category | — | |
| budget_usd | — | |
| deadline_minutes | — | |
| deliverable_format | — | |
| callback_url | — | |
| task_id | — | |
| reason | — | |
| body | — |
Configuration
REVERSECENTAUR_API_KEYRequiredSecretYour API key from reversecentaur.ai
REVERSECENTAUR_API_URLAPI base URL (for self-hosted or staging)
REVERSECENTAUR_MOCK_MODESet to true to use fake data without hitting the API
REVERSECENTAUR_OAUTH
| Name | Description | |
|---|---|---|
| REVERSECENTAUR_API_KEY | Your API key from reversecentaur.ai | RequiredSecret |
| REVERSECENTAUR_API_URL | API base URL (for self-hosted or staging) | |
| REVERSECENTAUR_MOCK_MODE | Set to true to use fake data without hitting the API | |
| REVERSECENTAUR_OAUTH | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablereversecentaurai/mcp-server is public and reachablegithub.com/reversecentaurai/mcp-server ↗Pass
- Package names this repository as its sourcereversecentaur-mcp names reversecentaurai/mcp-server as sourcenpmjs.com/package/reversecentaur-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-18github.com/reversecentaurai/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from reversecentaur-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model10 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubreversecentaur-mcp
AI agents hire humans for real-world tasks. Server-enforced pay floor, escrow that pays the worker if the agent goes dark, every fee on the receipt.
This is the MCP server for Reverse Centaur.
When your AI agent needs something only a human can do — verify a fact in the physical world, exercise creative judgment, sign a legal document, taste a wine — post a task to Reverse Centaur and a vetted human worker will complete it.
Installation
npm install -g reversecentaur-mcp
# or use directly with npx (recommended for MCP clients)
npx reversecentaur-mcp
Configuration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"reversecentaur": {
"command": "npx",
"args": ["-y", "@reversecentaur/mcp"],
"env": {
"REVERSECENTAUR_API_KEY": "your-api-key-here"
}
}
}
}
Cursor
Add to your Cursor MCP settings:
{
"mcpServers": {
"reversecentaur": {
"command": "npx",
"args": ["-y", "@reversecentaur/mcp"],
"env": {
"REVERSECENTAUR_API_KEY": "your-api-key-here"
}
}
}
}
Remote (HTTP Transport)
For remote MCP clients (including Anthropic Claude), run the HTTP server:
npx reversecentaur-mcp-http
# or with OAuth enabled:
REVERSECENTAUR_OAUTH=true npx reversecentaur-mcp-http
The server listens on port 3001 by default. MCP endpoint: http://localhost:3001/mcp
Windsurf / Other MCP Clients
Any MCP client that supports stdio transport can use this server. Point it at:
npx reversecentaur-mcp
With the environment variables below.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
REVERSECENTAUR_API_KEY |
Yes* | — | Your API key from reversecentaur.ai |
REVERSECENTAUR_API_URL |
No | https://api.reversecentaur.ai |
API base URL (for self-hosted or staging) |
REVERSECENTAUR_MOCK_MODE |
No | false |
Set to true to use fake data without hitting the API |
REVERSECENTAUR_OAUTH |
No | false |
Set to true to enable OAuth 2.0 (HTTP transport only) |
PORT |
No | 3001 |
HTTP server port (HTTP transport only) |
MCP_PUBLIC_URL |
No | https://mcp.reversecentaur.ai |
Public HTTPS URL for OAuth metadata |
*Not required in mock mode.
Safety Annotations
All tools include MCP safety annotations:
| Tool | readOnlyHint | destructiveHint |
|---|---|---|
post_task |
false | true (creates task, deducts funds) |
check_task |
true | false |
list_capabilities |
true | false |
cancel_task |
false | true (cancels task, may incur fees) |
send_task_message |
false | false |
list_task_messages |
true | false |
Transports
| Transport | Command | Use Case |
|---|---|---|
| stdio | npx reversecentaur-mcp |
Claude Desktop, Cursor, local MCP clients |
| Streamable HTTP | npx reversecentaur-mcp-http |
Remote clients, Anthropic Claude Directory, web |
Tools
post_task
Post a task for a human worker to complete.
Parameters:
title(string, required) — Short title for the task (max 200 chars)description(string, required) — Detailed description (max 5000 chars)category(string, required) — One of:verification,research,physical_action,creative_judgment,data_validation,communication,legal_identity,sensory_evaluation,otherbudget_usd(number, required) — Budget in USD (must meet fair trade minimum)deadline_minutes(number, optional) — Deadline in minutes (default: 1440 = 24h, min: 15, max: 43200)deliverable_format(string, optional) — One of:text,json,image,file,confirmation(default:text)callback_url(string, optional) — Webhook URL for completion notification
check_task
Check task status and retrieve the result when complete.
Parameters:
task_id(string, required) — The task ID frompost_task
list_capabilities
List available task categories, fair trade pay minimums, worker availability, and platform status. No parameters required.
cancel_task
Cancel a previously posted task.
Parameters:
task_id(string, required) — The task ID to cancelreason(string, optional) — Reason for cancellation (max 500 chars)
send_task_message
Send a message to the human worker on one of your tasks.
Parameters:
task_id(string, required) — The task IDbody(string, required) — Message body (1-2000 chars)
list_task_messages
List all messages on a task (oldest first). Marks worker messages as read.
Parameters:
task_id(string, required) — The task ID
Resources
The server exposes two documentation resources:
reversecentaur://docs/fair-trade-standards— Fair trade pay floors and worker protectionsreversecentaur://docs/getting-started— Quick start guide
Mock Mode
For testing and development, enable mock mode:
REVERSECENTAUR_MOCK_MODE=true npx @reversecentaur/mcp
Or in your MCP client config:
{
"mcpServers": {
"reversecentaur": {
"command": "npx",
"args": ["-y", "@reversecentaur/mcp"],
"env": {
"REVERSECENTAUR_MOCK_MODE": "true"
}
}
}
}
Mock mode returns realistic fake data without making any API calls. Tasks are tracked in memory for the session — post_task returns a mock ID, and check_task with that ID returns a mock completed result.
Programmatic Usage
import { createServer } from '@reversecentaur/mcp';
const server = createServer({
apiKey: 'your-key',
baseUrl: 'https://api.reversecentaur.ai',
mockMode: false,
});
Example Conversation
You: Use Reverse Centaur to hire someone to verify that the café at 123 Main St is still open and serves oat milk lattes.
Claude: I'll post a verification task for that. (uses
post_taskwith category "verification", budget $3.00)Claude: Task posted! ID:
task_abc123. Estimated match time: 10 minutes. I'll check back. (later, usescheck_task)Claude: The human worker confirmed: the café is open (closes at 9 PM) and yes, they serve oat milk lattes ($5.50). Fair Trade certified ✅
Fair Trade Standards
All tasks must meet category-specific pay minimums. The platform enforces a minimum effective hourly rate of $30/hr. Workers are paid on completion, and their identity is private by default.
Use list_capabilities or read the reversecentaur://docs/fair-trade-standards resource for full details.
Links
- Website: reversecentaur.ai
- API Docs: reversecentaur.ai/docs
- GitHub: github.com/ReverseCentaurAI/mcp-server
License
MIT
Reverse Centaur MCP questions
How do I add Reverse Centaur MCP to Claude Code?
Run claude mcp add --env 'REVERSECENTAUR_API_KEY=<YOUR_REVERSECENTAUR_API_KEY>' mcp-server -- npx -y reversecentaur-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Reverse Centaur MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Reverse Centaur MCP provide?
It exposes 10 tools, including title, description, category, budget_usd, deadline_minutes.
What kind of tasks can I hire humans for?
You can post tasks for physical world verification, creative judgment, signing legal documents, sensory evaluation, and more.
Can I test the server without an API key?
Yes, you can enable mock mode to use fake data without hitting the API.
Is my money safe if the AI agent stops working?
The server uses an escrow system that pays the worker even if the agent goes dark.