# Shiken for developers and agents

> The machine-usable surfaces of Shiken: an organisation REST API, a personal MCP server, an xAPI learning record store, and the machine-readable files that describe them.

Canonical page: https://shiken.ai/developers

## Surfaces

- **Organisation REST API** — `https://shiken.ai/api/v1`. Bearer an organisation API key (`sk_live_…`, or `sk_test_…` for test mode). Members, groups, content, analytics and AI roleplay sessions.
- **Personal MCP server** — `https://app.shiken.ai/api/mcp` (Streamable HTTP). Five read-only tools over one user's own meetings, notes and knowledge base.
- **xAPI Learning Record Store** — `https://shiken.ai/api/xapi/statements`, with an OAuth client-credentials token endpoint at `https://shiken.ai/api/xapi/oauth/token`.

## Machine-readable files

- [openapi.json](https://shiken.ai/openapi.json) — OpenAPI 3.1, every operation with its required scope
- [auth.md](https://shiken.ai/auth.md) — how an agent obtains and uses a credential
- [agents.md](https://shiken.ai/agents.md) — what Shiken is and when to reach for it
- [llms.txt](https://shiken.ai/llms.txt) · [llms-full.txt](https://shiken.ai/llms-full.txt) · [developers/llms.txt](https://shiken.ai/developers/llms.txt)
- [Agent skills index](https://shiken.ai/.well-known/agent-skills/index.json) — loadable SKILL.md documents
- [API catalog (RFC 9727)](https://shiken.ai/.well-known/api-catalog) · [protected-resource metadata (RFC 9728)](https://shiken.ai/.well-known/oauth-protected-resource)

## Getting a key

An organisation admin mints an API key in the app under Settings → API. There is no agentic self-registration and no anonymous tier.
Keys carry scopes: `users:read`, `users:write`, `content:read`, `groups:read`, `groups:write`, `analytics:read`, `admin`.

## Related

- [/mcp](https://shiken.ai/mcp)
- [Shiken integrations](https://shiken.ai/integrations)
- [Security and trust at Shiken](https://shiken.ai/security)

## Machine-readable index

- [llms.txt](https://shiken.ai/llms.txt) — site index for AI assistants
- [llms-full.txt](https://shiken.ai/llms-full.txt) — full product reference
- [pricing.md](https://shiken.ai/pricing.md) — every plan and price
- [openapi.json](https://shiken.ai/openapi.json) — the organisation API