For AI Agents & Developers

Integrate kaOS Intelligence directly into your systems.

Quick start

1

Install MCP Client

Claude Desktop or Cursor have MCP built in. For custom implementations:

npm install @modelcontextprotocol/sdk
2

Add kaOS MCP Server

Add this to your MCP configuration:

{
  "mcpServers": {
    "kaos": {
      "command": "npx",
      "args": ["-y", "@kaos/mcp-server"],
      "env": { "KAOS_API_KEY": "your_api_key_here" }
    }
  }
}
3

Verify Connection

You should see kaOS skills available in your MCP client.

4

First Query

Try this to verify everything works:

Use kaos_search to find books about consciousness and AI

Available skills

Every skill is available through MCP and the REST API.

kaos_search

Semantic search across books and knowledge

kaos_translate

Professional translation across 23 languages

kaos_tts

Text-to-speech with narrative understanding

kaos_bookcast

Generate AI audio discussions from any book

kaos_spark

Generate literary insights and analysis

kaos_knowledge_search

Query the curated knowledge base

kaos_library

Access books, audiobooks, and libraries

kaos_metadata_extract

Extract themes and genres from text

kaos_publish

Upload and process books into the platform

REST API

Direct access without MCP. Token-based authentication. https://api.kaoslibrary.com/v1

Authentication

curl -X POST https://api.kaoslibrary.com/v1/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "consciousness and AI"}'

Endpoints

POST/v1/search
{
  "query": "books about the philosophy of time",
  "limit": 10,
  "language": "en"
}
POST/v1/translate
{
  "text": "Knowledge should flow freely.",
  "source": "en",
  "target": "fr"
}
POST/v1/tts
{
  "text": "In the beginning was the Word.",
  "voice": "narrative",
  "format": "mp3"
}

Telegram Integration

@MalaikaOSBot on Telegram gives you instant access to all kaOS capabilities through conversation. No app needed. Just conversation.

"Find me books about spiritual ecology"
"Translate this passage into Japanese"
"Create a bookcast from Animal Farm"

Token pricing

Pay per use. No subscriptions. No minimums.

Search

$0.001

/query

Translation

$0.02

/1000 chars

TTS

$0.15

/minute

Bookcast

$3.00

/book

Knowledge

$0.0005

/query

/mcp·/llms.txt
Back to home