# beleg.bot

The official beleg.bot MCP server. It enables AI assistants to manage business receipts, companies, projects, and participants directly. Seamlessly create hospitality receipts (Bewirtungsbelege) and …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add kontrollfeld/beleg-bot

# Browse available tools
npx -y @smithery/cli@latest tool list kontrollfeld/beleg-bot

# Get full schema for a tool
npx -y @smithery/cli@latest tool get kontrollfeld/beleg-bot companies.list

# Call a tool
npx -y @smithery/cli@latest tool call kontrollfeld/beleg-bot companies.list '{}'
```

## Direct MCP Connection

Endpoint: `https://beleg-bot--kontrollfeld.run.tools`

**Optional config:**
- `apikey` (header) — Personal API key for beleg.bot (bb_ prefix). Manage at: https://beleg.bot/profile

## Tools (12)

- `companies.list` — List all companies in your account.
- `companies.create` — Create a new company.
- `projects.list` — List all projects, optionally filtered by company.
- `projects.create` — Create a new project under a company.
- `hosts.list` — List all hosts/employees in your account.
- `hosts.create` — Create a new host/employee.
- `guests.list` — List guests/customers, optionally filtered by company.
- `guests.create` — Create a new guest/customer under a company.
- `receipts.list` — List all hospitality receipts.
- `receipts.get` — Retrieve a single receipt with full details.
- `receipts.get_pdf` — Get a direct download URL for a receipt PDF.
- `receipts.create` — Manually create a hospitality receipt.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get kontrollfeld/beleg-bot <tool-name>
```

## Resources

- `belegbot://account/summary` — Statistics about companies, projects and receipts

## Prompts (2)

- `create_hospitality_receipt` (restaurant, amount) — Helper to create a hospitality receipt with all necessary data.
- `summarize_recent_expenses` — Summarizes recent expenses and receipts.