Crea un agente de recetas: Las 7 herramientas en el servidor MCP de Forktastic
Referencia de las 7 herramientas en el servidor MCP de Forktastic, más tres diseños de agentes de ejemplo: planificador semanal, buscador consciente de la despensa, formateador de exportación Markdown.
Una vez que tu biblioteca de Forktastic esté conectada a Claude o Cursor a través de MCP, la siguiente pregunta es qué construir con ella. Esta publicación es la referencia para las siete herramientas que expone el servidor MCP de Forktastic, con consultas de ejemplo y diseños de agentes de ejemplo.
Las siete herramientas
search_recipes
Propósito: Búsqueda de texto completo en tu biblioteca de recetas.
Entradas: query (string, obligatorio), limit (int, opcional, valor predeterminado 20), offset (int, opcional, valor predeterminado 0).
Salida: Matriz de resúmenes de recetas (id, título, URL de la foto, URL de origen, etiquetas dietéticas).
Caso de uso: "Encuentra mis recetas italianas" — Claude llama a search_recipes con query="italian".
get_recipe
Propósito: Obtener la receta completa por ID, incluidos los ingredientes, los pasos, las notas y la información nutricional.
Entradas: recipe_id (UUID, obligatorio).
Salida: Objeto de receta completo.
Caso de uso: "Léeme los pasos para esa receta de pasta" — Claude llama a get_recipe con el ID de una búsqueda anterior.
list_cookbooks
Propósito: Enumera tus libros de cocina.
Entradas: limit, offset (opcional).
Salida: Matriz de resúmenes de libros de cocina (id, nombre, número de recetas, última actualización).
Caso de uso: "¿Qué libros de cocina tengo?"
search_cookbooks
Propósito: Busca libros de cocina por nombre.
Entradas: query (string).
Salida: Matriz de resúmenes de libros de cocina.
get_cookbook
Propósito: Obtener un libro de cocina con sus recetas.
Entradas: cookbook_id (UUID).
Salida: Libro de cocina con matriz de resúmenes de recetas.
Caso de uso: "Muéstrame todo lo que hay en mi libro de cocina 'La cocina de la abuela'."
get_trending
Propósito: Obtener recetas de tendencia actual en toda la plataforma (no solo las tuyas).
Entradas: limit (opcional).
Salida: Matriz de resúmenes de recetas de tendencia.
Caso de uso: "¿Qué es popular ahora mismo?" — útil para el descubrimiento.
get_family
Propósito: Obtener la información de tu grupo familiar (miembros, libros de cocina compartidos).
Entradas: Ninguna (utiliza la cuenta del PAT).
Salida: Grupo familiar con miembros y lista de libros de cocina compartidos.
Caso de uso: "¿Quién está en mi grupo familiar de Forktastic?"
Tres diseños de agentes de ejemplo
1. El agente planificador de comidas semanales
Prompt: "Cada domingo, consulta Forktastic para obtener recetas que haya cocinado en el último trimestre. Elige 3 según: variedad de cocinas, recetas que no haya repetido recientemente y lo que esté en temporada. Salida como Markdown para mi aplicación de notas."
Herramientas utilizadas: search_recipes, get_recipe, list_cookbooks.
2. El buscador consciente de la despensa
Prompt: "Tengo pollo, brócoli, arroz, ajo y salsa de soja en mi nevera. Encuentra recetas de mi biblioteca de Forktastic que utilicen 3 o más de esos ingredientes."
Herramientas utilizadas: search_recipes (para la coincidencia de ingredientes), get_recipe (para verificar la lista de ingredientes).
3. El formateador de exportación a Markdown
Prompt: "Extrae la receta con ID X de Forktastic y formatéala como Markdown adecuado para pegar en un mensaje de Slack. Incluye la URL de origen, los ingredientes como una lista de verificación y los pasos como una lista numerada."
Herramientas utilizadas: get_recipe.
Límites de velocidad que debes conocer
60 solicitudes por minuto y 5000 por día por token. Para la mayoría de las cargas de trabajo de los agentes, esto es suficiente; para las operaciones de alta frecuencia, procesa tus consultas por lotes. Referencia de límites de velocidad y paginación.
Paginación
Los puntos finales de la lista (search_recipes, list_cookbooks, get_trending) utilizan la paginación basada en el desplazamiento con parámetros de límite/desplazamiento. Límite predeterminado 20, máximo 100. Los sobrepasos de desplazamiento devuelven matrices vacías (no errores).
A dónde ir después
Para la configuración, Tutorial de conexión de Claude o Configuración de Cursor. Para los límites de velocidad, referencia de límites de velocidad. Para el pilar MCP, guía del pilar MCP.