⚡ Soyla MCP Server

Conectá Soyla a cualquier cliente MCP (Claude Desktop, Cursor, scripts de IA) y operá el marketplace directamente desde tu agente.

Conexión rápida

Agregá Soyla a Claude Desktop con un solo comando:

claude mcp add soyla https://soyla.app/api/mcp

O configuralo manualmente en tu cliente MCP apuntando el endpoint a:

https://soyla.app/api/mcp

Discovery en /.well-known/mcp.json · Protocolo MCP 2025-03-26 · JSON-RPC 2.0 over HTTP

Herramientas disponibles

listar_categorias Público
Devuelve todas las categorías de servicios de Soyla.
buscar_tareas Público
Busca tareas abiertas filtrando por categoría, precio mínimo/máximo y límite de resultados.
ver_tarea Público
Obtiene el detalle de una tarea específica por su ID.
ver_perfil Público
Perfil público de un colaborador: nombre, especialidad, Vibe Score, verificación.
publicar_tarea API Key
Publica una nueva tarea. Requiere API key en header Authorization.
ver_mis_tareas API Key
Lista tus tareas publicadas con todos sus estados.
ver_mis_contratos API Key
Lista tus contratos activos como contratante o colaborador.

Autenticación con API Key

Las herramientas marcadas con API Key requieren un token de acceso. Para generarlo:

1. Entrá a soyla.app/app/#seguridad
2. Bajá a la sección API Keys
3. Hacé click en Generar nueva key, dale un nombre y copiá el token (se muestra una sola vez)

Luego pasá el token en cada request:

Authorization: Bearer sk_soyla_tu_token_aqui
⚠️ Guardá tu API key en un lugar seguro. Si la perdés, tenés que generar una nueva y revocar la anterior.

Límites de uso

60 / min
Herramientas públicas (por IP)
30 / min
Herramientas con API key

Respuestas 429 incluyen el header Retry-After: 60.

Ejemplo de uso con curl

curl -X POST https://soyla.app/api/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "buscar_tareas", "arguments": { "categoria": "Tecnologia", "limite": 5 } }, "id": 1 }'

🧪 Entorno de Sandbox (Pruebas)

Para desarrollar y validar agentes de IA de forma segura sin publicar tareas reales ni debitar fondos, podés generar una API Key de Sandbox en soyla.app/app/#seguridad seleccionando el entorno "Sandbox (Pruebas)".

Las keys de sandbox comienzan con sk_test_ y son aceptadas por todos los endpoints de MCP. Cuando ejecutás operaciones de escritura (como publicar_tarea) con una key de prueba, el servidor responde con una simulación completa con estado sandbox_simulated, permitiendo a tus agentes verificar sus flujos de decisión y prompts sin afectar datos reales:

curl -X POST https://soyla.app/api/mcp \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk_test_TU_KEY_DE_PRUEBA" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "publicar_tarea", "arguments": { "titulo": "[TEST] Auditoria de accesibilidad web", "descripcion": "Revision tecnica de contraste y WCAG en checkout", "precio": 45000, "categoria": "Soporte Tecnico" } }, "id": "test-req-1" }'
💡 El entorno Sandbox no altera la base de datos de producción y cuenta con los mismos límites de rate limiting (30 req/min).