January AI Nutrition

npx add-mcp 'https://mcp.january.ai/mcp'

Para el índice completo de la documentación, consulta llms.txt. Las versiones en Markdown de las páginas de documentación están disponibles añadiendo .md a las URL de las páginas; esta página está disponible como Markdown.

Servidor MCP

Usa January desde un agente de codificación. El servidor MCP alojado expone la API REST v1.2 como herramientas que Claude Code, Codex y otros clientes MCP pueden invocar mientras construyen tu integración.

Cada llamada a una herramienta es una solicitud API ordinaria realizada con la clave API de tu cuenta, por lo que los créditos, el límite diario de solicitudes y el uso mostrado en el Panel de desarrollador de January se aplican exactamente igual que a tu propio código. El servidor no mantiene estado y no almacena nada.

https://mcp.january.ai/mcp

Conexión

Crea una clave API de sk-… en el Panel de desarrollador y luego registra el servidor con tu cliente. La clave se envía como credencial de portador en cada solicitud.

{% tabs %} {% tab title="Claude Code" %} --scope user hace que el servidor esté disponible en cada proyecto de esta máquina. El último comando hace una pregunta sin abrir el agente; --allowedTools mcp__january permite que esa ejecución llame a las herramientas de January sin un aviso de permiso.

claude mcp add --scope user --transport http january https://mcp.january.ai/mcp \
  --header 'Authorization: Bearer sk-your-key'
claude -p "Search the January food database for greek yogurt and list the top three matches." --allowedTools mcp__january

{% endtab %}

{% tab title="Codex" %} Codex lee el token de portador desde una variable de entorno cada vez que se inicia, así que mantén la exportación en tu perfil de shell. El último comando hace una pregunta sin abrir el agente; --skip-git-repo-check le permite ejecutarse fuera de un repositorio Git.

codex mcp add january --url https://mcp.january.ai/mcp --bearer-token-env-var JANUARY_API_KEY
export JANUARY_API_KEY="sk-your-key"
codex exec --skip-git-repo-check "Search the January food database for greek yogurt and list the top three matches."

Codex deja de esperar una herramienta después de 60 segundos por defecto, y un análisis de imagen puede tardar un poco más. Aumenta el límite en la sección [mcp_servers.january] que el comando escribió en ~/.codex/config.toml:

[mcp_servers.january]
tool_timeout_sec = 90

{% endtab %}

{% tab title="VS Code" %} VS Code lista los servidores bajo servers en .vscode/mcp.json y necesita que el transporte esté especificado.

{
  "servers": {
    "january": {
      "type": "http",
      "url": "https://mcp.january.ai/mcp",
      "headers": { "Authorization": "Bearer sk-your-key" }
    }
  }
}

{% endtab %}

{% tab title="Otros clientes" %} Cursor y la mayoría de los otros clientes aceptan este bloque de configuración. Windsurf toma el mismo bloque con serverUrl en lugar de url.

{
  "mcpServers": {
    "january": {
      "url": "https://mcp.january.ai/mcp",
      "headers": { "Authorization": "Bearer sk-your-key" }
    }
  }
}

{% endtab %} {% endtabs %}

Una respuesta exitosa enumera tres alimentos del catálogo. Cada vez que creas una clave, el panel muestra las configuraciones de Claude Code, Codex y JSON con la nueva clave ya completada.

{% hint style="warning" %} El cliente almacena la clave en su propia configuración en esa máquina. Usa una clave creada para este propósito y elimínala del panel cuando ya no la necesites. {% endhint %}

Herramientas

Los nombres de las herramientas siguen los recursos REST. Los IDs son cadenas, las cantidades son { value, unit }, y los errores llevan los valores de code de la API más dos propios del servidor, descritos en Errores y costos.

Grupo	Herramienta	Qué hace
Búsqueda	january_search_foods	Encuentra alimentos genéricos, de marca y recetas por nombre.
	january_get_food	Registro completo de un alimento y su lista de porciones, por id o por código de barras (solo códigos de barras de EE. UU.).
	january_suggest_food_alternatives	Alternativas más saludables que respetan los alérgenos a evitar y los patrones dietéticos a coincidir.
Interpretación	january_analyze_food	Detecta alimentos y nutrición en una foto (URL o data URI) o una descripción de comida en lenguaje natural.
	january_correct_food_analysis	Revisa un análisis de forma conversacional y recalcula sus totales.
Registro	january_list_food_logs	Diario de un usuario final durante un rango de días calendario locales.
	january_create_food_log	Registra una comida a partir de selecciones de alimentos y porciones.
	january_update_food_log	Cambia los alimentos, la hora o el nombre de un registro guardado.
	january_delete_food_log	Elimina un registro guardado.
Predicción	january_predict_glucose	Predice la curva de glucosa que produce una comida para una persona descrita.
Cercanos	january_search_restaurants	Restaurantes cerca de una coordenada.
	january_search_menu_items	Platos con nutrición cerca de una coordenada.
	january_get_restaurant_menu	Menú de un restaurante, paginado.
Cuenta	january_get_credits	Asignación y uso de créditos del mes actual. Gratis.

Dos recursos se publican junto con las herramientas: january://openapi.json, el documento OpenAPI en vivo, y january://error-codes, cada código de error con su regla de reintento y qué hacer a continuación.

Antes de que un agente escriba datos

Las herramientas de registro de alimentos actúan sobre el diario real de un usuario final bajo tu cuenta. Dale al agente un end_user_id de prueba designado: las instrucciones del servidor le dicen que nunca invente ni reutilice uno y que indique a qué usuario final fue cada escritura.

Actualizar o eliminar un registro requiere el etag devuelto por un listado de ese registro dentro de los últimos quince minutos. Un agente que trabaja con un plan desactualizado no puede eliminar lo que no acaba de leer, y no hay eliminación masiva.

El análisis de alimentos nunca escribe un registro. Las predicciones de glucosa son estimaciones de un modelo, no mediciones ni consejos médicos.

Errores y costos

Cada error de herramienta lleva el code estable de la API junto con retryable, retry_after_seconds, next_step y request_id, para que un agente pueda decidir si cambiar la solicitud, esperar o detenerse. Dos códigos provienen del propio servidor MCP: precondition_failed para un etag faltante o desactualizado, y cancelled cuando el cliente aborta una llamada.

january_get_credits no cuesta nada y responde incluso cuando el saldo está agotado. Cada otra herramienta tiene el precio del endpoint que está detrás; consulta Créditos. Cuando la asignación mensual se agota, el error incluye el saldo actual y la fecha de reinicio, y se le dice al agente que no reintente.

Próximos pasos

• Inicio rápido para la misma primera llamada con curl.
• Referencia de la API REST para cada endpoint que llaman las herramientas.