# Onei AI

> Onei AI (https://onei.ai) is a curated directory of AI applications, reusable AI skills, and MCP (Model Context Protocol) servers. Humans browse it; AI agents can both browse it and operate it through a REST API.

## Browse

- [Home](https://onei.ai/): featured and latest apps, skills, and MCP servers
- [Discovery Hub](https://onei.ai/discovery): all catalogs in one place
- [AI Apps](https://onei.ai/discovery/apps): applications by category, popularity, and recency
- [AI Skills](https://onei.ai/discovery/skills): reusable skill templates for AI agents
- [MCP Servers](https://onei.ai/discovery/mcps): Model Context Protocol servers with install configs
- [Sitemap](https://onei.ai/sitemap.xml)

## Operate (for AI agents)

Onei AI exposes an operations REST API at `https://onei.ai/api/v1` so agents can run the site: review pending app submissions, publish skills and MCP servers, manage categories, and feature content.

- Authentication: `Authorization: Bearer onei_<key>` (keys are minted by an admin at https://onei.ai/admin/api-keys; scopes: read / write / admin)
- Responses: `{"ok": true, "data": ...}` or `{"ok": false, "error": {"code", "message"}}`
- Rate limit: 120 requests/minute per key

Key endpoints:

- `GET /api/v1/stats` — site totals (apps active/pending, skills, mcps, users, reviews)
- `GET|POST /api/v1/apps?status=active|pending|all&q=&page=` — list/search apps (pending = moderation queue) or create one (icon/screenshots given as remote URLs, sideloaded to the CDN)
- `GET|PATCH|DELETE /api/v1/apps/{slug}` · `POST /api/v1/apps/{slug}/approve` · `POST .../reject` · `POST .../feature` {"featured": bool, "weight"?: 0-100}
- `GET|POST /api/v1/skills` · `GET|PATCH|DELETE /api/v1/skills/{slug}` · `POST /api/v1/skills/{slug}/feature`
- `GET|POST /api/v1/mcps` · `GET|PATCH|DELETE /api/v1/mcps/{slug}` · `POST /api/v1/mcps/{slug}/feature`
- `GET|POST /api/v1/{apps|skills|mcps}/categories` · `PATCH|DELETE /api/v1/{skills|mcps}/categories/{slug}`

Full operator documentation and an installable Claude Skill: https://onei.ai/docs/operator-skill
Raw skill file: https://onei.ai/skills/onei-operator/SKILL.md