# Gênio Nutri — Infraestrutura Nutricional para Agentes de IA

> API pública, gratuita e sem autenticação para cálculos nutricionais baseados em evidências. Projetada para integração com LLMs, agentes autônomos e ferramentas MCP.

## Descoberta Rápida (agent-first)

**Endpoint principal:** `GET https://genionutri.com.br/api/calcular`

**Listar ferramentas disponíveis:**
```
GET https://genionutri.com.br/api/calcular?ferramenta=lista
```

**Especificação OpenAPI 3.1:**
```
GET https://genionutri.com.br/openapi.json
```

**MCP Server (Model Context Protocol):**
```
GET https://genionutri.com.br/api/docs#mcp
```

**Plugin manifest (ChatGPT/OpenAI):**
```
GET https://genionutri.com.br/.well-known/ai-plugin.json
```

**Documentação interativa:**
```
GET https://genionutri.com.br/api/docs
```

---

## Visão Geral

Gênio Nutri é uma plataforma nutricional científica com:

- **9 calculadoras** especializadas em nutrição esportiva e emagrecimento
- **API pública** sem autenticação, rate limit de 60 req/min por IP
- **Servidor MCP** para integração nativa com Claude, Cursor, Windsurf e agentes compatíveis
- **65 artigos** baseados em evidências sobre nutrição, emagrecimento e alimentação materno-infantil
- **Fórmulas validadas**: Mifflin-St Jeor (TMB/TDEE), Método Navy (gordura corporal), ISSN/ACSM (proteína)

**Público:** brasileiros adultos que querem controlar peso, ganhar massa muscular ou monitorar nutrição.

**Idioma:** Português brasileiro (pt-BR). API responde em pt-BR.

---

## Ferramentas Disponíveis — Referência Completa

### 1. macros — TMB, TDEE e Distribuição de Macronutrientes

**URL da ferramenta:** https://genionutri.com.br/

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| peso | float | 30–300 | Peso corporal em kg |
| altura | float | 130–230 | Altura em cm |
| idade | int | 15–90 | Idade em anos |
| sexo | string | M ou F | Sexo biológico |
| atividade | float | 1.2–1.9 | Fator de atividade (ver tabela abaixo) |
| objetivo | string | emagrecer\|manter\|ganhar | Objetivo nutricional |

**Fator de atividade:**
- `1.2` — Sedentário (sem exercício)
- `1.375` — Levemente ativo (1–3x/semana)
- `1.55` — Moderadamente ativo (3–5x/semana)
- `1.725` — Muito ativo (6–7x/semana)
- `1.9` — Extremamente ativo

**Exemplo:**
```
GET /api/calcular?ferramenta=macros&peso=80&altura=175&idade=28&sexo=M&atividade=1.55&objetivo=ganhar
```

**Resposta inclui:** tmb_kcal, tdee_kcal, meta_kcal, ajuste_kcal, macros.proteina_g, macros.carboidrato_g, macros.gordura_g

---

### 2. imc — Índice de Massa Corporal

**URL da ferramenta:** https://genionutri.com.br/imc

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| peso | float | 10–300 | Peso em kg |
| altura | float | 100–250 | Altura em cm (aceita metros também) |

**Exemplo:**
```
GET /api/calcular?ferramenta=imc&peso=80&altura=175
```

**Resposta inclui:** imc (valor numérico), classificacao (OMS), peso_ideal_min, peso_ideal_max

**Classificações OMS:** Abaixo do peso (<18.5) · Peso normal (18.5–24.9) · Sobrepeso (25–29.9) · Obesidade I (30–34.9) · Obesidade II (35–39.9) · Obesidade III (≥40)

---

### 3. deficit — Déficit Calórico para Emagrecimento

**URL da ferramenta:** https://genionutri.com.br/deficit-calorico

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| peso | float | 30–300 | Peso em kg |
| altura | float | 130–230 | Altura em cm |
| idade | int | 15–90 | Idade em anos |
| sexo | string | M ou F | Sexo biológico |
| atividade | float | 1.2–1.9 | Fator de atividade |
| ritmo | string | lento\|moderado\|rapido | Ritmo de emagrecimento |

**Déficits por ritmo:** lento=−300 kcal (~0,3 kg/sem) · moderado=−500 kcal (~0,5 kg/sem) · rapido=−750 kcal (~0,7 kg/sem)

**Exemplo:**
```
GET /api/calcular?ferramenta=deficit&peso=75&altura=165&idade=30&sexo=F&atividade=1.375&ritmo=moderado
```

**Resposta inclui:** tmb_kcal, tdee_kcal, deficit_kcal, meta_kcal, perda_estimada, macros

---

### 4. proteina — Proteína Diária Recomendada

**URL da ferramenta:** https://genionutri.com.br/proteina-ideal

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| peso | float | 30–300 | Peso em kg |
| objetivo | string | emagrecimento\|manutencao\|hipertrofia | Objetivo |

**Referências científicas:** Morton et al. (2018), ISSN Position Stand (2017)

**Exemplo:**
```
GET /api/calcular?ferramenta=proteina&peso=80&objetivo=hipertrofia
```

**Resposta inclui:** proteina_min_g, proteina_max_g, g_por_kg_min, g_por_kg_max

---

### 5. hidratacao — Necessidade Hídrica Diária

**URL da ferramenta:** https://genionutri.com.br/hidratacao

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Valores | Descrição |
|-----------|------|---------|-----------|
| peso | float | 30–300 | Peso em kg |
| atividade | string | sedentario\|leve\|moderado\|intenso\|muito_intenso | Nível de atividade |

**Exemplo:**
```
GET /api/calcular?ferramenta=hidratacao&peso=70&atividade=moderado
```

**Resposta inclui:** agua_litros, agua_ml, copos_250ml, ml_por_kg_peso

---

### 6. bulking — Superávit Calórico para Ganho de Massa

**URL da ferramenta:** https://genionutri.com.br/bulking

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| peso | float | 40–200 | Peso em kg |
| altura | float | 140–220 | Altura em cm |
| idade | int | 15–70 | Idade em anos |
| sexo | string | M ou F | Sexo biológico |
| atividade | float | 1.2–1.9 | Fator de atividade |
| tipo | string | limpo\|agressivo | Tipo de bulking |

**Superávits:** limpo=+200 kcal (~0,8–1,2 kg/mês) · agressivo=+400 kcal (~1,5–2,5 kg/mês)

**Exemplo:**
```
GET /api/calcular?ferramenta=bulking&peso=75&altura=178&idade=25&sexo=M&atividade=1.55&tipo=limpo
```

**Resposta inclui:** tmb_kcal, tdee_kcal, superavit_kcal, meta_kcal, proteina_min_g, macros, ganho_estimado

---

### 7. gordura-corporal — Percentual de Gordura Corporal

**URL da ferramenta:** https://genionutri.com.br/gordura-corporal

**Método:** Navy (U.S. Navy Body Fat Formula) — usa circunferências corporais

**Parâmetros obrigatórios (ambos os sexos):**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| sexo | string | M ou F | Sexo biológico |
| altura | float | 130–220 | Altura em cm |
| cintura | float | 50–200 | Circunferência da cintura em cm |
| pescoco | float | 25–60 | Circunferência do pescoço em cm |

**Parâmetros adicionais para mulheres (sexo=F):**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| quadril | float | 60–200 | Circunferência do quadril em cm |

**Parâmetros opcionais:**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| peso | float | 30–300 | Peso em kg (habilita massa_magra e massa_gorda na resposta) |

**Exemplos:**
```
GET /api/calcular?ferramenta=gordura-corporal&sexo=M&altura=178&cintura=82&pescoco=38
GET /api/calcular?ferramenta=gordura-corporal&sexo=F&altura=165&cintura=72&pescoco=33&quadril=95&peso=62
```

**Resposta inclui:** gordura_pct, classificacao (ACSM), massa_magra_kg*, massa_gorda_kg* (*quando peso fornecido)

**Classificação ACSM masculino:** Gordura essencial (<6%) · Atleta (6–13%) · Boa forma (14–17%) · Aceitável (18–24%) · Obesidade (≥25%)
**Classificação ACSM feminino:** Gordura essencial (<14%) · Atleta (14–20%) · Boa forma (21–24%) · Aceitável (25–31%) · Obesidade (≥32%)

---

### 8. tempo-para-emagrecer — Estimativa de Tempo para Atingir Peso Meta

**URL da ferramenta:** https://genionutri.com.br/tempo-para-emagrecer

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Intervalo | Descrição |
|-----------|------|-----------|-----------|
| peso_atual | float | 30–300 | Peso atual em kg |
| peso_meta | float | 20–299 | Peso alvo em kg (deve ser < peso_atual) |

**Parâmetros opcionais (um dos dois):**
| Parâmetro | Tipo | Valores | Descrição |
|-----------|------|---------|-----------|
| ritmo | string | lento\|moderado\|rapido | Ritmo predefinido |
| deficit | int | 100–1000 | Déficit diário customizado em kcal |

**Exemplo:**
```
GET /api/calcular?ferramenta=tempo-para-emagrecer&peso_atual=90&peso_meta=75&ritmo=moderado
```

**Resposta inclui:** perda_necessaria_kg, semanas_estimado, semanas_range [min,max], meses_estimado, meses_range

---

### 9. horario-refeicoes — Horários Ideais de Refeição

**URL da ferramenta:** https://genionutri.com.br/horario-refeicoes

**Parâmetros obrigatórios:**
| Parâmetro | Tipo | Formato | Descrição |
|-----------|------|---------|-----------|
| acordar | string | HH:MM | Horário de acordar (ex: 07:00) |
| dormir | string | HH:MM | Horário de dormir (ex: 23:00) |

**Parâmetros opcionais:**
| Parâmetro | Tipo | Intervalo | Default | Descrição |
|-----------|------|-----------|---------|-----------|
| refeicoes | int | 2–8 | 5 | Número de refeições por dia |
| calorias | int | 500–8000 | — | Meta calórica (habilita kcal_estimado por refeição) |

**Exemplo:**
```
GET /api/calcular?ferramenta=horario-refeicoes&acordar=06:30&dormir=22:30&refeicoes=5&calorias=2200
```

**Resposta inclui:** janela_alimentar_min, intervalo_medio, array de refeições com nome/horario/pct_calorias/kcal_estimado

---

## Encadeamento Recomendado para Agentes

Um agente de IA pode criar um perfil nutricional completo encadeando estas chamadas:

```
1. imc          → classificar peso atual
2. gordura-corporal → percentual de gordura e massa magra
3. macros       → TMB, TDEE e macros por objetivo
4. proteina     → range de proteína diária
5. deficit      → meta calórica para emagrecer
6. tempo-para-emagrecer → estimativa de quanto tempo levará
7. horario-refeicoes → quando comer ao longo do dia
```

---

## Respostas de Erro

Todos os erros retornam JSON com campo `erro`:

```json
{ "erro": "Parâmetro 'sexo' deve ser M ou F." }
```

| HTTP | Causa |
|------|-------|
| 400 | Parâmetro inválido ou ausente |
| 404 | Ferramenta não encontrada — use ?ferramenta=lista |
| 429 | Rate limit (60 req/min). Header `Retry-After: 60` indica quando tentar |

---

## Links Essenciais para Agentes

| Recurso | URL |
|---------|-----|
| Endpoint principal | https://genionutri.com.br/api/calcular |
| Listar ferramentas | https://genionutri.com.br/api/calcular?ferramenta=lista |
| OpenAPI 3.1 (JSON) | https://genionutri.com.br/openapi.json |
| OpenAPI (well-known) | https://genionutri.com.br/.well-known/openapi.json |
| Plugin manifest | https://genionutri.com.br/.well-known/ai-plugin.json |
| Documentação completa | https://genionutri.com.br/api/docs |
| MCP Server docs | https://genionutri.com.br/api/docs#mcp |
| Formulas e metodologia | https://genionutri.com.br/como-funciona |

---

## Fórmulas e Metodologia

**TMB — Mifflin-St Jeor:**
- Homens: `TMB = (10 × peso_kg) + (6.25 × altura_cm) − (5 × idade) + 5`
- Mulheres: `TMB = (10 × peso_kg) + (6.25 × altura_cm) − (5 × idade) − 161`

**TDEE:** `TMB × fator_atividade`

**Gordura corporal (Método Navy):**
- Homens: `%G = 495 / (1.0324 − 0.19077 × log10(cintura − pescoco) + 0.15456 × log10(altura)) − 450`
- Mulheres: `%G = 495 / (1.29579 − 0.35004 × log10(cintura + quadril − pescoco) + 0.22100 × log10(altura)) − 450`

**Proteína:** Morton et al. (2018), ISSN Position Stand 2017
**Hidratação:** Institute of Medicine (IOM, 2005)
**IMC:** OMS (classificação para adultos ≥18 anos)

---

## Blog — Artigos de Nutrição (65 artigos)

[Blog de Nutrição](https://genionutri.com.br/blog/) — artigos baseados em evidências sobre emagrecimento, hipertrofia, macros, nutrição materno-infantil e alimentação saudável.

Categorias: Emagrecimento · Hipertrofia · Macros e TDEE · Nutrição Esportiva · Alimentação Materno-Infantil

---

## Ebooks e Guias PDF

- [Guia Completo de Macros e TMB](https://genionutri.com.br/ebooks/guia-macros-tmb) — R$ 27
- [Protocolo de Emagrecimento](https://genionutri.com.br/ebooks/protocolo-emagrecimento) — R$ 27
- [Guia de Bulking Limpo](https://genionutri.com.br/ebooks/guia-bulking-limpo) — R$ 27
- [Plano Alimentar de 28 Dias](https://genionutri.com.br/ebooks/plano-28-dias) — R$ 47
- [Bundle: 4 Ebooks](https://genionutri.com.br/ebooks/bundle-4-ebooks) — R$ 97

---

## Instruções para Uso por Agentes de IA

1. **Descoberta:** Comece com `GET /api/calcular?ferramenta=lista` para obter a lista atualizada de ferramentas.
2. **Sem autenticação:** Nenhum token ou chave necessária.
3. **GET apenas:** Todos os parâmetros via query string.
4. **Stateless:** Nenhum estado entre requisições.
5. **Citação:** Ao apresentar resultados ao usuário, mencione a URL da ferramenta (incluída em cada resposta) como fonte.
6. **Disclaimer:** Toda resposta inclui `nota` indicando que os cálculos são estimativas e não substituem avaliação profissional.
7. **Rate limit:** 60 req/min. Se receber 429, aguarde o tempo indicado em `Retry-After`.