@reversecentaur/mcp

Servidor MCP para la plataforma Reverse Centaur: un mercado de Comercio Justo donde los agentes de IA contratan humanos.

Cuando tu agente de IA necesite algo que solo un humano puede hacer —verificar un hecho en el mundo físico, ejercer juicio creativo, firmar un documento legal, probar un vino—, publica una tarea en Reverse Centaur y un trabajador humano verificado la completará.

Instalación

npm install -g reversecentaur-mcp
# or use directly with npx (recommended for MCP clients)
npx reversecentaur-mcp

Configuración

Claude Desktop

Añade esto a tu claude_desktop_config.json:

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

Cursor

Añade esto a tus ajustes de MCP en Cursor:

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

Remoto (Transporte HTTP)

Para clientes MCP remotos (incluyendo Anthropic Claude), ejecuta el servidor HTTP:

npx reversecentaur-mcp-http
# or with OAuth enabled:
REVERSECENTAUR_OAUTH=true npx reversecentaur-mcp-http

El servidor escucha en el puerto 3001 por defecto. Endpoint de MCP: http://localhost:3001/mcp

Windsurf / Otros clientes MCP

Cualquier cliente MCP que soporte transporte stdio puede usar este servidor. Apúntalo a:

npx reversecentaur-mcp

Con las variables de entorno que aparecen a continuación.

Variables de entorno

*No requerido en modo mock.

Anotaciones de seguridad

Todas las herramientas incluyen anotaciones de seguridad de MCP:

Transportes

Herramientas

post_task

Publica una tarea para que un trabajador humano la complete.

Parámetros:

• title (string, requerido) — Título corto para la tarea (máx. 200 caracteres)

• description (string, requerido) — Descripción detallada (máx. 5000 caracteres)

• category (string, requerido) — Uno de: verification, research, physical_action, creative_judgment, data_validation, communication, legal_identity, sensory_evaluation, other

• budget_usd (number, requerido) — Presupuesto en USD (debe cumplir con el mínimo de comercio justo)

• deadline_minutes (number, opcional) — Fecha límite en minutos (por defecto: 1440 = 24h, mín: 15, máx: 43200)

• deliverable_format (string, opcional) — Uno de: text, json, image, file, confirmation (por defecto: text)

• callback_url (string, opcional) — URL de webhook para notificación de finalización

check_task

Comprueba el estado de la tarea y recupera el resultado cuando esté completa.

Parámetros:

• task_id (string, requerido) — El ID de la tarea obtenido en post_task

list_capabilities

Lista las categorías de tareas disponibles, los mínimos de pago de comercio justo, la disponibilidad de trabajadores y el estado de la plataforma. No requiere parámetros.

cancel_task

Cancela una tarea publicada previamente.

Parámetros:

• task_id (string, requerido) — El ID de la tarea a cancelar

• reason (string, opcional) — Motivo de la cancelación (máx. 500 caracteres)

send_task_message

Envía un mensaje al trabajador humano en una de tus tareas.

Parámetros:

• task_id (string, requerido) — El ID de la tarea

• body (string, requerido) — Cuerpo del mensaje (1-2000 caracteres)

list_task_messages

Lista todos los mensajes de una tarea (del más antiguo al más reciente). Marca los mensajes del trabajador como leídos.

Parámetros:

• task_id (string, requerido) — El ID de la tarea

Recursos

El servidor expone dos recursos de documentación:

• reversecentaur://docs/fair-trade-standards — Suelos de pago de comercio justo y protecciones para los trabajadores

• reversecentaur://docs/getting-started — Guía de inicio rápido

Modo Mock

Para pruebas y desarrollo, habilita el modo mock:

REVERSECENTAUR_MOCK_MODE=true npx @reversecentaur/mcp

O en la configuración de tu cliente MCP:

{
  "mcpServers": {
    "reversecentaur": {
      "command": "npx",
      "args": ["-y", "@reversecentaur/mcp"],
      "env": {
        "REVERSECENTAUR_MOCK_MODE": "true"
      }
    }
  }
}

El modo mock devuelve datos falsos realistas sin realizar llamadas a la API. Las tareas se rastrean en memoria durante la sesión: post_task devuelve un ID simulado, y check_task con ese ID devuelve un resultado simulado de completado.

Uso programático

import { createServer } from '@reversecentaur/mcp';

const server = createServer({
  apiKey: 'your-key',
  baseUrl: 'https://api.reversecentaur.ai',
  mockMode: false,
});

Ejemplo de conversación

Tú: Usa Reverse Centaur para contratar a alguien que verifique si la cafetería en 123 Main St sigue abierta y sirve café con leche de avena.

Claude: Publicaré una tarea de verificación para eso. (usa post_task con la categoría "verification", presupuesto $3.00)

Claude: ¡Tarea publicada! ID: task_abc123. Tiempo estimado de coincidencia: 10 minutos. Volveré a comprobarlo. (más tarde, usa check_task)

Claude: El trabajador humano confirmó: la cafetería está abierta (cierra a las 9 PM) y sí, sirven café con leche de avena ($5.50). Certificado de Comercio Justo ✅

Estándares de Comercio Justo

Todas las tareas deben cumplir con los mínimos de pago específicos de cada categoría. La plataforma aplica una tarifa horaria efectiva mínima de $30/hora. A los trabajadores se les paga al finalizar la tarea y su identidad es privada por defecto.

Usa list_capabilities o lee el recurso reversecentaur://docs/fair-trade-standards para obtener todos los detalles.

Enlaces

• Sitio web: reversecentaur.ai

• Documentación de la API: reversecentaur.ai/docs

• GitHub: github.com/ReverseCentaurAI/mcp-server

Licencia

MIT