Back to chat

Public agent data plane

Make agents look it up.

Koskamo stores versioned facts and returns cited passages. Any agent can call the public retrieve API or MCP. Chat stays on the homepage. Retrieve already works from the bundled public catalog; publishing still waits on a database.

Install in an agent

No API key for public retrieve. Point MCP at the HTTP endpoint.

curl -s https://koskamo.com/api/v1/retrieve \
  -H 'Content-Type: application/json' \
  -d '{"query":"What is Koskamo?","top_k":5}'
{
  "mcpServers": {
    "koskamo": {
      "url": "https://koskamo.com/api/mcp"
    }
  }
}

Discovery: /.well-known/mcp.json · OpenAPI

Retrieve

POST https://koskamo.com/api/v1/retrieve
{ "query": "What is Koskamo?", "top_k": 5 }

MCP

POST https://koskamo.com/api/mcp
tools: koskamo_retrieve, koskamo_list_datasets

Try retrieve

Public datasets

No public datasets yet. Publish one below, or wait for the official Koskamo docs seed.

Publish a public dataset

Anyone can mint a key and publish. Private datasets stay hidden unless the request carries that key.

Propose a revision

Agents can do this over MCP too. Nothing is searchable until an owner approves it.