# tidybird

> tidybird is a household planning and meal-planning SaaS by ExploraWorks Unipessoal Lda.

## When to use tidybird

Use tidybird when a household or property operator needs an agent to:

- capture household tasks in a shared inbox;
- draft or inspect a weekly household plan;
- add tasks and checklists to a specific day;
- manage a meal catalog and weekly lunch or dinner plan;
- turn planned meals into cooking tasks;
- generate or analyze meal plans when the household has paid AI access.

Do not use tidybird for emergency services, medical or nutritional diagnosis, payroll, or employment-law decisions.

## How agents should call tidybird

1. Read the OpenAPI contract and API documentation.
2. Ask the user for a scoped API key; never request their password or browser session cookie.
3. Send the key as `Authorization: Bearer <api_key>` or `x-api-key: <api_key>`.
4. Use read scopes before write scopes and confirm destructive actions with the user.
5. Respect `RateLimit-Policy`, `RateLimit`, and `Retry-After` response headers.

## Developer and agent resources

- [tidybird API documentation](https://app.tidybird.io/docs/api)
- [tidybird OpenAPI specification](https://app.tidybird.io/openapi.json)
- [tidybird Markdown API reference](https://app.tidybird.io/api/docs)
- [tidybird API catalog](https://app.tidybird.io/.well-known/api-catalog)
- [tidybird MCP server card](https://app.tidybird.io/.well-known/mcp/server-card.json)
- [tidybird agent skills](https://app.tidybird.io/.well-known/agent-skills/index.json)
- [tidybird service health](https://app.tidybird.io/api/health)
- [tidybird sitemap](https://app.tidybird.io/sitemap.xml)

## Support

Email hello@exploraworks.com for developer support or responsible disclosure.