Skip to main content
Glama
@bowlly/mcp-server

@bowlly/mcp-server

Official
by bowlly-net

Bowlly MCP Server

npm version

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

npx @bowlly/mcp-server --setup

After running, restart Claude Desktop and you're ready to go!

Option 2: Manual Configuration

  1. Edit your Claude Desktop config at the appropriate path for your OS:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%/Claude/claude_desktop_config.json

    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Add the Bowlly server configuration:

{
  "mcpServers": {
    "bowlly": {
      "command": "npx",
      "args": ["-y", "@bowlly/mcp-server"]
    }
  }
}
  1. Save the file and restart Claude Desktop

Available Tools

Tool

Description

search_products

Search by ingredients, conditions, form

get_product_detail

Full product info with ingredients

compare_products

Side-by-side comparison

analyze_nutrition

Ingredient breakdown & carb analysis

get_curation_list

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

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%/Claude/claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

Verification

To confirm the MCP server is working:

  1. Restart Claude Desktop (required after configuration changes)

  2. Open the tools menu - Look for the hammer icon in the bottom left

  3. Verify Bowlly tools appear - You should see 5 tools listed

  4. 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 --version

  • Try with npx: npx @bowlly/mcp-server --setup

  • Global 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 tools
analyze_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

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: searching, getting detail, nutritional analysis, comparison, curated lists, and health check. No overlapping functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, e.g., search_products, get_product_detail, analyze_nutrition.

    Tool Count5/5

    Six tools cover the core operations for a cat food database without being excessive or insufficient.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      5
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to search for recipes, get nutritional information, find ingredients, and more through the Spoonacular Food API using natural language.
      6
      19 npm
      6
      ISC