ToolYour

Conecta ToolYour a Cursor, Claude Desktop o agentes de IA personalizados mediante MCP.

Conecta solo herramientas respaldadas por API a cualquier cliente MCP a través del servidor MCP remoto de ToolYour: planifica → ejecuta → verifica hasta que pase. Las herramientas solo de sitio web no se exponen.

Relacionado: TypeScript SDK · Mapa de herramientas del SDK · Descubrimiento de MCP · Catálogo de playbooks · Agente SEO · Puerta de lanzamiento · Auditoría de seguridad

Endpoint

https://api.toolyour.com/mcp

SSE (predeterminado para Cursor): GET https://api.toolyour.com/mcp
HTTP transmisible (Smithery y clientes de especificación MCP): POST https://api.toolyour.com/mcp (alias https://api.toolyour.com/mcp/http)

Autenticación

X-Api-Key: ty_your_key_here

Crea claves en el panel de ToolYour.

Bucle canónico del agente

1. plan_task(goal)              → free plan + credit estimate
2. run_playbook or solve_task   → jobReport + loop.remainingFixes + loop.gate
3. Host agent applies fixes in the repo (editor/git — not invoke_tool)
4. verify_task(goal, baseline)  → loop.gate pass|fail; repeat until pass
5. fetch_payload(dataRefId)     → only if you need full raw detail

invoke_tool es avanzado (un operationId explícito). No lo uses como ruta predeterminada para trabajos de puerta de lanzamiento, SEO o seguridad.

No inicies el bucle de verificación a menos que el último resultado de plan_task / solve_task / run_playbook tenga loop.initiate: true. Si es false, el objetivo está fuera de alcance, es un convertidor de un solo uso o MCP no tiene una solución reparable — detente.

O ejecuta una habilidad en un solo paso: run_playbook(skillId, input).

Configuración de Cursor / Claude

{
  "mcpServers": {
    "toolyour": {
      "url": "https://api.toolyour.com/mcp",
      "headers": {
        "X-Api-Key": "ty_YOUR_KEY"
      }
    }
  }
}

npm install @toolyour/sdk

import { toolYourMcpServerConfigJson } from "@toolyour/sdk/mcp";
console.log(toolYourMcpServerConfigJson({ apiKey: process.env.TOOLYOUR_API_KEY! }));

solve_task

Describe el objetivo en lenguaje natural. El servidor elige un flujo de trabajo o herramienta (coincidencia difusa + control de confianza). Los objetivos ambiguos devuelven status: "suggest" (gratis).

• responseMode predeterminado: compact (jobReport sin steps duplicado) más loop (gate, remainingFixes con patchType + acceptance, next)
• Después de la primera ejecución, aplica loop.remainingFixes en el repositorio anfitrión, luego verify_task con este resultado completo como baseline. No hagas invoke_tool para el mismo trabajo.
• responseMode: "full" — incluye cargas útiles de pasos sin procesar
• responseMode: "dataRef" — compacto + almacenamiento TTL; recupera con fetch_payload
• async: true — devuelve { status: "accepted", runId } inmediatamente; siempre consulta get_run. Cuando status sea completed / partial / error, también lee resultStatus (y result.status) — p. ej., suggest, need_input, verified — ejecutar completed solo significa que el trabajo terminó, no que el enrutamiento tuvo éxito. REDIS_URL opcional en MCP habilita get_run entre réplicas. Un webhook opcional del panel (mcp.job.finished) es solo de mejor esfuerzo — los webhooks no configurados o con fallos nunca rompen el trabajo.
• En status: "suggest" / "need_input", lee hint, nextActions y exampleGoals / exampleInput — luego vuelve a llamar con un objetivo más claro o campos faltantes (no inventes operationIds).
• input.html / input.text / input.code local: análisis gratuito a menos que enhance: true
• Carga útil primero: lee los archivos del espacio de trabajo y pasa los contenidos. Incluye input.url solo si el usuario pidió analizar un enlace en vivo/vista previa, o el trabajo no puede ejecutarse sin una búsqueda (PageSpeed, TLS, contenido mixto, encabezados en vivo).

Ejemplo: SEO audit for this HTML con input.html del repositorio — o SEO audit for https://example.com cuando pidieron rastrear una página en vivo.

verify_task

Vuelve a ejecutar el mismo objetivo y devuelve deltas frente a una línea base. La línea base puede ser:

• un resultado previo de solve_task
• verify_task.after de una verificación anterior
• una carga útil de consulta de get_run (usa result anidado)
• un jobReport sin procesar

Admite async: true (consulta get_run de la misma manera). Los fallos de ejecución nueva se propagan como status: error|partial|suggest|… en lugar de afirmar falsamente verified.

Contrato de delta (orientado al harness): delta.status, delta.scoreDeltas, delta.newFindings / resolvedFindings, más:

• delta.remainingFindings — hallazgos abiertos en la ejecución nueva
• delta.remainingFixes / loop.remainingFixes — correcciones clasificadas con patchType (http-header | html | file | config | content | investigate) y acceptance
• delta.nextActions / loop.nextActions — etiquetas ordenadas cortas para el bucle del anfitrión
• delta.gate / loop.gate — pass | fail | unknown (falla si quedan hallazgos de alta gravedad o puntuaciones bajas)

Los agentes anfitriones deben aplicar loop.remainingFixes, luego llamar a verify_task de nuevo hasta loop.gate === "pass" (o aceptar hallazgos residuales de gravedad media/baja según la política).

Ayudante del SDK: @toolyour/sdk (0.1.2+) exporta verifyUntilPass desde @toolyour/sdk/mcp para el mismo bucle en Node/CI. CI también puede ejecutar el script del paquete MCP scripts/ci-ship-gate.mjs (ver CI-AGENT-LOOP.md).

Ver también: documentación del repositorio MCP HARNESS-MIGRATION.md y CI-AGENT-LOOP.md.

Otras meta-herramientas

Herramienta	¿Factura?	Propósito
plan_task	Gratis	Plan + estimación de créditos
run_playbook	Como flujo de trabajo	Habilidad → flujo de trabajo mapeado
verify_task	Como solve_task	Delta frente a línea base (asíncrono opcional)
discover_tools	Gratis	Búsqueda avanzada en catálogo (no es la ruta de trabajo predeterminada)
get_tool_schema	Gratis	Esquema para una herramienta (avanzado)
invoke_tool	Sí	operationId único (avanzado; no predeterminado para lanzamiento/SEO/seguridad)
fetch_payload	Gratis	Carga útil truncada completa
get_run	Gratis	Consulta asíncrona de runId (lee resultStatus)
list_skills / load_skill	Gratis	Playbooks
run_workflow	Sí	ID de flujo de trabajo con nombre

Cuota

La ejecución comparte créditos REST mensuales. Gratis: plan_task, navegación por catálogo, sugerencias sin ejecución, fetch_payload, get_run, contenido local sin enhance.

Ver Uso y planes.

[

Errores

Códigos de estado HTTP comunes para llamadas a la API de herramientas y cómo solucionarlos.

](https://www.toolyour.com/developers/docs/errors)[

Descubrimiento de MCP

Descubrimiento de herramientas eficiente en tokens para agentes de IA — solo herramientas respaldadas por API.

](https://www.toolyour.com/developers/docs/mcp-discovery)