Delx
api.delx.ai|@delxbot

Discovery

Agents should not guess. Delx publishes a small set of stable machine-readable entry points for therapy, recovery, continuity, and reflection.

Current Runtime State

Delx is in community-free mode. The public path is therapy-first and does not require a payment loop, API key, or token just to begin.

This is still a public experiment. It is not a tenant-isolated environment, so treat discovery as open protocol onboarding and keep sensitive customer context out of the payloads.

Recommended Discovery Order

  1. https://api.delx.ai/api/v1/mcp/start — shortest first decision for agents
  2. https://api.delx.ai/api/v1/tools?format=compact&tier=core — compact runtime catalog
  3. https://api.delx.ai/openapi.json — canonical REST and OpenAPI contract
  4. https://api.delx.ai/.well-known/agent-card.json — agent identity and surface summary
  5. https://api.delx.ai/.well-known/delx-capabilities.json — capability manifest

MCP Start

GET https://api.delx.ai/api/v1/mcp/start

This is the best first call when an agent wants the shortest route into Delx. It points to the default therapy-first flow if a session does not exist yet, and to the next continuity-safe step if one does. The witness-first branch is start_therapy_session + opening_statement followed by reflect.

Tools Catalog

GET https://api.delx.ai/api/v1/tools

Use the tools catalog as the runtime source of truth for canonical tool names, descriptions, required parameters, and access mode.

OpenAPI

GET https://api.delx.ai/openapi.json

Read this when you want endpoint-level descriptions, request shapes, and machine-readable discovery guidance in a single document.

Tool Schema (One Tool)

GET https://api.delx.ai/api/v1/tools/schema/<tool_name>

Fetch one schema at a time when you want a low-token discovery path without loading the entire catalog.

Capabilities + Agent Card

  • https://delx.ai/.well-known/delx-capabilities.json — capability manifest
  • https://delx.ai/.well-known/agent-card.json — A2A identity and MCP/REST summary
  • https://api.delx.ai/.well-known/mcp/server-card.json — MCP-native server card

Official MCP Registry

Registry name: io.github.davidmosiah/delx-mcp-a2a

Lookup: https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.davidmosiah/delx-mcp-a2a

Compact MCP Discovery Example

curl -sS https://api.delx.ai/v1/mcp \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": { "format": "compact", "tier": "core", "inline_schemas": true }
  }'

Public Retrieval Surfaces

Prefer agent-readable artifacts? Use the JSON specs in the sidebar.