Referencia de herramientas MCP

Esta página documenta cada herramienta expuesta por quikly-mcp-server. Cada herramienta corresponde a un endpoint de la API REST — el servidor MCP se encarga de la autenticación y el formato de las solicitudes por ti.

quikly_me

Obtiene el perfil del usuario autenticado actual. Equivalente de API: GET /me Parámetros: Ninguno Ejemplo de uso:

“Verifica mi perfil de Quikly”

Respuesta:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "email": "dev@youragency.com",
  "name": "Alex Torres",
  "subscription_tier": "pro",
  "created_at": "2026-01-15T10:30:00Z"
}

Usa esta herramienta para verificar que la conexión MCP funciona y para comprobar tu tier de suscripción antes de crear propuestas.

quikly_create_proposal

Crea una nueva propuesta con detalles del proyecto y requerimientos. Equivalente de API: POST /proposals Parámetros:

string

requerido

Nombre del proyecto (ej., “Plataforma E-commerce - Acme Corp”).

string

Nombre del cliente o empresa.

array

Lista de requerimientos. Cada requerimiento es un objeto con:

Mostrar Campos del requerimiento

string

requerido

Nombre corto del requerimiento (ej., “Autenticación de usuarios”).

string

Descripción detallada de lo que se necesita construir.

number

Story points: 1 (trivial), 3 (pequeño), 5 (mediano) o 8 (grande).

string

Nivel de prioridad: high, medium o low.

number

requerido

Tu tarifa por hora para este proyecto.

string

predeterminado:"USD"

Código de moneda (ej., USD, EUR, ARS).

Ejemplo de uso:

“Crea una propuesta para la plataforma de e-commerce de Acme Corp. Requerimientos: autenticación de usuarios (complejidad 5, prioridad alta), catálogo de productos (complejidad 8, alta), carrito de compras (complejidad 5, media), checkout con Stripe (complejidad 5, alta). Mi tarifa es $85/hora USD.”

Respuesta: Objeto completo de la propuesta incluyendo id, totales calculados, días estimados y toda la configuración.

quikly_analyze_brief

Analiza un brief de proyecto sin procesar y extrae requerimientos estructurados usando IA. Equivalente de API: POST /ai/analyze-brief Parámetros:

string

requerido

El texto del brief del proyecto. Puede ser un documento formal, notas de reunión, un email o incluso un hilo desordenado de Slack.

string

predeterminado:"en"

Idioma para la salida: en o es.

Ejemplo de uso:

“Analiza este brief: ‘Necesitamos una app móvil para nuestra cadena de restaurantes. Los clientes deben poder navegar el menú, hacer pedidos para retiro o delivery, pagar con Apple Pay o tarjeta de crédito, y acumular puntos de lealtad. Tenemos 45 locales en Texas. Necesitamos integración con nuestro sistema Square POS existente. Fecha de lanzamiento objetivo es Q3 2026.’”

Respuesta:

{
  "success": true,
  "requirements": [
    {
      "id": "req_1",
      "name": "Menu browsing",
      "description": "Customers browse restaurant menu with categories, item details, photos, and dietary filters.",
      "complexity": 3,
      "priority": "high",
      "rationale": "Core feature — primary interaction point for all users."
    },
    {
      "id": "req_2",
      "name": "Order placement (pickup & delivery)",
      "description": "Place orders for pickup or delivery with location selection across 45 locations, estimated times, and order tracking.",
      "complexity": 8,
      "priority": "high",
      "rationale": "Multi-location delivery adds complexity for routing and availability."
    },
    {
      "id": "req_3",
      "name": "Payment processing",
      "description": "Apple Pay and credit card payments with tokenized processing and PCI compliance.",
      "complexity": 5,
      "priority": "high",
      "rationale": "Payment is critical path. Apple Pay integration adds native SDK work."
    },
    {
      "id": "req_4",
      "name": "Loyalty program",
      "description": "Points-based loyalty system with earning rules, redemption, and tier levels.",
      "complexity": 5,
      "priority": "medium",
      "rationale": "Drives retention but can launch with basic version."
    },
    {
      "id": "req_5",
      "name": "Square POS integration",
      "description": "Two-way sync with Square POS for menu, orders, and inventory across 45 locations.",
      "complexity": 8,
      "priority": "high",
      "rationale": "Third-party integration with multi-location sync is high risk and high effort."
    }
  ]
}

Después de analizar, puedes pasar estos requerimientos directamente a quikly_create_proposal.

quikly_recommend_rate

Obtiene una recomendación de tarifa impulsada por IA basada en rol, seniority y ubicación. Equivalente de API: POST /ai/rate-recommendation Parámetros:

string

requerido

Tu rol (ej., “fullstack developer”, “cloud architect”, “data engineer”).

string

requerido

Nivel de seniority: junior, mid, senior, lead o principal.

string

requerido

Tu ubicación (ej., “Buenos Aires, Argentina”, “Berlin, Germany”, “Austin, TX”).

Ejemplo de uso:

“¿Cuál es la tarifa de mercado para un desarrollador fullstack senior en Madrid, España?”

Respuesta: La IA devuelve una tarifa por hora recomendada con contexto de mercado, incluyendo rangos bajo/mediana/alto para el rol, seniority y región especificados.

quikly_get_proposal

Recupera una propuesta por su ID. Equivalente de API: GET /proposals/{id} Parámetros:

string

requerido

El UUID de la propuesta a recuperar.

Ejemplo de uso:

“Obtén los detalles de la propuesta 550e8400-e29b-41d4-a716-446655440000”

Respuesta: Objeto completo de la propuesta incluyendo nombre, cliente, requerimientos, configuración, cálculos, estado y marcas de tiempo.

quikly_share_link

Genera un enlace de compartir para una propuesta para que el cliente pueda verla, aceptarla o rechazarla. Equivalente de API: POST /proposals/{id}/share Parámetros:

string

requerido

El UUID de la propuesta a compartir.

Ejemplo de uso:

“Genera un enlace de compartir para mi propuesta de Acme Corp y envíalo a john@acme.com”

Respuesta:

{
  "share_url": "https://app.getquikly.com/p/abc123token",
  "token": "abc123token",
  "expires_at": "2026-04-18T14:30:00Z",
  "is_new": true
}

El enlace de compartir expira en 15 días. Los clientes pueden ver la propuesta, aceptarla, rechazarla o solicitar revisiones — todo desde ese enlace.

Flujo de trabajo típico

Un patrón común al usar las herramientas MCP de Quikly:

Analizar — usa quikly_analyze_brief para convertir un brief sin procesar en requerimientos estructurados
Presupuestar — usa quikly_recommend_rate para obtener una tarifa por hora calibrada por mercado
Crear — usa quikly_create_proposal con los requerimientos y la tarifa
Revisar — usa quikly_get_proposal para verificar que la propuesta esté correcta
Compartir — usa quikly_share_link para enviarla al cliente

​quikly_me

​quikly_create_proposal

​quikly_analyze_brief

​quikly_recommend_rate

​quikly_get_proposal

​quikly_share_link

​Flujo de trabajo típico

quikly_me

quikly_create_proposal

quikly_analyze_brief

quikly_recommend_rate

quikly_get_proposal

quikly_share_link

Flujo de trabajo típico