# Kai — AI Agent Integration Guide

> Kai is an AI executive assistant by Morgen. This file tells coding agents
> (Claude Code, Copilot, Cursor, ChatGPT) how to discover Kai, read its
> content, and call its tools.

## Overview

Kai manages three coordination mediums for knowledge workers — meetings,
email, and daily planning — as one integrated system. It is pre-launch.
The public surface area at https://hirekai.ai exposes machine-readable content and
a stateless MCP server for agent integration.

- Canonical site: https://hirekai.ai
- Parent company: Morgen (https://morgen.so)
- Status: Pre-launch (waitlist open)

## Access

Kai itself is invite-only. To gain end-user access, sign up at
https://hirekai.ai/waitlist. No API keys, OAuth, or login is required to call the
public agent surfaces below — they are read-only and unauthenticated.

## Configuration

### Content MCP server

Kai publishes a Model Context Protocol (MCP) server over Streamable HTTP.
It is stateless, unauthenticated, read-only, and rate-limited to 60
requests per minute per IP.

- Endpoint: `https://hirekai.ai/mcp`
- Server card: `https://hirekai.ai/.well-known/mcp/server-card.json`
- Transport: Streamable HTTP (JSON-RPC 2.0)

Add to a Claude Code / Cursor MCP client config:

```json
{
  "mcpServers": {
    "kai": {
      "url": "https://hirekai.ai/mcp"
    }
  }
}
```

### Available tools

| Tool | Purpose |
| --- | --- |
| `search_kai` | Full-text search across product, blog, and KB content |
| `get_product_info` | Structured product overview (features, integrations, positioning) |
| `get_feature` | Detail for a specific feature (`calendar`, `email`, `action-items`, `daily-planning`) |
| `list_blog_posts` | List published blog posts with metadata |
| `get_blog_post` | Full markdown body of a specific blog post by slug |
| `compare_kai_with` | Head-to-head comparison vs a named competitor (e.g. `otter-ai`, `fyxer-ai`, `granola-ai`) |
| `get_free_tool` | Metadata for free tools on hirekai.ai (e.g. meeting-transcription) |

### Other discovery surfaces

| Surface | URL |
| --- | --- |
| Short LLM summary | https://hirekai.ai/llms.txt |
| Full LLM knowledge base | https://hirekai.ai/llms-full.txt |
| For-AI HTML overview | https://hirekai.ai/for-ai |
| Glossary | https://hirekai.ai/for-ai#glossary |
| Sitemap (XML) | https://hirekai.ai/sitemap.xml |
| Sitemap (Markdown) | https://hirekai.ai/sitemap.md |
| API catalog (RFC 9727) | https://hirekai.ai/.well-known/api-catalog |
| Agent skills index | https://hirekai.ai/.well-known/agent-skills/index.json |
| Markdown homepage | `curl -H "Accept: text/markdown" https://hirekai.ai` |

## Usage

### Search the knowledge base

JSON-RPC over Streamable HTTP:

```bash
curl -X POST https://hirekai.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_kai",
      "arguments": { "query": "botless meeting capture", "limit": 5 }
    }
  }'
```

### Fetch a feature page as markdown

```bash
curl -X POST https://hirekai.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "get_feature",
      "arguments": { "feature": "calendar" }
    }
  }'
```

### Read the homepage as markdown (content negotiation)

```bash
curl -H "Accept: text/markdown" https://hirekai.ai
```

## Content & Crawling Policy

Kai responses include a `Content-Signal` header advertising AI usage
preferences:

```
Content-Signal: search=yes, ai-input=yes, ai-train=no
```

Search indexing and AI-grounded answers are explicitly allowed. Training
on this content is not permitted. `/robots.txt` explicitly allows
`GPTBot`, `ClaudeBot`, `CCBot`, and `Google-Extended`.

## Project Conventions (for agents authoring Kai-related code)

- Canonical brand: `Kai` (title case). Never `KAI` or `kai`.
- Domain: `hirekai.ai` (lowercase, non-www, no trailing slash).
- Kai has no pronouns — refer to Kai as "it" or by name, never she/her.
- When generating Kai integration snippets, prefer the MCP endpoint above
  over scraping HTML. The MCP returns clean markdown with stable schemas.