{"name":"ibeekeeper","title":"iBeekeeper","version":"1.1.0","description":"Access to your iBeekeeper apiary management: apiaries, beehives, inspection cards, treatments, feedings, harvests and tasks.","url":"https://mcp.ibeekeeper.de","endpoint":"https://mcp.ibeekeeper.de","transport":"streamable-http","protocol_versions":["2025-11-25","2025-06-18","2025-03-26","2024-11-05"],"authentication":{"type":"oauth2","alternatives":["apiKey"],"instructions":"OAuth 2.1 with PKCE; clients may register dynamically or present a client ID metadata document. Discovery via /.well-known/oauth-authorization-server. Alternatively send an API key (ibk_sk_...) created in the iBeekeeper settings as 'Authorization: Bearer <key>'.","authorization_server":"https://mcp.ibeekeeper.de/.well-known/oauth-authorization-server","resource_metadata":"https://mcp.ibeekeeper.de/.well-known/oauth-protected-resource"},"capabilities":{"tools":true,"resources":true,"prompts":false},"ui_resources":["ui://ibeekeeper/overview/073f3da29589.html"],"tools":[{"name":"list_beehives","title":"List beehives","description":"Lists the beehives (colonies) the user owns or has been granted access to, with ibeekeeperid, title and apiary. Call this first to discover beehives before using beehive-specific tools. Archived beehives are excluded unless requested.","inputSchema":{"type":"object","properties":{"apiary":{"type":"string","description":"The apiary, given as its ibeekeeperid (preferred) or its exact title."},"include_archived":{"type":"boolean","description":"Also return archived beehives (default false)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_beehive","title":"Get beehive details","description":"Returns master data of one beehive: title, notes, apiary, groups, bee breed, hive type, box and frame counts, date of the latest inspection card and whether the user owns it or received it via sharing.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."}},"additionalProperties":false,"required":["beehive"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"update_beehive","title":"Update beehive master data","description":"Changes title, notes, box count or frame count of a beehive the user owns or may edit. Provide only the fields to change; at least one is required. Does not delete or archive anything.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."},"title":{"type":"string","minLength":1,"maxLength":255,"description":"New title."},"info":{"type":"string","maxLength":5000,"description":"New free-text notes about the beehive."},"box_count":{"type":"integer","minimum":1,"maximum":20,"description":"Number of hive boxes."},"frame_count":{"type":"integer","minimum":1,"maximum":40,"description":"Frames per box."}},"additionalProperties":false,"required":["beehive"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"list_apiaries","title":"List apiaries","description":"Lists the user's apiaries (bee yards / locations) with ibeekeeperid, title and number of active beehives.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_apiary","title":"Get apiary details","description":"Returns details of one apiary including its address (if recorded) and the beehives currently placed there.","inputSchema":{"type":"object","properties":{"apiary":{"type":"string","description":"The apiary, given as its ibeekeeperid (preferred) or its exact title."}},"additionalProperties":false,"required":["apiary"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_cards","title":"List inspection cards","description":"Lists inspection cards (Stockkarten) of one beehive, newest first, each with date, ibeekeeperid and all recorded field values. Use get_latest_inspection when only the most recent inspection is needed.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Maximum number of cards (default 10)."}},"additionalProperties":false,"required":["beehive"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_card","title":"Get one inspection card","description":"Returns one inspection card by its ibeekeeperid with beehive, date and all field values.","inputSchema":{"type":"object","properties":{"card":{"type":"string","description":"ibeekeeperid of the inspection card."}},"additionalProperties":false,"required":["card"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_latest_inspection","title":"Get latest inspection","description":"Returns the most recent inspection card of a beehive, or states that none exists.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."}},"additionalProperties":false,"required":["beehive"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_card_fields","title":"List inspection form fields","description":"Lists the fields of the inspection form used for a beehive (title, type, options). Call this before create_card to learn which values can be recorded.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."}},"additionalProperties":false,"required":["beehive"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_card","title":"Create inspection card","description":"Records a new inspection card (Stockkarte) for a beehive the user owns or may edit. values maps field titles from list_card_fields to their values as strings. Unknown field names are rejected.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."},"visited_at":{"type":"string","description":"Date of the inspection (default: now)."},"values":{"type":"object","description":"Field title (from list_card_fields) to value. Booleans as 'true'/'false', numbers as plain strings.","additionalProperties":{"type":"string"}}},"additionalProperties":false,"required":["beehive","values"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"list_treatments","title":"List treatments","description":"Lists treatments (e.g. varroa), newest first, optionally filtered to one beehive. Each entry names kind, preparation, dates and treated beehives.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Maximum number of entries to return (default 25)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_feedings","title":"List feedings","description":"Lists feedings, newest first, optionally filtered to one beehive. Each entry names kind, feed, product, amount with its unit and fed beehives.","inputSchema":{"type":"object","properties":{"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Maximum number of entries to return (default 25)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_harvests","title":"List harvests","description":"Lists honey harvests, newest first, with kind, quantity in kilograms and the beehives involved.","inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Maximum number of entries to return (default 25)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"list_todos","title":"List tasks","description":"Lists the user's open tasks (todos) with due date and related beehive; completed tasks only when include_done is true.","inputSchema":{"type":"object","properties":{"include_done":{"type":"boolean","description":"Also return completed tasks (default false)."},"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Maximum number of tasks (default 50)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_todo","title":"Create task","description":"Creates a task (todo) attached to a beehive or an apiary the user may edit. Exactly one of beehive or apiary is required.","inputSchema":{"type":"object","properties":{"summary":{"type":"string","minLength":1,"maxLength":500,"description":"Short title of the task."},"beehive":{"type":"string","description":"The beehive, given as its ibeekeeperid (preferred) or its exact title."},"apiary":{"type":"string","description":"The apiary, given as its ibeekeeperid (preferred) or its exact title."},"due_date":{"type":"string","description":"Optional due date."},"description":{"type":"string","maxLength":5000,"description":"Optional longer description."},"priority":{"type":"integer","minimum":0,"maximum":9,"description":"0 = none, 1 = highest, 9 = lowest."}},"additionalProperties":false,"required":["summary"]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"search","title":"Search","description":"Full-text search across the user's beehives, apiaries and tasks. Returns a list of results with id, title and url; pass an id to fetch for the full record.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Search words."}},"additionalProperties":false,"required":["query"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"fetch","title":"Fetch","description":"Returns the full record for an id returned by search (beehive, apiary, inspection card or task) as text with metadata.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Result id from search, e.g. beehive:<ibeekeeperid>."}},"additionalProperties":false,"required":["id"]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_overview","title":"Apiary overview","description":"Compact overview of the user's beekeeping in one call: apiaries with coordinates, address, beehive count and current weather, all active beehives with their apiary and last inspection date, and open tasks. Use this when the user asks for an overview, a dashboard, a map of their apiaries or what is due. Hosts that support MCP Apps render it as an interactive view.","inputSchema":{"type":"object","properties":{"include_weather":{"type":"boolean","description":"Fetch current weather for apiaries with coordinates (default true)."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"ui":{"resourceUri":"ui://ibeekeeper/overview/073f3da29589.html"},"openai/outputTemplate":"ui://ibeekeeper/overview/073f3da29589.html","openai/widgetAccessible":true,"openai/toolInvocation/invoking":"Loading the apiary overview","openai/toolInvocation/invoked":"Apiary overview loaded"}}],"homepage":"https://www.ibeekeeper.de"}