# BeeHero

> BeeHero is a precision-pollination company that instruments commercial beehives and crop fields with low-cost IoT sensors and turns the resulting acoustic, temperature, humidity and bee-activity data into pollination analytics for growers, beekeepers and agribusinesses. It exposes a bearer-token REST API for sensor, audio and gateway data, and publishes an official MCP server to npm for agent access to its platform entities.

- Generated by the API Evangelist enrichment pipeline on 2026-08-02 (method: generated; BeeHero publishes no llms.txt — /llms.txt returns 404 on beehero.io, www.beehero.io and docs.beehero.io).
- Authentication: POST /login with email and password returns an `access_token`; send it as `Authorization: Bearer <access_token>` on every other call.
- API server: https://backend.beehero.io/external

## APIs

- [BeeHero API](https://docs.beehero.io/): Swagger UI reference for the /external REST surface — login, in-hive audio samples, sensor samples, gateway samples and gateway configuration.
- [BeeHero OpenAPI 3.0.0](https://docs.beehero.io/swagger.json): the machine-readable contract, 12 operations across the Auth, Audio, Sensors and Gateways tags.

## Specs and artifacts

- [OpenAPI](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/openapi/beehero-openapi-original.yml): harvested verbatim from docs.beehero.io/swagger.json.
- [MCP server manifest](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/mcp/beehero-mcp.yml): the 11 tools and 10 prompts published in beehero-mcp on npm.
- [Tool crosswalk](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/mcp/beehero-tool-crosswalk.yml): why the MCP tool surface and the REST surface do not overlap.
- [Authentication](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/authentication/beehero-authentication.yml)
- [Conventions](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/conventions/beehero-conventions.yml)
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/errors/beehero-problem-types.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/data-model/beehero-data-model.yml)
- [Agent skills](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/skills/_index.yml)
- [Domain security](https://raw.githubusercontent.com/api-evangelist/beehero/refs/heads/main/security/beehero-domain-security.yml)

## Operations

- `login` — POST /login — exchange email and password for an access_token.
- `get_audio_sample_by_mac_address` — POST /get_audio_samples — in-hive audio files for a list of sensor MAC addresses over a date range.
- `get_sensors_sample_by_mac_address` — POST /sensors/samples — temperature, humidity and bee in/out counts for a list of sensor MAC addresses over a date range.
- `get_sensors_connected_by_gateway_mac` — POST /sensors/samples_connected — sensors currently connected to a gateway.
- `update_sensor_name` — PUT /sensors/update_sensor_name — rename a sensor.
- `get_gateways_sample_by_mac_address` — POST /gateways/samples — gateway sample data for a list of gateway MAC addresses.
- `get_gateway_mac_address` — POST /gateways/samples/get_mac_address — resolve a gateway MAC address.
- `get_gateway_config_status` — POST /gateways/gateway_config_status — read the skip-remote configuration status of a gateway.
- `add_skip_remote_to_gateway_config` — PUT /gateways/add_skip_remote — add skip-remote to a gateway configuration.
- `remove_skip_remote_from_gateway_config` — PUT /gateways/remove_skip_remote — remove skip-remote from a gateway configuration.
- `movement_interrupt_gateway_config` — PUT /gateways/movement_interrupt — set the movement-interrupt setting on a gateway.
- `rssi_configuration` — PUT /gateways/rssi_configuration — set the RSSI configuration on a gateway.

## MCP

- [beehero-mcp on npm](https://www.npmjs.com/package/beehero-mcp): official BeeHero MCP server, stdio transport, node runtime, MCPB bundle included. Configure with API_USER_EMAIL, API_PASSWORD and API_SERVER_URL.
- Tools: getEntities, getEntity, getAvailableEntities, getRelations, getBeeheroFilter, getBeekeeperHivesAndFramesByGroupId, getInspectionsByGroupId, getExperimentsByName, getExperimentPointsByExperimentId, getExperimentSerializationsByExperimentPointId, getExperimentSerializationByFileName.
- Entities: users, groups, farms, orchards, orchard-markers, yards, gateways, sensors, sensor-daily-statuses, hardware-shipments, hardware-orders, firmware-versions, pollination-tasks, crop-types, in-field-serializations, hourly-pip-sensor-updates, orchard-weather-inspections, hourly-orchard-marker-updates, seasons, inspections, experiments.

## Docs

- [BeeHero](https://www.beehero.io/)
- [Technology](https://www.beehero.io/technology)
- [In-hive — Precision Pollination as a Service](https://www.beehero.io/in-hive---precision-pollination-as-a-service)
- [In-field — Pollination Insight Platform (PIP)](https://www.beehero.io/in-field---pollination-insight-platform-pip)
- [Beekeeping solutions](https://www.beehero.io/beekeeping-solutions)
- [Crops we pollinate](https://www.beehero.io/crops-we-pollinate)
- [Research](https://www.beehero.io/research)
- [The Buzz blog](https://www.beehero.io/the-buzz)
- [Contact](https://www.beehero.io/contact-us)
- [Terms and conditions](https://www.beehero.io/legals)
- [Privacy policy](https://www.beehero.io/privacy-policy)
- [Login](https://accounts.beehero.io/)