# agent-bev for a buyer's agent

The world's largest agentic B2B hub for beer, wine and spirits. Powered by CUVEE. Trade only. agent-bev answers the trade — importers, distributors, wholesalers, retailers and the hospitality trade — and never consumers. Artificial intelligence makes mistakes. agent-bev is an information source, not a recommendation.

## What a buyer's agent can do

- `list_nodes` — list the countries on the record and which of them are open.
- `search_drinks` — find beers, wines, spirits, ciders and ready-to-drink drinks by name, style, origin or category; it returns record ids such as `es-bev:000123`, each with its CUVEE.
- `find_producer` — find a maker and its products across every open country.
- `get_record` — read one product in full by `record_id`: `producer`, `brand`, `product`, `category`, `origin`, `abv`, `size`, `gtin` and the rest, each field with its source page.
- `compare_drinks` — compare two to ten products side by side, field by field.
- `get_order_route` — get the maker's or distributor's trade channel to order a product.

## Ordering

- `create_order_intent` — place an order intent for one to ten record ids, with the quantity, the delivery market and the buyer's organisation and email.
- `get_offers` — read the makers' offers on that intent.
- `accept_offer` — accept one offer and place the order. Accepting is one x402 paid call: the door answers HTTP 402 with the payment offer until it is paid, then settles and signs the order. The receipt key is at [bev-x402.ai/.well-known/jwks.json](https://bev-x402.ai/.well-known/jwks.json). A refused or unpaid call is never charged.

## What the door refuses

- Consumers: agent-bev takes no consumer order and never gives a consumer shop as an order route.
- Anything outside the trade audience.
- Countries not yet open: `list_nodes` says which are open.

## Connect

- Remote door (Model Context Protocol, MCP): [https://mcp.bev-buyer.ai/mcp](https://mcp.bev-buyer.ai/mcp)
- Local install: `npx -y @agent-bev/mcp-server`
- Claude (web, desktop, Claude Code and the Claude API): add the remote door as a custom connector. Reads need no sign-in.

```
{ "mcpServers": { "agent-bev": { "command": "npx", "args": ["-y", "@agent-bev/mcp-server"] } } }
```

## The record

Every field carries its source page, the reader that read it and its state; every record carries its CUVEE and its claim status.

A field no open source states is marked absent, never guessed.

Operator: Agent Holdings S.A., Barcelona · keys held by [Agentic KG Holdings](https://agent-kg.ai/) · registry [bev-registry.ai](https://bev-registry.ai/) · Artificial intelligence makes mistakes. agent-bev is an information source, not a recommendation.

---

Canonical: https://agent-bev.ai/docs