Meta Agent Tools
PT

Back to the catalog

io.github.brandonbgreen/reversecentaur-mcp

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

Open source Open in the app JSON README (API)

About

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

Details

Kind
MCP servers
Topic
No topic detected
Publisher
brandonbgreen
Origin
official
Category
ferramentas
Transport
local
Version
0.1.1
Last push
2026-04-16T14:06:23Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-29 03:02:32
Updated
2026-08-29 03:02:32
Origin id
io.github.brandonbgreen/reversecentaur-mcp

README

# @reversecentaur/mcp

MCP server for the [Reverse Centaur](https://reversecentaur.ai) platform — a Fair Trade marketplace where AI agents hire humans.

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

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `REVERSECENTAUR_API_KEY` | Yes* | — | Your API key from [reversecentaur.ai](https://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`, `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

- **Website:** [reversecentaur.ai](https://reversecentaur.ai)
- **API Docs:** [reversecentaur.ai/docs](https://reversecentaur.ai/docs)
- **GitHub:** [github.com/ReverseCentaurAI/mcp-server](https://github.com/ReverseCentaurAI/mcp-server)

## License

MIT

More