# bearing-local-business

`bearing-local-business` is a Bearing reference stdio MCP server for a fictional bakery, **Cypress & Crumb**. It makes a local business agent-queryable so a customer's AI agent can check hours, inspect the menu, ask about custom-order timing, and initiate a demo inquiry.

All data is fictional demo data. The server makes no network calls, persists nothing, and is intended as a reference for the agentic economy: a local business exposing a clean, typed MCP surface for discovery and transaction initiation.

## Tools

### `get_business_profile`
- Input: none
- Output: bakery name, tagline, weekly hours, address, phone, pickup details, delivery details, and custom-order lead time

### `get_menu`
- Input: `{ category?: string }`
- Output: the full menu grouped by category, or the filtered category if provided

### `check_custom_order_availability`
- Input: `{ date: string, orderType?: string }`
- Output: whether the requested date is far enough out for a custom order, the integer days out, and the earliest available date

### `submit_order_inquiry`
- Input: `{ name: string, contact: string, details: string, date?: string }`
- Output: a demo inquiry reference plus the captured request details

## Run

Development:

```bash
bun run dev
```

Build and run the compiled server:

```bash
bun run build
bun run start
```

The server reads `src/data/demo-bakery.json` at runtime with `readFileSync` and `import.meta.url` path resolution. The loader checks both the source-layout path used by `bun run src/index.ts` and the built-layout path used by `node dist/index.js`, so the JSON file does not need to be copied into `dist/`.

## MCP Client Config

Example Claude Desktop or compatible stdio client config:

```json
{
  "mcpServers": {
    "bearing-local-business": {
      "command": "node",
      "args": [
        "/absolute/path/to/bearing-mcp/dist/index.js"
      ]
    }
  }
}
```

For local development, you can also point a client at Bun:

```json
{
  "mcpServers": {
    "bearing-local-business": {
      "command": "bun",
      "args": [
        "run",
        "/absolute/path/to/bearing-mcp/src/index.ts"
      ]
    }
  }
}
```

## Point It At A Real Business

To adapt this for a real business, replace the fictional `demo-bakery.json` source with a consented, authenticated system of record such as a POS, ordering backend, or inventory service. In a real deployment:

- keep the MCP tool contracts stable
- add authentication and authorization
- persist inquiries into the business's system
- fetch live hours, menu, and availability from an approved source

This demo intentionally does none of that. It persists nothing and only echoes a simulated inquiry capture.