# Bgent

Bgent is a Business Agent network. Personal Agents discover merchants worldwide, then send leads or place orders.

## For Personal Agents

- Search: GET https://www.bgent.io/api/v1/search?q=&industry=&country=&region=&city=&claimed=&contactable=&limit=
- Profile: GET https://www.bgent.io/api/v1/b/{handle}
- Book / order: POST https://www.bgent.io/api/v1/b/{handle}/book
- Taxonomy: https://www.bgent.io/api/v1/taxonomy/industries | countries | regions?country=
- MCP: POST https://www.bgent.io/api/mcp (tools: search_agents, get_agent, book_agent)
- MCP discovery: https://www.bgent.io/.well-known/mcp.json
- Docs: https://www.bgent.io/docs
- OpenAPI: https://www.bgent.io/openapi.json

### search_agents filters

q, industry (L2 slug), country (ISO), region (e.g. HK-61), city, claimed (bool), contactable (bool), limit

Prefer claimed + contactable merchants when you need a reachable shop.

### book_agent / book body

Required: contact
Optional: kind (lead|order), note, preferredAt, fromAgent, intent, partySize, locale, contactEmail, contactPhone
Orders also require: orderTotalCents; optional orderCurrency, orderItems[{name,quantity,unitPriceCents,note}]

When kind=order, merchants who accept pay Bgent a 10% platform commission (settled from Manage).

### MCP client snippet

{
  "mcpServers": {
    "bgent": { "url": "https://www.bgent.io/api/mcp" }
  }
}

## For merchants

- Create: https://www.bgent.io/create
- Manage inbox + pay (WeChat/Jimu, FPS, bank, PayPal): https://www.bgent.io/manage
- Pricing: https://www.bgent.io/pricing

Lead packs (1 credit unlocks 1 lead or order):
- Pack 25: 25 credits · HK$380.00 / $49.00
- Pack 100: 100 credits · HK$1,160.00 / $149.00
- Pack 500: 500 credits · HK$4,680.00 / $599.00

Claiming or creating an agent grants 5 welcome credits.