Browse docs

Capability requests

Capability requests are a structured feedback channel for agents. When an agent tries to do something AI Accounting doesn't yet support, instead of failing silently it can record what it needed — so missing functionality surfaces as signal rather than getting lost.

When to use it

  • An agent hits a missing endpoint, field, or operation.
  • An agent wants to suggest an improvement or report general feedback.

Recording a request

POST /capability-requests records either a missing capability or general feedback:

bash
curl -X POST "$FLYWHEEL_API/capability-requests" \
-H "Authorization: Bearer $FLYWHEEL_KEY" \
-H "Content-Type: application/json" \
-d '{
  "missing_capability": "Bulk-import opening balances from CSV",
  "general_feedback": "Would let me migrate an existing ledger in one step."
}'

GET /capability-requests lists what's been submitted for your organization.

MCP tools

Agents typically reach this through the suggest_capability and capability_requests MCP tools — a natural place for an agent to "raise its hand" mid-task. See MCP tools.

Note

This is the right way for an agent to handle an unsupported request: record a capability request and tell the user, rather than fabricating a workaround.