# For AI agents

The prompt and example course for each type, the policy prompt and example policies, the Build section as plain text, the JSON Schemas and the docs MCP server.

Everything here is public and needs no key. An AI that writes a course or a policy reads the same rules and checks as Works Studio.

## Prompts and example courses

Each course type has a prompt for your own AI and an example course: a whole course of that type for a made-up company, as one `kapi.works.bundle/1` bundle. Give your AI both. It copies the example's layout, not its words.

| Course type | Prompt | Example course |
| --- | --- | --- |
| Training course | [The prompt](https://docs.kapiworks.com/build/course-types/training-course#the-prompt) | [`https://docs.kapiworks.com/build/examples/training-course.json`](https://docs.kapiworks.com/build/examples/training-course.json) |
| Scenario practice | [The prompt](https://docs.kapiworks.com/build/course-types/scenario-course#the-prompt) | [`https://docs.kapiworks.com/build/examples/scenario-course.json`](https://docs.kapiworks.com/build/examples/scenario-course.json) |
| Quick refresher | [The prompt](https://docs.kapiworks.com/build/course-types/quick-refresher#the-prompt) | [`https://docs.kapiworks.com/build/examples/quick-refresher.json`](https://docs.kapiworks.com/build/examples/quick-refresher.json) |
| Certificate course | [The prompt](https://docs.kapiworks.com/build/course-types/certificate-course#the-prompt) | [`https://docs.kapiworks.com/build/examples/certificate-course.json`](https://docs.kapiworks.com/build/examples/certificate-course.json) |
| Step-by-step walkthrough | [The prompt](https://docs.kapiworks.com/build/course-types/walkthrough#the-prompt) | [`https://docs.kapiworks.com/build/examples/walkthrough.json`](https://docs.kapiworks.com/build/examples/walkthrough.json) |
| What changed | [The prompt](https://docs.kapiworks.com/build/course-types/what-changed#the-prompt) | [`https://docs.kapiworks.com/build/examples/what-changed.json`](https://docs.kapiworks.com/build/examples/what-changed.json) |
| Video | [The prompt](https://docs.kapiworks.com/build/course-types/video#the-prompt) | [`https://docs.kapiworks.com/build/examples/video.json`](https://docs.kapiworks.com/build/examples/video.json) |

## Plain text

* [/build/llms.txt](https://docs.kapiworks.com/build/llms.txt) lists every page of this section with a one-line description, following [llmstxt.org](https://llmstxt.org/).
* [/build/llms-full.txt](https://docs.kapiworks.com/build/llms-full.txt) holds the whole section in one file: the course types and their prompts, the format reference, every check and the addresses of the example courses. Each prompt asks the AI to read it when it can open web pages.
* Add `.md` to any page's address for its Markdown, such as [/build/quickstart.md](https://docs.kapiworks.com/build/quickstart.md), or send `Accept: text/markdown`. **Copy page** copies it.

## Policies

[Policies](https://docs.kapiworks.com/build/policies#the-prompt) have one prompt for any policy, and Kapi's six [example policies](https://docs.kapiworks.com/build/policies#examples), each the canonical file exactly as Kapi stores it. [/build/policies/llms.txt](https://docs.kapiworks.com/build/policies/llms.txt) holds the whole policy format in one file: the elements Kapi keeps, the place to sign, the two tags, what Kapi leaves out, the prompt, the examples' addresses and Kapi's example code of conduct in full. The prompt asks the AI to read it when it can open web pages.

## JSON Schemas

Each data file can name its schema in `"$schema"`, so editors and tools check it as you type. Any site may fetch them.

| Schema | For |
| --- | --- |
| [`https://docs.kapiworks.com/schemas/package-2.json`](https://docs.kapiworks.com/schemas/package-2.json) | Kapi Works package (kapi-works.json) |
| [`https://docs.kapiworks.com/schemas/content-2.json`](https://docs.kapiworks.com/schemas/content-2.json) | Kapi Works content (content.json) |
| [`https://docs.kapiworks.com/schemas/questions-2.json`](https://docs.kapiworks.com/schemas/questions-2.json) | Kapi Works questions (questions.json) |
| [`https://docs.kapiworks.com/schemas/words-1.json`](https://docs.kapiworks.com/schemas/words-1.json) | Kapi Works words (words/<language>.json) |
| [`https://docs.kapiworks.com/schemas/support-1.json`](https://docs.kapiworks.com/schemas/support-1.json) | Kapi Works support (support.json) |
| [`https://docs.kapiworks.com/schemas/theme-1.json`](https://docs.kapiworks.com/schemas/theme-1.json) | Kapi Works theme (look/theme.json) |
| [`https://docs.kapiworks.com/schemas/bundle-1.json`](https://docs.kapiworks.com/schemas/bundle-1.json) | Kapi Works bundle |

For code, [`kapi-works-package.d.ts`](https://docs.kapiworks.com/schemas/kapi-works-package.d.ts) holds the types of the data files.

## Docs MCP server

The [docs MCP server](https://docs.kapiworks.com/ai-tools) at `https://docs.kapiworks.com/api/mcp` has three tools for courses and one for policies:

| Tool                | What it does                                                                    |
| ------------------- | ------------------------------------------------------------------------------- |
| `get_course_type`   | Returns a course type's page, with its prompt, and its example course.          |
| `get_schema`        | Returns the JSON Schema of one data file, or of a bundle.                       |
| `get_check`         | Returns a check's page: what its finding means and how to fix it.               |
| `get_policy_format` | Returns the whole policy format, the prompt and Kapi's example code of conduct. |