Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the BarBrain Inventory API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbarbrain.com%2Fbarbrain" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbarbrain.com%2Fbarbrain" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with BarBrain Inventory API.
Pull a company's full beverage inventory for daily sync into accounting or reporting systems
Filter inventory records by a start and end date using the dateFrom and dateTo query parameters
Issue new company-specific API tokens for external integrations
Rotate an existing API token when a credential needs replacing
GET STARTED
Revoke an API token to cut off a retired integration's access
Patterns agents use BarBrain Inventory API for, with concrete tasks.
★ Agent-Driven Inventory Sync
An AI agent connected through Jentic pulls a bar's beverage inventory on a schedule and writes it into downstream accounting or analytics tools. The BarBrain Inventory API returns each company's stock records for a chosen date range, so the agent can run nightly exports without a human logging into the dashboard. Because inventory reads and token management are separate operations, the agent can be limited to read-only inventory access.
Fetch the company inventory for the previous day using dateFrom and dateTo and post the stock counts to the accounting system
Daily Inventory Reporting
Operations teams pull beverage stock levels each morning to feed dashboards and reorder decisions. The BarBrain Inventory API exposes inventory retrieval filtered by dateFrom and dateTo, returning per-item counts a reporting pipeline can chart without manual data entry.
Retrieve inventory for the last seven days and generate a stock-movement summary report
API Token Lifecycle Management
Integrations need scoped, rotating credentials. The BarBrain Inventory API lets an admin list, create, rotate, and revoke company-specific tokens, so a team can provision a token for a new integration and retire it cleanly when the integration is decommissioned. Token management operations require a Firebase ID token.
Create a new API token for a reporting tool, then revoke the token previously issued to a retired integration
5 endpoints — the barbrain inventory api retrieves detailed bar and beverage inventory records for a company, filtered by a date range, so external systems can sync stock counts on a schedule.
METHOD
PATH
DESCRIPTION
/fetchInventories
Fetch company inventory records
/companies/{companyId}/api-tokens
List API tokens for a company
/companies/{companyId}/api-tokens
Create an API token
/companies/{companyId}/api-tokens/{tokenId}/rotate
Rotate an API token
/companies/{companyId}/api-tokens/{tokenId}
Revoke an API token
/fetchInventories
Fetch company inventory records
/companies/{companyId}/api-tokens
List API tokens for a company
/companies/{companyId}/api-tokens
Create an API token
/companies/{companyId}/api-tokens/{tokenId}/rotate
Rotate an API token
/companies/{companyId}/api-tokens/{tokenId}
Revoke an API token
What agents get from Jentic-routed access to this vendor.
Setup
Wiring BarBrain by hand means handling its bearer API token for inventory reads and a separate Firebase ID token for token management, plus the date-range parameters on each fetch. Through Jentic you install once, import BarBrain from the API Directory, store the token once, and your agent calls it.
Permission scoping
BarBrain puts the company id in the URL path for token management (/companies/{companyId}/api-tokens), so a rule can pin your agent to one company. You choose the operations it may call, so you can allow the inventory fetch and leave token creation, rotation, and revocation out unless you add them.
Credential isolation
Your BarBrain API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'sync bar inventory data', and Jentic returns the matching BarBrain operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using BarBrain Inventory API through Jentic.
What authentication does the BarBrain Inventory API use?
The BarBrain Inventory API authenticates inventory reads with a bearer API token in the Authorization header, per its OpenAPI spec. Token management operations such as listing, creating, rotating, and revoking tokens require a Firebase ID token for an authenticated admin user. Through Jentic the token is stored encrypted by your own Jentic One instance and injected when your agent calls the API.
Is there a BarBrain Inventory API MCP server?
You don't need an MCP server to give your agent the BarBrain Inventory API. Jentic connects it directly from the API Directory: import it, store your API token once, and your agent calls the inventory and token operations it needs. Nothing extra is loaded into the agent's context until a call is made.
Can I limit what my agent is allowed to do with the BarBrain Inventory API?
Yes. You choose the operations your agent may call, so you can allow only the inventory fetch and leave the token create, rotate, and revoke operations out. Every call the agent makes is logged, so you can see exactly what it retrieved.
Can I export a company's inventory for a specific date range with the BarBrain Inventory API?
Yes. The inventory fetch accepts dateFrom and dateTo query parameters, returning the company's beverage stock records for that window so an agent can run scheduled exports into accounting or analytics tools.
Can the BarBrain Inventory API manage the tokens my integrations use?
Yes. Admins can list existing tokens, create a new company-specific token, rotate a token when it needs replacing, and revoke a token to cut off access. These token management operations require a Firebase ID token rather than the standard API token.
How do I sync BarBrain inventory through Jentic?
Search Jentic for 'sync bar inventory data', which returns the inventory fetch operation with its input schema. Add the BarBrain Inventory API from the Jentic API Directory, store your API token once, and your agent can pull stock records on a schedule. To run it on your own infrastructure, install Jentic One from its GitHub repo.
Know of an official OpenAPI document? Contribute it →
For Agents
Retrieve a company's bar inventory over a date range and manage the API tokens that grant access, including creating, rotating, and revoking them.
Use for: Sync today's bar inventory into our accounting system, Get inventory counts for a specific date range, Create a new API token for a reporting integration, Rotate the API token we use for nightly inventory exports
Not supported: Does not handle point-of-sale sales, purchasing, or supplier orders. Use for reading company beverage inventory and managing API access tokens only.
The BarBrain Inventory API retrieves detailed bar and beverage inventory records for a company, filtered by a date range, so external systems can sync stock counts on a schedule. It also manages the API tokens that authorize that access, letting admins list, create, rotate, and revoke company-specific tokens. Inventory reads use a bearer API token, while token management requires a Firebase ID token for admin users.