Edamam Remote Food MCP

El MCP remoto de Edamam le brinda a una IA la capacidad de "entender" los alimentos de la misma manera que lo haría un nutricionista, traduciendo descripciones en lenguaje natural, imágenes o códigos de barras en información nutricional y alimentaria estructurada.

Documentación

Las APIs de alimentos están hechas para aplicaciones. MCP las hace útiles en flujos de trabajo de agentes.

Edamam Food MCP convierte la Food Database API en un pequeño conjunto de herramientas amigables para LLMs. El agente mantiene la conversación natural, mientras que el servidor maneja el análisis de alimentos, la resolución de cantidades, la búsqueda por código UPC, el cálculo nutricional y el análisis de platos basado en imágenes.

01

Un solo endpoint para agentes

Usa un único endpoint MCP para initialize, tools/list y tools/call. Sin capa de adaptadores personalizados para cada asistente o herramienta de automatización.

02

Nutrición desde lenguaje natural

Envía frases como "cheddar cheese", "1 cup cooked rice", "200g chicken breast" o un código de barras UPC/EAN.

03

Análisis de imágenes de alimentos

Proporciona una URL pública de imagen o un data URI en base64 y devuelve los alimentos detectados junto con estimaciones nutricionales de la API Vision de Edamam.

El agente pregunta de forma natural. El servidor MCP devuelve nutrición estructurada.

Usuario

Almorcé un chicken enchilada y una French onion soup con una rebanada de pan. ¿Cuántas calorías tiene esto?

Agente

Según los datos nutricionales proporcionados (1 porción completa de cada uno):

Calorías (total del almuerzo)

  • Chicken enchilada (1 pieza): 503.7 kcal
  • French onion soup (1 pieza): 395.6 kcal
  • Pan (1 rebanada): 79.5 kcal

Calorías totales: 978.7 kcal (aprox. 979 kcal)

get_food_nutrition({
  "queries": ["1 chicken enchilada", "1 French onion soup", "1 slice of bread"]
})

Usuario

Dame el desglose de macronutrientes y ¿para qué dietas es adecuado?

Agente

Desglose de macronutrientes (almuerzo completo)

  • Proteínas: 53.0 g
  • Carbohidratos: 81.8 g
  • Grasas: 47.8 g

Adecuación dietética: Mejor para una dieta general omnívora/equilibrada. Esta comida no es una buena opción para dietas keto/bajas en carbohidratos, bajas en grasas, bajas en sodio, veganas, vegetarianas, sin gluten o sin lácteos (incluye trigo/gluten y advertencias de leche en los elementos devueltos).

Demo del asistente nutricional con agente MCP

Consulta los datos nutricionales de uno o más alimentos descritos en texto plano. Identifica alimentos en una imagen y devuelve un desglose nutricional completo.

Conecta tu cliente MCP en minutos.

Añade la URL del servidor a tu cliente y pasa las credenciales de Edamam como bearer token. El descubrimiento puede conectarse primero; las llamadas reales a herramientas requieren un app_id y app_key de la Edamam Food Database API.

{
  "mcpServers": {
    "edamam-food": {
      "url": "https://mcp.edamam.com/mcp/food",
      "headers": {
        "Authorization": "Bearer <app_id>:<app_key>"
      }
    }
  }
}
{
  "servers": {
    "edamam-food": {
      "type": "http",
      "url": "https://mcp.edamam.com/mcp/food",
      "headers": {
        "Authorization": "Bearer <app_id>:<app_key>"
      }
    }
  }
}
claude mcp add --transport http edamam-food \
  https://mcp.edamam.com/mcp/food \
  --header "Authorization: Bearer <app_id>:<app_key>"
{
  "mcpServers": {
    "edamam-food": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.edamam.com/mcp/food",
        "--header",
        "Authorization: Bearer <app_id>:<app_key>"
      ]
    }
  }
}

Dos herramientas de producción, ajustadas para preguntas sobre alimentos.

El servidor FastMCP mantiene la superficie del agente intencionalmente compacta. La búsqueda, el análisis, el reconocimiento de UPC y el cálculo de nutrientes se manejan dentro de la herramienta de nutrición; las fotos usan una herramienta Vision dedicada.

tool

get_food_nutrition

Consulta calorías, macronutrientes, etiquetas dietéticas, etiquetas de salud, advertencias, nutrientes totales, valores diarios y datos de ingredientes resueltos para uno o más alimentos.

ArgumentoTipoObligatorioDescripción
querieslist[string]Una frase por alimento, como "1 cup rice", "200g chicken breast" o "049000042566".

Ejemplo de llamada JSON-RPC

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_food_nutrition",
    "arguments": {
      "queries": ["1 croissant", "1 egg"]
    }
  },
  "id": 3
}

tool

analyze_food_image

Identifica alimentos en una fotografía y devuelve el elemento detectado, la cantidad, la medida, las líneas de ingredientes, las calorías, las etiquetas, las advertencias y el desglose completo de nutrientes.

ArgumentoTipoObligatorioDescripción
imagestringUna URL pública http / https o un URI base64 data:image/....

Ejemplo de llamada JSON-RPC

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "analyze_food_image",
    "arguments": {
      "image": "https://example.com/plate.jpg"
    }
  },
  "id": 4
}

Usa tus credenciales de Edamam sin almacenarlas en el servidor MCP.

Las llamadas a herramientas usan las credenciales de la Food Database API proporcionadas por quien llama. Envía un bearer token con el app_id y app_key unidos por dos puntos.

Authorization: Bearer <app_id>:<app_key>

Para autoalojamiento: establece EDAMAM_APP_ID y EDAMAM_APP_KEY como credenciales de respaldo, o exige que cada llamada pase el encabezado Authorization.

Todo lo necesario para probar, autoalojar e integrar.

El endpoint público es para clientes MCP inmediatos. El repositorio de GitHub contiene el servidor FastMCP, código compartido de autenticación y registro, cobertura de pytest, notas de implementación y ejemplos para llamadas JSON-RPC directas.

Obtener claves de API Documentación de la Food Database API Especificación MCP Streamable HTTP

1

Inicializar

El cliente envía initialize para negociar capacidades y recibe un MCP-Session-Id.

2

Descubrir herramientas

El cliente llama a tools/list y recibe esquemas para get_food_nutrition y analyze_food_image.

3

Llamar herramientas

El cliente envía tools/call con el id de sesión y las credenciales bearer de Edamam.

Mapeado a las rutas de la Food Database API que los agentes más necesitan.

Capacidad de la Food DatabaseMapeo MCPEstado
Búsqueda por parser por nombre de alimento o UPCPaso interno en get_food_nutritionDisponible
Endpoint de nutrientesget_food_nutritionDisponible
Nutrientes desde imagenanalyze_food_imageDisponible
Autocompletado y filtros de navegaciónNo expuestos como herramientas MCPFuera de alcance

Incluido con los planes de la Edamam Food Database API.

Edamam lista Food MCP como incluido con los planes de la Food Database API. Elige el plan según el volumen de API, el uso de Vision, la limitación de velocidad, los derechos de caché y las necesidades de soporte.

EnterpriseBasic Vision

$14 / mes

  • 100,000 llamadas/mes
  • 50 llamadas de alimentos y nutrición/min
  • 500 solicitudes de Vision/mes
  • Período de prueba de 30 días

EnterpriseCore

$69 / mes

  • 750,000 llamadas/mes
  • 100 llamadas de alimentos y nutrición/min
  • Vision de pago por uso
  • Soporte por correo electrónico y teléfono

EnterprisePlus

$299 / mes

  • 5,000,000 llamadas/mes
  • 300 llamadas de alimentos y nutrición/min
  • 10,000 solicitudes de Vision/mes
  • Soporte por correo electrónico y teléfono

Los detalles de los planes cambian con el tiempo. Confirma los precios, cuotas, derechos de caché y términos actuales en la página de la Edamam Food Database API antes del lanzamiento.

Datos de alimentos de solo lectura, con la responsabilidad de las claves de API en el borde del cliente.

Mantén privadas las claves de la aplicación

Nunca confirmes valores de app_key en el control de versiones ni los pegues en prompts compartidos. Trátalos como contraseñas.

Uso iniciado por humanos

Los términos de la API de Edamam restringen la recopilación automatizada, el scraping o la creación de una copia de los datos devueltos.

Atribución requerida

Al mostrar datos nutricionales de Edamam a los usuarios finales, muestra la atribución requerida de Edamam y el enlace.

Salida informativa

Los resultados de nutrición y Vision deben presentarse como estimaciones para uso del producto, no como consejo médico o dietético.

Preguntas comunes de configuración.

¿Necesito claves de API de Edamam antes de conectar un cliente MCP?

Puedes conectarte al endpoint público de Food MCP y descubrir las herramientas disponibles primero. Para ejecutar llamadas reales a herramientas, necesitas un app_id y app_key de la Edamam Food Database API enviados como bearer token.

¿Cómo me suscribo a un plan de Food MCP?

Elige un plan de la Food Database API en la sección de precios o en el modal de registro, crea tu cuenta de API y luego inicia sesión para completar el siguiente paso de facturación para el acceso a la API.

¿El servidor almacena mis credenciales de Edamam?

No. Las llamadas de clientes públicos pasan las credenciales en el encabezado Authorization. Las implementaciones autoalojadas pueden establecer variables de entorno como credenciales de respaldo.

¿Por qué no hay una herramienta independiente search_food?

La implementación actual de FastMCP resuelve la búsqueda de alimentos internamente dentro de get_food_nutrition. Se puede añadir una herramienta separada solo de búsqueda más adelante si los flujos de trabajo de los usuarios necesitan resultados de tipo navegación.