# ReciPal MCP > ReciPal lets your AI agent handle complex food manufacturing audits. It connects to a specialized database to check nutrition labels, audit ingredient lists, and retrieve full recipe details—all through natural conversation. Stop opening dozens of portals; let your agent do the data heavy lifting for compliance checks. ## Overview - **Category:** data-management - **Price:** Free - **Tags:** nutrition-labeling, recipe-analysis, food-manufacturing, compliance-reporting, ingredient-tracking ## Description ReciPal lets your AI agent handle complex food manufacturing audits. It connects to a specialized database so you can check nutrition labels, audit ingredient lists, and pull full recipe details—all just by talking to it. Don't open dozens of portals; let your agent do the data heavy lifting for compliance checks. ### Recipe Inventory & Lookup You need to know what recipes you've got on file? You can use `list_recipal_recipes` to pull a full roster of every recipe identifier stored in your account. This gives you the initial list—the roadmap, if you will. Once you have that ID, or if you already know it, you'll want to run `get_recipe_details`. That tool doesn't just give you basic stats; it pulls comprehensive nutritional facts and ingredient breakdowns for a single recipe using its unique identifier. You get the full picture: precise calorie counts and detailed lists of components needed for compliance checks. ### Ingredient Audit Capabilities If you need to know what raw materials you can even work with, `list_recipal_ingredients` generates a complete inventory of every single component stored in the ReciPal database. This lets you audit ingredient availability and check component distribution across your product line. You use this when you gotta confirm if a specific allergen or a core vitamin is actually sitting in your system before writing up a label. ### System Health Checks Before you start running reports, you gotta make sure the data source isn't offline. `check_api_status` verifies if the entire nutritional data set is currently operational and connected. If that status check fails, you know right away that your whole research workflow is stalled, saving you time chasing phantom errors. ### How You Use It You tell your agent what you're doing—maybe "Check all recipes with less than 500 calories" or "List every ingredient containing gluten." Your AI client then figures out which tools to run: it calls `list_recipal_recipes` first, maybe filters that list using the data from `get_recipe_details`, and keeps track of component availability using `list_recipal_ingredients`. It's built for compliance teams, food manufacturers, and anyone whose job depends on having fast, verifiable numbers about ingredients and nutrition. You don't manually cross-reference spreadsheets; you talk to your agent, and it pulls the verified data right back. The system handles all that deep linking between ingredient components and finished recipe structures, letting you audit everything from a simple component list to complex nutritional breakdowns in one conversation. ## Tools ### check_api_status Confirms if the ReciPal service is currently running and accessible. ### get_recipe_details Retrieves full nutritional facts, including ingredients and calorie counts for a specific recipe ID. ### list_recipal_ingredients Generates a complete list of all available ingredient components in the database. ### list_recipal_recipes Fetches an inventory listing of every recipe stored in your account. ## Prompt Examples **Prompt:** ``` List all my recipes using ReciPal. ``` **Response:** ``` I've retrieved your recipe catalog! You have several items, including 'Signature Granola' and 'Organic Protein Bar'. Would you like the nutritional details or serving metadata for any of these? ``` **Prompt:** ``` What are the details for recipe ID '12345'? ``` **Response:** ``` I've retrieved the details for recipe 12345! It has 250 calories per serving and includes ingredients such as oats and honey. I can provide the full nutritional breakdown or serving counts for you. ``` **Prompt:** ``` List all ingredients available in ReciPal. ``` **Response:** ``` I've scanned the ingredient catalog from ReciPal! There are thousands of items listed, from common grains to specialized additives. I can assist you with a search to identify the exact markers for your recipe. ``` ## Capabilities ### List all known recipes Retrieves the full list of recipe identifiers from your ReciPal account. ### Get specific recipe details Pulls comprehensive nutritional and ingredient facts for a single recipe using its unique ID. ### Audit available ingredients Lists every ingredient stored in the ReciPal database, letting you check component availability. ### Check service status Verifies if the entire nutritional data source is currently operational and connected. ## Use Cases ### Checking a new product's ingredient compliance A manufacturer needs to know if Product X contains any restricted allergens. Instead of cross-referencing multiple sheets, they ask their agent: 'Check all recipes for the allergen list.' The agent uses `list_recipal_ingredients` and reports back on component availability. ### Comparing two recipe versions A chef needs to compare the nutritional profile of an old granola bar versus a new one. They feed both Recipe IDs into their agent, which runs `get_recipe_details` for both and provides a side-by-side calorie and ingredient comparison. ### Auditing product line completeness An operations lead needs to know how many recipes are in the system. They run `list_recipal_recipes`, immediately getting an accurate count and list of available titles without needing admin access to the backend portal. ### Validating raw material usage A team needs to know if they have enough oats for a new batch. They run `list_recipal_ingredients` and search the massive component list, confirming 'oats' is available before committing production resources. ## Benefits - **Verify Nutritional Counts:** Use `get_recipe_details` to pull exact calorie counts and full nutritional breakdowns for any recipe ID. You get the precise numbers needed for labeling, eliminating manual calculation errors. - **Full Ingredient Inventory:** Run `list_recipal_ingredients` to see every component in your database at once. This lets you quickly check if a specific ingredient is available before starting product research. - **Manage Recipe Catalog:** The `list_recipal_recipes` tool gives you a complete, up-to-date list of all recipes in your account without needing to log into the main labeling portal. - **Compliance Confidence:** By asking your agent to audit ingredients against dietary rules, you ensure data is always verified and precise. This capability drastically cuts down on manual compliance checks. - **Always Operational:** Use `check_api_status` first. Knowing your nutritional research workflow is active means you can trust the data when deadlines are tight. ## How It Works The bottom line is that your AI client acts as a real-time nutritional consultant, querying the database for you instead of requiring manual input or portal navigation. 1. Subscribe to the ReciPal server and enter your unique API key into your AI client. 2. Your agent runs a command (e.g., `list_recipal_recipes`) through the MCP connection. 3. The agent receives structured data containing recipe names, IDs, and metadata, which it then presents in plain language. ## Frequently Asked Questions **How do I list all recipes using ReciPal? (list_recipal_recipes)** You run `list_recipal_recipes` to get your entire catalog. It provides a full inventory of every recipe ID you have access to, which is the starting point for any audit. **What data does get_recipe_details provide? (get_recipe_details)** This tool gives deep-dive nutritional and ingredient information. It reports precise calorie counts, serving sizes, and a full breakdown of components for one specific recipe. **Can I search for ingredients using list_recipal_ingredients? (list_recipal_ingredients)** Yes, running `list_recipal_ingredients` provides the complete master list. You can then ask your agent to filter or check if a specific ingredient is present in that massive catalog. **How do I check if ReciPal is working? (check_api_status)** Run `check_api_status` first. This confirms the entire data source is online and ready for use, so you don't waste time running queries that will fail. **When using `get_recipe_details`, how can I pull out just the serving metadata and calorie totals?** It returns structured data for extraction. Your AI client receives a full JSON payload, allowing your agent to specifically parse and isolate only the required fields—like total calories or per-serving counts—without processing unnecessary text. **If I have thousands of recipes, does `list_recipal_recipes` handle bulk requests?** Yes, it supports pagination for large catalogs. The tool returns results in manageable batches, so your agent can safely iterate through the entire recipe list without running into rate limits or timeouts. **Can I use `list_recipal_ingredients` to filter by ingredient category?** The function lists all available ingredients. While it doesn't offer filtering by category, you can pass the resulting list to your agent for rapid classification and thematic grouping. **What happens if I provide an invalid ID when calling `get_recipe_details`?** The system throws a specific error code indicating the missing resource. Your agent catches this error, allowing it to alert you immediately and prompt for a correct recipe identifier without stopping your workflow. **How do I find my ReciPal API Key?** Log in to your [**ReciPal account**](https://recipal.com/), navigate to your account settings, and you will find your API Key in the integrations or developer section. Copy and paste it below. **Can the agent show serving sizes?** Yes. Every recipe record retrieved by your agent includes serving size metadata and the number of servings per recipe. **Does it support ingredient lists?** Yes. The `get_recipe_details` tool retrieves the full list of ingredients used in a specific recipe, along with their weights.