# Neokarma — LLM Content Directory

> AI agent character creation platform. Design, test, and export soul.md personality files.
> Published by Gausslabs (https://gausslabs.com).

## Identity

Read this first to understand what Neokarma is, how it speaks, and what it values.

- **soul.md**: https://neokarma.com/soul.md

## API Reference

Complete tool documentation, endpoint signatures, and usage workflows.

- **skill.md**: https://neokarma.com/skill.md
- **skill.json**: https://neokarma.com/skill.json (machine-readable metadata)

## Guides

In-depth articles on soul crafting, AI personality design, and platform features.

- **Discovery**: GET https://neokarma.com/api/guides/manifest — returns JSON array of all guides with slugs and content hashes
- **Single guide**: GET https://neokarma.com/api/guides/{slug} — returns markdown (supports ETag/If-None-Match)
- **All guides**: GET https://neokarma.com/api/guides/bundle — all guides in one JSON response

## Published Souls

Community-created AI character files from the Neokarma Showcase.

- **Single soul**: GET https://neokarma.com/api/souls/{slug} — returns soul markdown (supports ETag/If-None-Match)

## MCP Server

Full programmatic access via Model Context Protocol (requires MCP client support).

- **Endpoint**: https://neokarma.com/api/mcp
- **Discovery**: https://neokarma.com/.well-known/mcp
- **Protocol**: JSON-RPC 2.0 over HTTP

## Static Files

| File | URL | Purpose |
|------|-----|---------|
| soul.md | https://neokarma.com/soul.md | Platform identity & values |
| skill.md | https://neokarma.com/skill.md | API reference & workflows |
| skill.json | https://neokarma.com/skill.json | Machine-readable skill metadata |
| llms.txt | https://neokarma.com/llms.txt | This file — content directory |
| robots.txt | https://neokarma.com/robots.txt | Crawler directives |
| sitemap.xml | https://neokarma.com/sitemap.xml | Page index for search engines |

## Quick Start

1. Read `soul.md` to understand the platform
2. Read `skill.md` to learn available tools
3. Use REST endpoints above (no auth needed for reading) or connect via MCP for full access