Decibel Tools API

Returns all registered facades and their actions. Responds with JSON or HTML based on the Accept header.

Example

curl https://senken.pro/tools \
  -H "Accept: application/json"

Response

{
  "status": "executed",
  "version": "{{VERSION}}",
  "api_version": "v1",
  "tools": [
    {
      "name": "sentinel",
      "description": "Work tracking: epics, issues, incidents",
      "actions": ["create_issue", "list_issues", "log_epic", ...]
    },
    {
      "name": "swarm",
      "description": "Multi-agent sessions and signals",
      "actions": ["start_session", "join_session", "emit_signal", ...]
    }
  ]
}

Auth

Public

Generic dispatch endpoint. Pass the tool name and arguments. The kernel routes to the correct facade and action.

Request

curl -X POST https://senken.pro/call \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TOKEN" \
  -d '{
    "tool": "sentinel",
    "arguments": {
      "action": "list_issues",
      "project_id": "decibel-tools-mcp"
    }
  }'

Request Body

Field	Type	Required	Description
tool	string	Yes	Facade or tool name
arguments	object	Yes	Tool-specific parameters

Response

{
  "status": "executed",
  "result": { ... }
}

Context Headers

Include optional headers to identify the calling agent and trace requests. See Context Headers.

Auth	Token if set

Send up to 20 calls in a single request. All calls execute concurrently via Promise.allSettled. Ideal for agent bootstrap (fetching context + issues + roadmap in one round-trip).

Request

curl -X POST https://senken.pro/batch \
  -H "Content-Type: application/json" \
  -H "X-Agent-Id: analyst-01" \
  -d '{
    "calls": [
      { "facade": "sentinel", "action": "list_issues", "params": { "project_id": "my-project" } },
      { "facade": "oracle", "action": "next_actions", "params": { "project_id": "my-project" } },
      { "facade": "context", "action": "refresh", "params": { "task": "status check" } }
    ],
    "context": {
      "agentId": "analyst-01",
      "runId": "run-abc"
    }
  }'

Request Body

Field	Type	Required	Description
calls	array	Yes	Array of call objects (max 20)
calls[].facade	string	Yes	Facade name
calls[].action	string	Yes	Action name
calls[].params	object	No	Action parameters
context	object	No	Shared context for all calls

Response

{
  "status": "executed",
  "results": [
    { "status": "executed", ... },
    { "status": "executed", ... },
    { "status": "error", "error": "...", "code": "..." }
  ]
}

Max calls	20 per batch
Auth	Token if set

Returns all facades with their descriptions, actions, and tier. Use the tier query param to control verbosity.

Example

curl "https://senken.pro/facades?tier=compact"

Query Parameters

Param	Values	Description
tier	full, compact, micro	Description verbosity level (default: full)

Response

{
  "status": "executed",
  "facades": [
    {
      "name": "sentinel",
      "description": "Work tracking: epics, issues, incidents...",
      "actions": ["create_issue", "list_issues", "log_epic", ...],
      "tier": "core"
    }
  ],
  "facade_count": 30,
  "internal_tool_count": 170
}

Auth

Public

Registers an agent with the daemon. Returns the agent's capabilities, allowed facades, tier, and rate limit. Only available in daemon mode.

Request

curl -X POST https://senken.pro/connect \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "analyst-01",
    "capabilities": ["sentinel", "oracle", "context"]
  }'

Request Body

Field	Type	Required	Description
agent_id	string	Yes	Unique agent identifier
capabilities	string[]	No	Facade names the agent needs

Response

{
  "status": "executed",
  "agent_id": "analyst-01",
  "connected_at": "2026-03-30T19:35:00.000Z",
  "capabilities": ["sentinel", "oracle", "context"],
  "allowed_facades": ["sentinel", "oracle", "context"],
  "tier": "pro",
  "rate_limit_rpm": 100
}

Requires	Daemon mode (--daemon)
Error	503 NOT_DAEMON if not in daemon mode

Request

curl -X POST https://senken.pro/disconnect \
  -H "Content-Type: application/json" \
  -d '{ "agent_id": "analyst-01" }'

Response

{
  "status": "executed",
  "agent_id": "analyst-01",
  "disconnected": true
}

Example

curl https://senken.pro/agents

Response

{
  "status": "executed",
  "agents": [
    {
      "id": "analyst-01",
      "connected_at": "2026-03-30T19:35:00.000Z",
      "capabilities": ["sentinel", "oracle"],
      "last_seen": "2026-03-30T19:40:00.000Z"
    }
  ],
  "count": 1
}

Auth

Public

Opens an SSE stream that emits every tool dispatch as it happens. Useful for dashboards, audit logs, and debugging agent behavior.

Example

curl -N "https://senken.pro/events/stream?agent_id=analyst-01"

Query Parameters

Param	Type	Description
agent_id	string	Filter by agent (optional)
facade	string	Filter by facade (optional)

Event Format

data: {
  "timestamp": "2026-03-30T19:35:12.345Z",
  "agentId": "analyst-01",
  "facade": "sentinel",
  "action": "list_issues",
  "duration_ms": 42,
  "status": "ok"
}

Auth

Public

Query Parameters

Param	Type	Description
since	ISO 8601	Events after this timestamp
agent_id	string	Filter by agent
limit	number	Max events (default: 100)

Response

{
  "status": "executed",
  "events": [ ... ],
  "total": 42
}

Response

{
  "status": "ok",
  "version": "{{VERSION}}",
  "api_version": "v1",
  "uptime_ms": 3600000,
  "uptime_human": "1h 0m 0s",
  "pid": 12345,
  "facade_count": 30,
  "internal_tool_count": 170,
  "connected_clients": 2,
  "active_requests": 0,
  "connected_agents": 3,
  "pro": true,
  "license_tier": "pro",
  "supabase_configured": true
}

Auth

Public

Returns 200 when the server is ready to accept requests, 503 otherwise.

{ "ready": true, "facade_count": 30 }