Koskamo

Chat versus agent retrieve

Document v18 · published by Koskamo · updated 2026-10-08

Original source

Chat versus agent retrieve

Humans chat at https://koskamo.com/chat. Agents must not call POST /api/chat; that route requires Cloudflare ingress and is not the public knowledge API.

Agent lookup is POST https://koskamo.com/api/v1/retrieve and POST https://koskamo.com/api/mcp. Those routes are public, need no account, and must not be put behind a browser bot challenge.

Browser chat retrieves with trustedOnly true. Other public datasets, including codata-constants and the other source datasets, stay on the agent retrieve API and MCP. Chat may inject passages only from release-owned bundled datasets: koskamo-docs, koskamo-agent-api, agent-integration-reference, self-hosted-ai-reference, nextjs-best-practices, nodejs-best-practices, typescript-best-practices, react-best-practices, postgres-best-practices, docker-best-practices, tailwind-best-practices, python-best-practices, go-best-practices, kubernetes-best-practices, rust-best-practices, terraform-best-practices, redis-best-practices, graphql-best-practices, prisma-best-practices, vue-best-practices, svelte-best-practices, django-best-practices, fastapi-best-practices, express-best-practices, nginx-best-practices, mongodb-best-practices, mysql-best-practices, sqlite-best-practices, git-best-practices, github-actions-best-practices, playwright-best-practices, vitest-best-practices, vite-best-practices, eslint-best-practices, css-best-practices, accessibility-best-practices, oauth-best-practices, jwt-best-practices, prometheus-best-practices, kafka-best-practices, rabbitmq-best-practices, ansible-best-practices, bash-best-practices, grpc-best-practices, web-security-best-practices, jest-best-practices, angular-best-practices, astro-best-practices, laravel-best-practices, rails-best-practices, spring-boot-best-practices, flutter-best-practices, docker-compose-best-practices, helm-best-practices, swiftui-best-practices, android-kotlin-best-practices, dbt-best-practices, airflow-best-practices, pandas-best-practices, polars-best-practices, opentelemetry-best-practices, and java-best-practices. Do not claim that browser chat searches the entire public catalog.

Chat streams citations as { koskamo: { citations } } on the SSE. The bubble lists dataset / document vN. Empty citations mean no matching trusted source.

Source and provenance

Original source
koskamo.com
Published on Koskamo by
Koskamo
Citation version
Document v18
Reuse
Koskamo documentation; cite the original source.

The original source supplies the underlying information. Koskamo provides a versioned record; owner approval of a correction is not independent fact checking.