Servidor MCP

El servidor MCP de Fulfy Plus permite que un asistente de IA cotice envíos dentro de Venezuela y consulte los datos geográficos de un punto. MCP (Model Context Protocol) es el estándar con el que los asistentes usan herramientas externas.

No necesitas cuenta ni API key. El servidor solo consulta: no crea órdenes ni guías. Para emitir guías usa la API con tu API key.

Dirección del servidor

https://api.fulfyplus.com/api/v1/mcp

Es un servidor remoto con transporte HTTP (Streamable HTTP).

Cómo conectarlo

En tu asistente, busca la opción para agregar un conector o servidor MCP remoto y pega la dirección. Si tu cliente usa un archivo de configuración, este es el formato habitual:

{
  "mcpServers": {
    "fulfy-plus": {
      "type": "http",
      "url": "https://api.fulfyplus.com/api/v1/mcp"
    }
  }
}

El nombre de los campos puede variar según el cliente.

Herramientas

Herramienta	Para qué sirve	Datos que recibe
quote_shipment	Cotiza un envío con los transportistas aliados y devuelve las opciones y precios	origin_latitude, origin_longitude, destination_latitude, destination_longitude, weight_kg. Opcionales: declared_value_ves (valor declarado en Bs.), height_cm, width_cm, length_cm
get_location	Devuelve país, estado, municipio, parroquia y códigos postales de un punto	latitude, longitude
get_cities	Devuelve estado, municipio y parroquia de un punto, y las ciudades posibles con su id	latitude, longitude

Las coordenadas son latitud y longitud en grados decimales (WGS 84, GPS) y deben estar dentro de Venezuela.

Ejemplo

Pídele esto a tu asistente:

Con Fulfy Plus, cotiza un paquete de 2 kg desde Caracas hasta Maracaibo con valor declarado de 50.000 Bs.

El asistente llama a quote_shipment con estos datos:

{
  "origin_latitude": 10.4806,
  "origin_longitude": -66.9036,
  "destination_latitude": 10.6427,
  "destination_longitude": -71.6125,
  "weight_kg": 2,
  "declared_value_ves": 50000
}

Preguntas frecuentes

¿Puedo crear guías desde el servidor MCP? No. Para crear guías usa el panel o la API.

¿Fulfy transporta el paquete? No. Fulfy Plus es una plataforma logística: el envío lo hacen los transportistas aliados.

¿Hay límites de uso? Sí. El servidor aplica límites de uso; si los excedes, recibirás un error con su propio código.

---

Relacionado: Guía para Integradores · Modalidades de entrega · Valor declarado mínimo