Saltar al contenido principal
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:
​
project_name
string
requerido
Nombre del proyecto (ej., “Plataforma E-commerce - Acme Corp”).
​
client_name
string
Nombre del cliente o empresa.
​
requirements
array
Lista de requerimientos. Cada requerimiento es un objeto con:
​
hourly_rate
number
requerido
Tu tarifa por hora para este proyecto.
​
currency
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:
​
brief
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.
​
language
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:
​
role
string
requerido
Tu rol (ej., “fullstack developer”, “cloud architect”, “data engineer”).
​
seniority
string
requerido
Nivel de seniority: junior, mid, senior, lead o principal.
​
location
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:
​
proposal_id
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.
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:
​
proposal_id
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:
  1. Analizar — usa quikly_analyze_brief para convertir un brief sin procesar en requerimientos estructurados
  2. Presupuestar — usa quikly_recommend_rate para obtener una tarifa por hora calibrada por mercado
  3. Crear — usa quikly_create_proposal con los requerimientos y la tarifa
  4. Revisar — usa quikly_get_proposal para verificar que la propuesta esté correcta
  5. Compartir — usa quikly_share_link para enviarla al cliente