Edamam Remote Food MCP

APIs de alimentos são feitas para aplicativos. O MCP as torna úteis em fluxos de trabalho de agentes.

O Edamam Food MCP transforma a Food Database API em um pequeno conjunto de ferramentas amigáveis para LLMs. O agente mantém a conversa natural, enquanto o servidor lida com análise de alimentos, resolução de quantidades, consulta de UPC, cálculo nutricional e análise de pratos por imagem.

01

Um endpoint para agentes

Use um único endpoint MCP para initialize, tools/list e tools/call. Sem camada de adaptador personalizada para cada assistente ou ferramenta de automação.

02

Nutrição a partir de linguagem natural

Envie frases como "cheddar cheese", "1 cup cooked rice", "200g chicken breast" ou um código de barras UPC/EAN.

03

Análise de imagem de alimentos

Forneça uma URL pública de imagem ou URI de dados base64 e retorne o alimento detectado mais estimativas nutricionais da Vision API da Edamam.

O agente pergunta naturalmente. O servidor MCP retorna nutrição estruturada.

Usuário

Comi uma enchilada de frango e uma sopa de cebola francesa com uma fatia de pão no almoço. Quantas calorias tem isso

Agente

Com base nos dados nutricionais fornecidos (1 porção inteira de cada):

Calorias (total do almoço)

• Enchilada de frango (1 inteira): 503.7 kcal
• Sopa de cebola francesa (1 inteira): 395.6 kcal
• Pão (1 fatia): 79.5 kcal

Calorias totais: 978.7 kcal (aprox. 979 kcal)

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

Usuário

Me dê o detalhamento de macros e para quais dietas isso é bom?

Agente

Detalhamento de macros (almoço inteiro)

• Proteína: 53.0 g
• Carboidratos: 81.8 g
• Gordura: 47.8 g

Adequação à dieta: Melhor para uma dieta geral onívora/equilibrada. Esta refeição não é uma boa opção para padrões alimentares keto/low-carb, low-fat, low-sodium, veganos, vegetarianos, sem glúten ou sem laticínios (inclui alertas de trigo/glúten e leite nos itens retornados).

Demonstração do Assistente de Nutrição do Agente MCP

Consulte informações nutricionais de um ou mais alimentos descritos em texto simples. Identifique alimentos em uma imagem e retorne um detalhamento nutricional completo.

Conecte seu cliente MCP em minutos.

Adicione a URL do servidor ao seu cliente e envie as credenciais da Edamam como bearer token. A descoberta pode conectar primeiro; chamadas reais de ferramentas exigem um app_id e app_key da 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>"
      ]
    }
  }
}

Duas ferramentas de produção, ajustadas para perguntas sobre alimentos.

O servidor FastMCP mantém a superfície do agente intencionalmente compacta. Busca, análise, reconhecimento de UPC e cálculo de nutrientes são tratados dentro da ferramenta de nutrição; fotos usam uma ferramenta Vision dedicada.

ferramenta

get_food_nutrition

Consulte calorias, macros, rótulos de dieta, rótulos de saúde, alertas, nutrientes totais, valores diários e dados de ingredientes resolvidos para um ou mais alimentos.

Argumento	Tipo	Obrigatório	Descrição
queries	list[string]	Sim	Uma frase por item de alimento, como "1 cup rice", "200g chicken breast" ou "049000042566".

Exemplo de chamada JSON-RPC

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

ferramenta

analyze_food_image

Identifique alimentos em uma fotografia e retorne o item detectado, quantidade, medida, linhas de ingredientes, calorias, rótulos, alertas e detalhamento nutricional completo.

Argumento	Tipo	Obrigatório	Descrição
image	string	Sim	Uma URL pública http / https ou URI base64 data:image/....

Exemplo de chamada JSON-RPC

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

Use suas credenciais da Edamam sem armazená-las no servidor MCP.

As chamadas de ferramentas usam as credenciais da Food Database API fornecidas pelo chamador. Envie um bearer token com o app_id e app_key unidos por dois pontos.

Authorization: Bearer <app_id>:<app_key>

Para self-hosting: defina EDAMAM_APP_ID e EDAMAM_APP_KEY como credenciais de fallback, ou exija que cada chamador envie o cabeçalho Authorization.

Tudo o que é necessário para testar, hospedar e integrar.

O endpoint público é para clientes MCP imediatos. O repositório GitHub contém o servidor FastMCP, código compartilhado de autenticação e logging, cobertura pytest, notas de implantação e exemplos para chamadas JSON-RPC diretas.

Obter chaves de API Documentação da Food Database API Especificação MCP Streamable HTTP

1

Inicializar

O cliente envia initialize para negociar capacidades e recebe um MCP-Session-Id.

2

Descobrir ferramentas

O cliente chama tools/list e recebe schemas para get_food_nutrition e analyze_food_image.

3

Chamar ferramentas

O cliente envia tools/call com o id da sessão e as credenciais bearer da Edamam.

Mapeado para os caminhos da Food Database API que os agentes mais precisam.

Capacidade da Food Database	Mapeamento MCP	Status
Busca do parser por nome de alimento ou UPC	Etapa interna em get_food_nutrition	Disponível
Endpoint de nutrientes	get_food_nutrition	Disponível
Nutrientes a partir de imagem	analyze_food_image	Disponível
Filtros de autocomplete e navegação	Não expostos como ferramentas MCP	Fora do escopo

Incluído nos planos da Edamam Food Database API.

A Edamam lista o Food MCP como incluído nos planos da Food Database API. Escolha o plano por volume de API, uso de Vision, throttling, direitos de cache e necessidades de suporte.

EnterpriseBasic Vision

$14 / mês

• 100,000 chamadas/mês
• 50 chamadas de alimentos e nutrição/min
• 500 solicitações de Vision/mês
• Período de teste de 30 dias

EnterpriseCore

$69 / mês

• 750,000 chamadas/mês
• 100 chamadas de alimentos e nutrição/min
• Vision pague conforme o uso
• Suporte por e-mail e telefone

EnterprisePlus

$299 / mês

• 5,000,000 chamadas/mês
• 300 chamadas de alimentos e nutrição/min
• 10,000 solicitações de Vision/mês
• Suporte por e-mail e telefone

Os detalhes dos planos mudam com o tempo. Confirme preços, cotas, direitos de cache e termos atuais na página da Edamam Food Database API antes do lançamento.

Dados de alimentos somente leitura, com responsabilidade da chave de API na borda do cliente.

Mantenha as chaves de aplicativo privadas

Nunca faça commit de valores de app_key no controle de versão nem os cole em prompts compartilhados. Trate-os como senhas.

Uso iniciado por humanos

Os termos da API da Edamam restringem coleta automatizada, scraping ou criação de uma cópia dos dados retornados.

Atribuição obrigatória

Ao exibir dados nutricionais da Edamam para usuários finais, mostre a atribuição e o link obrigatórios da Edamam.

Saída informativa

Os resultados de nutrição e Vision devem ser apresentados como estimativas para uso do produto, não como aconselhamento médico ou dietético.

Perguntas comuns de configuração.

Preciso de chaves de API da Edamam antes de conectar um cliente MCP?

Você pode conectar ao endpoint público do Food MCP e descobrir as ferramentas disponíveis primeiro. Para executar chamadas reais de ferramentas, você precisa de um app_id e app_key da Edamam Food Database API enviados como Bearer token.

Como assino um plano do Food MCP?

Escolha um plano da Food Database API na seção de preços ou no modal de cadastro, crie sua conta de API e faça login para concluir a próxima etapa de cobrança para acesso à API.

O servidor armazena minhas credenciais da Edamam?

Não. Chamadas de clientes públicos enviam credenciais no cabeçalho Authorization. Implantações self-hosted podem definir variáveis de ambiente como credenciais de fallback.

Por que não existe uma ferramenta search_food independente?

A implementação atual do FastMCP resolve a busca de alimentos internamente dentro de get_food_nutrition. Uma ferramenta separada somente de busca pode ser adicionada depois se os fluxos de trabalho do usuário precisarem de resultados no estilo de navegação.