Bar Assistant

You run an MCP server to manage Bar Assistant data: view your shelf, discover cocktails you can make, add or remove ingredients, and search for ingredients. It connects to your Bar Assistant instance and exposes convenient commands you can call from an MCP client to drive your home bar workflows.

How to use

Use an MCP client to talk to the Bar Assistant MCP server. You can discover your available bars, view your shelf ingredients, see which cocktails you can make with what you have, and update your shelf by adding or removing ingredients. You can also search for ingredients by name to find their IDs before updating your shelf.

How to install

Prerequisites you need before installing:

• Python installed in your environment (preferred) or a runtime that supports Python packages.
• Internet access to install dependencies.
• An MCP client capable of talking to HTTP MCP servers or starting a local stdio MCP server process.

Choose one of the following installation approaches.

Additional configuration and usage notes

Connection to Bar Assistant MCP server can be done in two ways. The preferred method is an HTTP MCP connection to your remote server endpoint. Alternatively, you can run a local stdio MCP server process that starts via a command.

Environment variables you may set for convenience when using the HTTP or stdio approaches:

• BAR_ASSISTANT_API_URL: Your Bar Assistant API URL (including the /api path)
• BAR_ASSISTANT_TOKEN: Your personal access token
• BAR_ASSISTANT_BAR_ID: The bar ID you want to operate on (optional for some workflows)

Troubleshooting

If you cannot reach the API, verify your API URL and token. For an HTTP connection, confirm the URL ends with /api and that your token has the correct scopes. If you run a local stdio server, ensure the runtime command is available and that environment variables are set if required by your client.

Available tools

list_bars

Discover all bars you have access to and get their IDs.

get_shelf_ingredients

List all ingredients on your bar shelf. Optional parameters: bar_id, page.

get_shelf_cocktails

See all cocktails you can make with your current ingredients. Optional: bar_id, page.

add_ingredients_to_shelf

Add ingredients to your shelf by providing an array of ingredient IDs. Optional: bar_id.

remove_ingredients_from_shelf

Remove ingredients from your shelf by providing an array of ingredient IDs. Optional: bar_id.

search_ingredients

Search for ingredients by name to find their IDs. Optional: bar_id.