Developer Docs

willaOS Developer Docs

Developer entry point for the willaOS REST API and MCP server.

willaOS exposes two production integration surfaces:

  • REST API at /api/* for integrations, automations, apps, and scripts.
  • MCP server at /api/mcp for external agents that need tool-style access to the same operational data.

The app itself continues to call shared lib/* domain helpers directly. REST and MCP are first-class external consumers, not internal shortcuts.

Base URLs

EnvironmentBase URL
Productionhttps://os.willacreative.dev
Local developmenthttp://localhost:3000

These docs are available in-app at /developers. The docs.willacreative.dev subdomain can serve the same pages once DNS points at the app.

What To Read First

  1. Quickstart for curl and local setup.
  2. REST Auth for bearer API keys, RBAC, and optimistic concurrency.
  3. REST Reference for canonical resources and request/response envelopes.
  4. MCP Server for external agent setup.
  5. Agent Patterns for common workflows.

Live Health

Use the in-app status surface for live service health and endpoint discovery:

  • https://os.willacreative.dev/api-status
  • JSON health: GET /api/status

Health and docs are linked together so operators can move from uptime to integration guidance without hunting through the app.