WFDASH-WEBAPP/docs/api-mcp-layer.md
SJCoetz c4e1c62882 chore: standardize line endings and add full test + config scaffolding
Fix inconsistent line endings across all project files for cross-environment consistency.
Add complete unit test suite covering core utilities, API routes, and server services.
Add Playwright E2E test setup with smoke, auth, and agent API tests.
Update all project configuration files to match standardized formatting.
Fix MCP API error handling to properly propagate HTTP status codes and use correct JSON-RPC error codes.
Add VSCode workspace configuration, extensions, and example MCP config files.
Update .gitignore to exclude new test and build artifacts.
2026-06-11 20:30:02 +02:00

1.3 KiB

API + MCP Layer

Environment

Add to .env.local:

NEXT_PUBLIC_POCKETBASE_URL=http://127.0.0.1:8090
PB_ADMIN_EMAIL=your_admin_email
PB_ADMIN_PASSWORD=your_admin_password
AGENT_API_KEY=replace_with_secure_token
ORDER_ITEMS_COLLECTION=order_items

REST Endpoints

  • GET /api/v1/health
  • GET /api/v1/orders?page=1&perPage=50&status=new
  • POST /api/v1/orders/from-quote
  • GET /api/v1/collection-pool?page=1&perPage=50&status=queued
  • PATCH /api/v1/order-items/{id}/status

Auth for agent routes:

  • Header: Authorization: Bearer <AGENT_API_KEY>

POST /orders/from-quote body:

{ "quote_id": "QUOTE_RECORD_ID" }

PATCH /order-items/{id}/status body supports:

{
  "item_status": "processed",
  "drv_status": "assigned",
  "notes": "Assigned to route 2"
}

MCP Endpoint

  • POST /api/mcp

Supported methods:

  • tools/list
  • tools/call

Available tools:

  • orders.list
  • orders.create_from_quote
  • collection_pool.list
  • order_items.update_status

Notes

  • ORDER_ITEMS_COLLECTION controls where order-item writes/updates go.
  • Set ORDER_ITEMS_COLLECTION=order_items once new collection is created/imported.
  • Status endpoint accepts driver_status input and normalizes to drv_status.