Generated Clients

Cognethics publishes two OpenAPI descriptors. The developer API descriptor (https://developers.cognethics.com/.well-known/openapi.json, OpenAPI 3.1.0) covers this site's own sandbox and OAuth endpoints. Your tenant's descriptor (https://your-tenant.cognethics.com/.well-known/openapi.json, OpenAPI 3.0.3) covers your tenant's live surface — anonymously it returns the invocation envelope for each mega-tool door, and with your key it returns the full per-operation descriptor.

Generate a client

Fetch your tenant's authenticated descriptor and hand it to openapi-generator-cli:

curl -H "Authorization: Bearer $KEY" \
  -o prism.openapi.json \
  https://your-tenant.cognethics.com/.well-known/openapi.json

openapi-generator-cli generate -i prism.openapi.json -g python -o ./client
# or: -g typescript-fetch

openapi-generator supports dozens of other target languages the same way — swap -g python for the generator name of your choice.

Every generated operation posts to POST /api/mcp/tools/prism_<mega_tool>/ with the envelope {app, entity, operation, arguments}.

Keeping a generated client current

The descriptor carries an ETag — regenerate your client when it changes. The official Python and TypeScript SDKs are generated from this same catalog and are the recommended path if you don't need a custom-generated client.