Reversecentaur Mcp

io.github.brandonbgreenPublished by GitHub account brandonbgreenv0.1.1Updated Oct 24, 2026

Hire humans for tasks AI can't do. Fair trade pay floors, prepaid escrow, ethical receipts.

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Lets an assistant outsource real-world tasks to vetted human workers, with escrowed USD budgets, pay floors and status tracking.

What you can do
  • Post tasks for human workers with category, budget, deadline and deliverable format
  • Check task status and retrieve the completed result
  • List task categories, fair-trade pay minimums and worker availability
  • Cancel a posted task with an optional reason
  • Send messages to the assigned worker and list task messages
  • Read bundled fair-trade standards and getting-started documentation resources
When to use it
Useful when an assistant needs something only a person can do in the physical world — verifying a fact on site, exercising creative judgment, signing a document or tasting something — and you want that work posted, tracked and paid through one platform.
Requirements
Runs locally via npx (Node.js) over stdio, or as a local HTTP server on port 3001. Requires a Reverse Centaur account and the REVERSECENTAUR_API_KEY environment variable; optional REVERSECENTAUR_API_URL, REVERSECENTAUR_MOCK_MODE, REVERSECENTAUR_OAUTH, PORT and MCP_PUBLIC_URL. Network access to the Reverse Centaur API.
Before you install
Posting a task deducts funds from your account and cancelling may incur fees, so budgets and deadlines should be confirmed before the assistant acts. The API key is a billable credential and should be kept out of shared configs. Task descriptions, messages and optional callback URLs are sent to a third-party platform and to human workers; worker identity is private by default.

Installation

In SourceWeft

  1. Open Reversecentaur Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

reversecentaur-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

bash
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:

json
{  "mcpServers": {    "reversecentaur": {      "command": "npx",      "args": ["-y", "@reversecentaur/mcp"],      "env": {        "REVERSECENTAUR_API_KEY": "your-api-key-here"      }    }  }}

Cursor

Add to your Cursor MCP settings:

json
{  "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:

bash
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:

bash
npx reversecentaur-mcp

With the environment variables below.

Environment Variables

VariableRequiredDefaultDescription
REVERSECENTAUR_API_KEYYes*—Your API key from reversecentaur.ai
REVERSECENTAUR_API_URLNohttps://api.reversecentaur.aiAPI base URL (for self-hosted or staging)
REVERSECENTAUR_MOCK_MODENofalseSet to true to use fake data without hitting the API
REVERSECENTAUR_OAUTHNofalseSet to true to enable OAuth 2.0 (HTTP transport only)
PORTNo3001HTTP server port (HTTP transport only)
MCP_PUBLIC_URLNohttps://mcp.reversecentaur.aiPublic HTTPS URL for OAuth metadata

*Not required in mock mode.

Safety Annotations

All tools include MCP safety annotations:

ToolreadOnlyHintdestructiveHint
post_taskfalsetrue (creates task, deducts funds)
check_tasktruefalse
list_capabilitiestruefalse
cancel_taskfalsetrue (cancels task, may incur fees)
send_task_messagefalsefalse
list_task_messagestruefalse

Transports

TransportCommandUse Case
stdionpx reversecentaur-mcpClaude Desktop, Cursor, local MCP clients
Streamable HTTPnpx reversecentaur-mcp-httpRemote 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, other
  • budget_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 from post_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 cancel
  • reason (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 ID
  • body (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 protections
  • reversecentaur://docs/getting-started — Quick start guide

Mock Mode

For testing and development, enable mock mode:

bash
REVERSECENTAUR_MOCK_MODE=true npx @reversecentaur/mcp

Or in your MCP client config:

json
{  "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

typescript
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_task with category "verification", budget $3.00)

Claude: Task posted! ID: task_abc123. Estimated match time: 10 minutes. I'll check back. (later, uses check_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

License

MIT

Source: README.md at commit 8b50835

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts