@bowlly/mcp-server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@bowlly/mcp-server Find low-carb wet cat foods with fish"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bowlly MCP Server
MCP (Model Context Protocol) server for Bowlly cat food product search and ingredient analysis. Enables Claude Desktop to search, analyze, and compare cat food products.
Prerequisites
Node.js 22+ - Required for running the MCP server
Claude Desktop - Download here if not installed
Related MCP server: Open Food Facts MCP Server
Quick Start
Option 1: One-Command Setup (Recommended)
npx @bowlly/mcp-server --setupAfter running, restart Claude Desktop and you're ready to go!
Option 2: Manual Configuration
Edit your Claude Desktop config at the appropriate path for your OS:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Add the Bowlly server configuration:
{
"mcpServers": {
"bowlly": {
"command": "npx",
"args": ["-y", "@bowlly/mcp-server"]
}
}
}Save the file and restart Claude Desktop
Available Tools
Tool | Description |
| Search by ingredients, conditions, form |
| Full product info with ingredients |
| Side-by-side comparison |
| Ingredient breakdown & carb analysis |
| Best-of category recommendations |
Example Natural Language Queries
"Find grain-free dry cat foods"
"Show me wet foods without chicken"
"Analyze the nutrition of Blue Buffalo Wilderness"
"Compare Orijen and Acana cat foods"
"What are the best low-carb options?"
"Show me foods for cats with sensitive stomachs"Configuration
Config File Locations by Platform
Platform | Path |
macOS |
|
Windows |
|
Linux |
|
Verification
To confirm the MCP server is working:
Restart Claude Desktop (required after configuration changes)
Open the tools menu - Look for the hammer icon in the bottom left
Verify Bowlly tools appear - You should see 5 tools listed
Test with a query: Try asking "Find grain-free dry cat foods"
Troubleshooting
Tools not showing in Claude?
Restart Claude Desktop - Configuration changes require a restart
Check the config file path - Ensure you're editing the correct file for your OS
Verify JSON syntax - Use a JSON validator if unsure
Check Claude Desktop logs:
macOS:
~/Library/Logs/Claude/Windows:
%APPDATA%/Claude/Logs/Linux:
~/.config/Claude/Logs/
"Command not found" errors?
Ensure Node.js 22+ is installed:
node --versionTry with npx:
npx @bowlly/mcp-server --setupGlobal install fallback:
npm install -g @bowlly/mcp-server
Configuration not persisting?
Check file permissions - Ensure you have write access to the config directory
Use absolute paths - Relative paths may not resolve correctly
Validate JSON format - Missing commas or brackets are common issues
License
MIT
Available Tools
6 toolsanalyze_nutritionA
Analyzes the nutritional content of a cat food product by productId. Returns ingredient breakdown, DMB conversion, carb estimation, and nutritional context. Use when user asks about nutrition, ingredients, or carb content of a specific product.
Inputs: productId (required).
compare_productsA
Compare 2-3 cat food products side-by-side on nutrition and ingredients. Pass product IDs from search_products results. Returns raw comparison data — interpret and explain the differences to the user.
Inputs: productIds (required).
get_curation_listA
Retrieve curated best-of category data by slug. Returns summary by default with opt-in extended content.
Inputs: slug (required), includeSections, includeFaq.
get_healthA
Check MCP server connectivity and rate limit status. Use this when experiencing connection issues or before batch operations. Returns server status, version, session ID, and rate limit information.
Inputs: no named parameters.
get_product_detailA
Get complete information about a specific cat food product including full ingredient list, nutrition facts, calorie density, and health condition tags. Requires a product ID from search_products results.
Inputs: productId (required).
search_productsA
Search Bowlly's cat food database by ingredients, health conditions, or food form. Use this when the user asks to find, filter, or recommend cat foods. Returns a summary list — use get_product_detail for full information about specific products.
Inputs: query, form, conditions, includeIngredients, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: searching, getting detail, nutritional analysis, comparison, curated lists, and health check. No overlapping functionality.
All tool names follow a consistent verb_noun pattern using snake_case, e.g., search_products, get_product_detail, analyze_nutrition.
Six tools cover the core operations for a cat food database without being excessive or insufficient.
The tool set covers search, detail, nutrition analysis, comparison, and curated lists. Missing a tool to list all brands or categories, but search handles that indirectly.
Maintenance
Related MCP Connectors
Look up a packaged food by barcode, search and compare products, and check listed allergens.
Food list analyzer and cited food answers for agents. Also recipes, meal plans and grocery lists.
Product search for AI shopping agents: prices and buy links from big retailers. No key needed.
Search structured recipes, scale servings, match pantry ingredients, and build shopping lists.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides grocery price and nutritional information search capabilities, allowing AI agents to search for food products, compare prices, and analyze nutritional content across different grocery stores.1-
- AlicenseAqualityDmaintenanceEnables AI assistants to access the Open Food Facts database to query detailed food product information, nutritional data, and environmental scores. Supports product lookup by barcode, smart search with filtering, nutritional analysis, product comparison, and dietary recommendations to help users make informed food choices.51MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to search for recipes, get nutritional information, find ingredients, and more through the Spoonacular Food API using natural language.619 npm6ISC
- FlicenseBqualityDmaintenanceEnables AI assistants to access food product information, providing nutritional analysis, product comparisons, and recipe suggestions using the Open Food Facts database.21-