{
  "markdown": "# openfoodfacts-mcp\n\nMCP server for the [Open Food Facts](https://world.openfoodfacts.org/) API - search, read, and contribute to the world's largest open food database.\n\n## Use Cases\n\n**Look up a product by name**: \"How many calories in a Sainsbury's buffalo chicken wrap?\" -> searches by name, finds the product, and returns nutrition data.\n\n**Look up a product by barcode**: \"What's in this product with barcode 3017620422003?\" -> fetches Nutella's ingredients, Nutri-Score, and nutrition data.\n\n**Find healthy options**: \"Search for breakfast cereals with Nutri-Score A\" -> searches with category and nutrition grade filters.\n\n**Contribute data**: \"Add the product name and brand for barcode 12345678\" -> creates or updates a product entry on Open Food Facts.\n\n**Explore the database**: \"What brands of organic chocolate are in the database?\" -> uses autocomplete and search to explore.\n\n## Setup\n\nFollow the instructions on [install-mcp](https://adamjones.me/install-mcp/?config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm9wZW5mb29kZmFjdHMtbWNwIl0sIm5hbWUiOiJvcGVuZm9vZGZhY3RzIiwiZW52Ijp7Ik9GRl9VU0VSX0FHRU5UIjoib3BlbmZvb2RmYWN0cy1tY3AvMS4yLjAgKHlvdUBleGFtcGxlLmNvbSkifX0=), which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).\n\nSet `OFF_USER_AGENT` to identify your app (e.g. `openfoodfacts-mcp/1.2.0 (you@example.com)`). For write operations (adding/editing products, uploading images), also set `OFF_USER_ID` and `OFF_PASSWORD`.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `OFF_USER_AGENT` | Yes | User-Agent string, e.g. `\"AppName/1.0 (email@example.com)\"` |\n| `OFF_USER_ID` | No | Open Food Facts username (for write operations) |\n| `OFF_PASSWORD` | No | Open Food Facts password (for write operations) |\n| `OFF_COUNTRY` | No | Country subdomain (default: `world`) |\n\n## Tools\n\n| Tool | Description | Auth |\n|------|-------------|------|\n| `get_product` | Get product info by barcode | No |\n| `search_products_standard` | Search with structured filters (brand, category, Nutri-Score) | No |\n| `search_products_lucene` | Search with Lucene syntax, negation, and boolean logic | No |\n| `autocomplete` | Autocomplete brands, categories, labels, etc. | No |\n| `add_or_edit_product` | Add or update a product | Yes |\n| `upload_image` | Upload a product image | Yes |\n| `select_image` | Select, crop, and rotate an image | Yes |\n| `call_api` | Call any OFF API endpoint directly | Depends |\n| `get_api_docs` | Get OFF API documentation | No |\n\n## Contributing\n\nPull requests are welcomed on GitHub! To get started:\n\n1. Install Git and Node.js\n2. Clone the repository\n3. Install dependencies with `npm install`\n4. Run `npm run test` to run tests\n5. Build with `npm run build`\n\n## Releases\n\nVersions follow the [semantic versioning spec](https://semver.org/).\n\nTo release:\n\n1. Use `npm version <major | minor | patch>` to bump the version\n2. Run `git push --follow-tags` to push with tags\n3. Wait for GitHub Actions to publish to the NPM registry.\n",
  "bytes": 3075,
  "sha": "7494ed0deb177bc307341b7a9a73352fef62d2745bdce281f6daab201c1d7f8a",
  "repo_slug": "domdomegg/openfoodfacts-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_domdomegg_openfoodfacts_mcp_6a82a9fe/readme"
}