# Trabajos Online

> Plataforma de freelance en español para publicar proyectos y contratar profesionales.
> Los agentes de IA pueden operar la plataforma vía MCP (Model Context Protocol) o REST API.

## Para agentes de IA

Trabajos Online expone un servidor MCP oficial con 18+ herramientas (publicar empleos, buscar freelancers, enviar propuestas, firmar contratos, gestionar pagos en escrow con Stripe y criptomonedas).

- [Guía de setup MCP](https://trabajosonline.org/mcp-setup) — Instalación para Claude Desktop, Cursor, n8n, etc.
- [Referencia de API](https://trabajosonline.org/api-docs) — Endpoints REST para integraciones sin MCP.
- [OpenAPI spec](https://trabajosonline.org/openapi.json) — Especificación OpenAPI generada desde el servidor MCP.
- [MCP discovery](https://trabajosonline.org/.well-known/mcp.json) — Metadata del endpoint MCP.

## Endpoint MCP

- Worker URL: `https://mcp.trabajosonline.org`
- Cliente oficial: `npx @trabajos-online/mcp-client`
- Autenticación: pairing code (sin API key manual) o `TRABAJOS_API_KEY` en env.

## Flujo de autenticación (pairing code)

1. El agente llama a `getPairingCode` → recibe código tipo `TRB-A3B7`.
2. El usuario introduce el código en `https://trabajosonline.org/settings` (integraciones).
3. El agente llama a `checkPairingStatus` → recibe la API key y queda autenticado.

## Herramientas MCP públicas (sin auth)

- `searchJobs` — Buscar empleos por criterio.
- `getUserProfile` — Perfil de un usuario por email, wallet o `"current"`.
- `getJobApplications` — Candidaturas de un empleo.
- `getContract` — Detalles de un contrato.
- `getConversation` — Mensajes de una sala.
- `getPairingCode` — Iniciar emparejamiento.
- `checkPairingStatus` — Completar emparejamiento.
- `listCategories` — Categorías de empleo.

## Herramientas MCP autenticadas

- `postJob` — Publicar empleo (freelance gratis, salariales con pago).
- `createGig` — Crear servicio/gig.
- `submitProposal` — Enviar propuesta a un empleo.
- `acceptProposal` — Aceptar propuesta y contratar.
- `listActiveContracts` — Contratos activos del usuario.
- `sendMessage` / `listConversations` — Mensajería.
- `createDeposit` / `releasePayment` / `getPaymentStatus` — Escrow/pagos.

## Páginas clave

- [Home](https://trabajosonline.org/)
- [Buscar empleos](https://trabajosonline.org/find-jobs)
- [Freelancers](https://trabajosonline.org/browse-freelancers)
- [Publicar empleo](https://trabajosonline.org/post-job)
- [Términos](https://trabajosonline.org/terms)
- [Privacidad](https://trabajosonline.org/privacy)

## Contacto

- Email: info@trabajosonline.org
- Web: https://trabajosonline.org