Use TheMealDB with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Access a global database of recipes, ingredients, and meal categories to find culinary inspiration and detailed cooking instructions.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 13 capabilities
The complete TheMealDB capability set.
These are the exact actions your AI can choose when you ask it to work with TheMealDB.
01-04
4 capabilities in this set.
Part of 13 available through TheMealDB.
- 01
Filter by ingredient
For V2 premium users, multiple ingredients can be comma-separated. Filter meals by main ingredient(s)
- 02
List all categories
List all meal categories with descriptions
- 03
List areas
List simple browseable areas (countries/regions)
- 04
List categories
List simple browseable categories
05-07
3 capabilities in this set.
Part of 13 available through TheMealDB.
- 05
List ingredients
List simple browseable ingredients
- 06
Filter by category
G., Seafood). Filter meals by category
- 07
Filter by area
G., Canadian). Filter meals by area
08-10
3 capabilities in this set.
Part of 13 available through TheMealDB.
- 08
Get latest meals
Requires a premium API key and V2 API version. Retrieve the most recently added meals (Premium V2 Only)
- 09
Get meal by ID
Lookup full meal details by ID
- 10
Get random meal
Lookup a single random meal
11-13
3 capabilities in this set.
Part of 13 available through TheMealDB.
- 11
Get random meals selection
Requires a premium API key and V2 API version. Lookup a selection of 10 random meals (Premium V2 Only)
- 12
List meals by first letter
List all meals starting with a specific letter
- 13
Search meals by name
Search for meals by their full or partial name
Observed, not estimated
859ms average. Fast in production.
TheMealDB is checked daily against the live service.
- Fastest day
- 748ms
- Slowest day
- 1099ms
- 14-day trend
- Stable+4%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 13 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of TheMealDB, so you can see the experience inside your AI.
It does not authenticate your account with TheMealDB. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
TheMealDB Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_dhRtKcxtyaCQHzizhcQD8PboSErXP3PYFbLIO6nR/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — TheMealDB capabilities are ready to use.
{
"mcpServers": {
"themealdb-extended-mcp": {
"url": "https://edge.vinkius.com/vk_preview_dhRtKcxtyaCQHzizhcQD8PboSErXP3PYFbLIO6nR/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions TheMealDB owners ask.
- 01
How do I get the full cooking instructions for a specific meal?
Use the get_meal_by_id capability with the unique Meal ID. The agent will return the full recipe, including step-by-step instructions and a complete list of ingredients with measurements.
- 02
Can I search for recipes based on what I have in my fridge?
Yes! You can use the filter_by_ingredient capability to find meals that feature a specific main ingredient. For Premium V2 users, you can even provide a comma-separated list of multiple ingredients.
- 03
What is the difference between the free and premium API access?
The free tier (API key '1') allows standard searching and filtering. Premium V2 access enables advanced capabilities like get_latest_meals, get_random_meals_selection (10 at once), and multi-ingredient filtering.
Explore
More in Knowledge Management
BigOven AI Connector
Access over a million recipes via BigOven — search dishes, read reviews, and explore collections directly from
ViewUdemy AI Connector
Access Udemy API to search courses, retrieve instructor reviews, QA, and messages.
ViewProject Gutenberg AI Connector
Universal public domain library — search and retrieve thousands of free books via AI.
ViewNutritional Estimator AI Connector
Calculate total and per-serving macro and calorie content of recipes using weight-based nutritional density da
View
Suggestions
Ingredient Weight Converter AI Connector
Convert volumetric culinary measurements into mass in grams based on specific ingredient densities.
ViewPexels AI Connector
Search and retrieve high-quality royalty-free photos and videos from Pexels directly within your AI agent.
ViewPexels AI Connector
Retrieve free high-quality stock media via Pexels — search photos, track videos natively, and explore curated
ViewEIA Electricity — Power Grid Intelligence AI Connector
U.S. power grid data: hourly demand by balancing authority, generation by fuel source, retail electricity pric
View
