{"_id":"spoonacular-mcp","name":"spoonacular-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"spoonacular-mcp","version":"1.0.0","type":"module","main":"dist/index.js","bin":{"spoonacular-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc && node dist/index.js","test":"tsc && node dist/test.js","test:tools":"node -e \"process.stdin.pipe(process.stdout)\" | echo '{\\\"jsonrpc\\\":\\\"2.0\\\",\\\"id\\\":1,\\\"method\\\":\\\"tools/list\\\",\\\"params\\\":{}}' | node dist/index.js","prepublishOnly":"npm run build","pack:test":"npm pack --dry-run","version:patch":"npm version patch","version:minor":"npm version minor","version:major":"npm version major","postinstall":"echo 'Please set your SPOONACULAR_API_KEY environment variable. See README.md for details.'"},"keywords":["mcp","spoonacular","food","recipes","api","model-context-protocol","cooking","nutrition"],"author":{"name":"David Urbansky","email":"david@spoonacular.com"},"license":"ISC","description":"MCP server for the Spoonacular Food API - search recipes, get nutrition info, and more","repository":{"type":"git","url":"git+https://github.com/ddsky/spoonacular-mcp.git"},"homepage":"https://github.com/ddsky/spoonacular-mcp#readme","bugs":{"url":"https://github.com/ddsky/spoonacular-mcp/issues"},"engines":{"node":">=18.0.0"},"devDependencies":{"@types/node":"^24.2.0","ts-node":"^10.9.2","typescript":"^5.9.2"},"dependencies":{"@modelcontextprotocol/sdk":"^1.17.1","zod":"^3.25.76"},"_id":"spoonacular-mcp@1.0.0","gitHead":"943fa03442a34bd29492519d5720ce1fd08a0825","types":"./dist/index.d.ts","_nodeVersion":"22.8.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-TM1AJiy2ekKWGQxBH2UqoqkcBqNAxqllXr6WEMjl2digNN5feFnAAP3tJBjRM54SW4FLmde1l2JbW4lXfW3boA==","shasum":"af8a334036556c656f4ac6eecc9f42cb8d0f83ae","tarball":"https://registry.npmjs.org/spoonacular-mcp/-/spoonacular-mcp-1.0.0.tgz","fileCount":16,"unpackedSize":51575,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCoZK6z25G3FEtHq2hngl4zZ2OHYnvcDPNYa3rqK7HytwIhAOzVH7CnZxmE0QgXx12iDcoWGxSNBv3omq2qAdlkZxGp"}]},"_npmUser":{"name":"ddsky","email":"davidurbansky@hotmail.com"},"directories":{},"maintainers":[{"name":"ddsky","email":"davidurbansky@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/spoonacular-mcp_1.0.0_1754309902294_0.49923177014630005"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-04T12:18:22.293Z","1.0.0":"2025-08-04T12:18:22.483Z","modified":"2025-08-04T12:18:22.724Z"},"maintainers":[{"name":"ddsky","email":"davidurbansky@hotmail.com"}],"description":"MCP server for the Spoonacular Food API - search recipes, get nutrition info, and more","homepage":"https://github.com/ddsky/spoonacular-mcp#readme","keywords":["mcp","spoonacular","food","recipes","api","model-context-protocol","cooking","nutrition"],"repository":{"type":"git","url":"git+https://github.com/ddsky/spoonacular-mcp.git"},"author":{"name":"David Urbansky","email":"david@spoonacular.com"},"bugs":{"url":"https://github.com/ddsky/spoonacular-mcp/issues"},"license":"ISC","readme":"# Spoonacular MCP Server\r\n\r\nA Model Context Protocol (MCP) server that provides access to the [Spoonacular Food API](https://spoonacular.com/food-api/). This server enables AI assistants to search for recipes, get nutritional information, find ingredients, and more through the MCP protocol.\r\n\r\n[![npm version](https://badge.fury.io/js/spoonacular-mcp.svg)](https://badge.fury.io/js/spoonacular-mcp)\r\n[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)\r\n\r\n## Features\r\n\r\n- **Recipe Search**: Search for recipes by ingredients, diet, cuisine, and other criteria\r\n- **Recipe Information**: Get detailed recipe information including ingredients, instructions, and nutrition\r\n- **Ingredient Search**: Find and explore ingredient information\r\n- **Nutrition Analysis**: Analyze nutrition for ingredient lists\r\n- **Recipe by Ingredients**: Find recipes based on available ingredients\r\n- **Random Recipes**: Get random recipe suggestions with optional filtering\r\n\r\n## Quick Start\r\n\r\n### Installation\r\n\r\n```bash\r\nnpm install -g spoonacular-mcp\r\n```\r\n\r\n### Setup\r\n\r\n1. **Get a Spoonacular API key** (free at https://spoonacular.com/food-api/console#Dashboard)\r\n\r\n2. **Set your API key as an environment variable:**\r\n   ```bash\r\n   # Windows (PowerShell)\r\n   $env:SPOONACULAR_API_KEY=\"your_api_key_here\"\r\n   \r\n   # macOS/Linux\r\n   export SPOONACULAR_API_KEY=\"your_api_key_here\"\r\n   ```\r\n\r\n### Usage with MCP Clients\r\n\r\nAdd this configuration to your MCP client (Claude Desktop, etc.):\r\n\r\n```json\r\n{\r\n  \"servers\": {\r\n    \"spoonacular\": {\r\n      \"command\": \"spoonacular-mcp\",\r\n      \"env\": {\r\n        \"SPOONACULAR_API_KEY\": \"your_api_key_here\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Test the Installation\r\n\r\n```bash\r\n# Set your API key\r\nexport SPOONACULAR_API_KEY=\"your_key_here\"\r\n\r\n# Test the server\r\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}' | spoonacular-mcp\r\n```\r\n\r\n## Available Tools\r\n\r\n### `search_recipes`\r\nSearch for recipes with various filters.\r\n\r\n**Parameters:**\r\n- `query` (string): Search query for recipes\r\n- `number` (number, 1-100): Number of results (default: 10)\r\n- `diet` (string, optional): Diet type (vegetarian, vegan, gluten-free, etc.)\r\n- `intolerances` (string, optional): Comma-separated intolerances\r\n- `includeIngredients` (string, optional): Required ingredients (comma-separated)\r\n- `excludeIngredients` (string, optional): Ingredients to exclude (comma-separated)\r\n- `type` (string, optional): Meal type (main course, side dish, dessert, etc.)\r\n- `cuisine` (string, optional): Cuisine type (italian, mexican, chinese, etc.)\r\n\r\n### `get_recipe_information`\r\nGet detailed information about a specific recipe.\r\n\r\n**Parameters:**\r\n- `id` (number): Recipe ID\r\n- `includeNutrition` (boolean): Include nutrition information (default: false)\r\n\r\n### `search_ingredients`\r\nSearch for ingredients by name.\r\n\r\n**Parameters:**\r\n- `query` (string): Ingredient search query\r\n- `number` (number, 1-100): Number of results (default: 10)\r\n- `metaInformation` (boolean): Include meta information (default: false)\r\n\r\n### `analyze_nutrition`\r\nAnalyze nutrition for a list of ingredients.\r\n\r\n**Parameters:**\r\n- `ingredientList` (string): List of ingredients, one per line\r\n- `servings` (number): Number of servings\r\n\r\n### `find_recipes_by_ingredients`\r\nFind recipes based on available ingredients.\r\n\r\n**Parameters:**\r\n- `ingredients` (string): Comma-separated list of available ingredients\r\n- `number` (number, 1-100): Number of recipes (default: 5)\r\n- `ranking` (number, 1-2): Ranking strategy (1=maximize used, 2=minimize missing)\r\n\r\n### `get_random_recipes`\r\nGet random recipes with optional filtering.\r\n\r\n**Parameters:**\r\n- `number` (number, 1-100): Number of random recipes (default: 1)\r\n- `tags` (string, optional): Comma-separated tags for filtering\r\n\r\n## Development\r\n\r\nTo run in development mode:\r\n\r\n```bash\r\nnpm run dev\r\n```\r\n\r\nTo build:\r\n\r\n```bash\r\nnpm run build\r\n```\r\n\r\n## API Rate Limits\r\n\r\nThe free Spoonacular API plan includes:\r\n- 150 requests per day\r\n- Rate limiting applies\r\n\r\nConsider upgrading to a paid plan for production use.\r\n\r\n## License\r\n\r\nISC\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please feel free to submit a Pull Request.\r\n","readmeFilename":"README.md","_rev":"1-8c1a331115c330509625a9ff838e8f59"}