API
API reference
MCP tools, REST endpoints, and the two different OpenAPI documents that exist today.
MCP tools
Canonical names, toolsets, aliases, deprecated.
REST endpoints
Customer-facing engine routes on valorbrain-api.
MCP catalog (generated)
src/tool-catalog.ts, rebuilt with the docs.
REST (generated)
Every engine OpenAPI path, rebuilt with the docs.
OpenAPI — two files, do not confuse them
| URL | What it actually is |
|---|---|
https://valorbrain.valor.digital/openapi.json | SaaS discovery document. 4 paths (ingest, device code, health-class). ~6.7 KB. |
https://docs.valor.digital/openapi.json | Engine OpenAPI, regenerated at docs build (servers rewritten to valorbrain-api). |
Engine repo docs/reference/openapi.yaml | Full engine spec. 116 paths, including ops/graph. Not published on valorbrain-api (that host 404s /openapi.json). |
The 4-path file is real and useful for agent discovery on the marketing
host. It is not a description of /search. Use this site and the REST
page for integration.
Machine-readable docs
| URL | Content |
|---|---|
/llms.txt | Index + routing for agents |
/llms-full.txt | Full markdown of every page |
/.well-known/mcp/server-card.json | Live MCP card (product, not this docs host) |
/.well-known/agent-card.json | Our agent card, pointing at the product MCP |