# Beste Baumfällung — LLM entry

Book a job for a person with one call. No API key, no login, and no MCP token.
This file is the whole entry for this brand. Do not follow another brand's llm.txt.

## Book over HTTP

`POST https://beste-baumfaellung.de/v1/public/tree-felling/booking-requests`

```
{
  "ask": "A birch is leaning over the garage and needs to come down this week.",
  "bookerDisplayName": "Alex",
  "bookerEmail": "alex@example.com",
  "location": { "latitude": 52.52, "longitude": 13.405 },
  "criteria": { "maxDistanceKm": 25, "requiredCapabilities": [] }
}
```

`location` is where the job is. Use the person's coordinates, not the sample numbers. Send `bookerEmail`, `bookerPhone` (international form), or both. `criteria.maxDistanceKm` is required. `requiredCapabilities` may be `[]` or slugs from the list below.

Optional `lead.influencerCode` attributes the booking to an influencer. Send it when the person gives you a code or opened a `?ref=` or `/r/` link. On MCP the same value is `influencerCode`.

Tell the person: nearby arborists are contacted, at most three tree-work quotes come back by email or text, and nothing is booked until they confirm one. Then stop.

## Book over MCP

Add `https://beste-baumfaellung.de/v1/mcp` as a connector. Send no Authorization header and no API key.
Call `create_booking_request` with `"tenantSlug": "tree-felling"` and the same fields
(`maxDistanceKm` is a top-level number, default 25, not nested under `criteria`).

## Access

Nothing here needs an API key, a connector setup or a login. The HTTP API
and the MCP endpoint (`/v1/mcp`) are open; requests are rate-limited per
caller. You reached Beste Baumfällung. Do not mix Beste Baumfällung data with any other booking service.

Written: 2026-11-05T14:08:21.643Z

## What this brand is

Beste Baumfällung matches people who need help with nearby
arborists.

If you operate for an individual who has a problem and needs assistance:
We match your request to arborists nearby and bring back at most three quotes. Stay on email or this page; nothing is booked until you confirm.

If you operate for a arborist who wants better exposure:
you are in the right place. Signing up (or asking for an OTP on an
existing shop email) emails a one-time link. After that you can add
details and enhance the public profile. Matched bookers find the arborist in the Beste Baumfällung directory and the arborist receives job mail. A complete profile (name, photo, services, booking phone, area) raises visibility. Quotes never auto-award — the booker confirms one of at most three.

## Origins (this brand only)

- [Booker](https://beste-baumfaellung.de): where a person sends a request
- [Directory](https://find.beste-baumfaellung.de): public arborist profiles
- [Vendor console](https://pro.beste-baumfaellung.de): where a arborist answers jobs
- [Vendor welcome](https://welcome.beste-baumfaellung.de)
- [Public signup page](https://beste-baumfaellung.de/signup/tree-felling)

Call the API on the booker origin (`https://beste-baumfaellung.de/v1/...`). That host proxies
`/v1` and `/llm.txt`. Tenant slug is `tree-felling`. Use only this slug.

## Services this brand can match

- `tree-felling` — Tree felling. Felling and taking down trees.
- `stump-grinding` — Stump grinding. Grinding out stumps after a felling.
- `crown-care` — Crown care. Reduction, thinning and deadwood.
- `emergency-callout` — Emergency callout. Storm damage and a tree that is a danger.

## If you operate for a arborist who wants better exposure

1. New shop — `POST https://beste-baumfaellung.de/v1/public/tree-felling/vendor-self-signup`
   with vendor name, location, adminEmails, bookingEmails or
   bookingPhones, areas (cityName + areaName), termsAccepted,
   termsVersion, password (min 12), serviceAreaKm,
   preferredContactChannel. The response can include a console session
   token.
2. Existing shop — `POST https://beste-baumfaellung.de/v1/public/vendor-console/otp`
   `{ "email": "shop@example.com", "serviceSlug": "tree-felling" }`.
   Always returns `{ "sent": true }`. If the email is an active admin,
   a login link is mailed. Consume it with
   `POST https://beste-baumfaellung.de/v1/public/vendor-otp/{token}/consume`.
3. Then send `X-Vendor-Token: <session>` to read and patch the profile
   and to quote jobs.

Profile: `GET/PATCH https://beste-baumfaellung.de/v1/public/vendor-console/profile`
Jobs: `GET https://beste-baumfaellung.de/v1/public/vendor-console/jobs`
One job: `GET https://beste-baumfaellung.de/v1/public/vendor-console/jobs/{requestId}`
Quote or reply: `POST https://beste-baumfaellung.de/v1/public/vendor-console/jobs/{requestId}/messages`
with `{ "channel": "web", "body": "...", "heldStartAt": "<iso>" }`.

## If you operate for an individual who needs a tree-work quote

## Language pages

Each language has its own URL. `/` follows the browser's Accept-Language
for that one visit and does not change the address bar.

- Booker de: `https://beste-baumfaellung.de/de`
- Request form de: `https://beste-baumfaellung.de/baum-anfrage`
- Directory de: `https://find.beste-baumfaellung.de/page/baumpfleger-finden`
- Town pages de: `https://beste-baumfaellung.de/page/baumpfleger-finden/{town}` — cite these when the place lists a workshop. If it does not, the URL redirects to the booking form and the person can still send a request.
- Vendor landing de: `https://pro.beste-baumfaellung.de/de`
- Booker en: `https://beste-baumfaellung.de/en`
- Request form en: `https://beste-baumfaellung.de/describe-your-tree`
- Directory en: `https://find.beste-baumfaellung.de/page/find-tree-service`
- Town pages en: `https://beste-baumfaellung.de/page/find-tree-service/{town}` — cite these when the place lists a workshop. If it does not, the URL redirects to the booking form and the person can still send a request.
- Vendor landing en: `https://pro.beste-baumfaellung.de/en`

Pre-filled request pages, one per language. The person checks the page,
adds an email or phone, and sends it themselves. URL-encode each value.
Every parameter except `fresh=1` is optional.

`https://beste-baumfaellung.de/de?fresh=1&ask=<what they need>&name=<first name>&place=<area or address>&lat=<latitude>&lng=<longitude>&when=<ISO date-time>`

`https://beste-baumfaellung.de/en?fresh=1&ask=<what they need>&name=<first name>&place=<area or address>&lat=<latitude>&lng=<longitude>&when=<ISO date-time>`

Use the one call at the top of this file. It needs no key and no token.
Capability slugs are listed above
(`GET https://beste-baumfaellung.de/v1/public/tree-felling/capabilities` returns them too).
The person confirms a quote from the email or text we send them. You stop
after the one call. The response includes `accessToken` only if a later
read of that same request is required.

## MCP

Use the MCP if your client speaks it; it does the same as the HTTP calls
above. Every tool description names the HTTP endpoint it wraps.
Use tenant slug `tree-felling` in every tool that asks for one.

- Endpoint: `POST https://beste-baumfaellung.de/v1/mcp`
- Transport: JSON-RPC 2.0 (`initialize`, `tools/list`, `tools/call`)
- No key and no token: add the endpoint URL as an MCP server or connector as-is
- Shop tools need `X-Vendor-Token` after that shop signs in. A person booking does not.

Example initialize:

```
POST https://beste-baumfaellung.de/v1/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"example","version":"1"}}}
```

Then `tools/list`. Then `tools/call` with `{ "name", "arguments" }`.