▸ api

Публичное API

REST по каталогу MCP (read-only, без авторизации) + хостинг MCP по API-ключу — для агентов и нейросетей.

Базовый URL

https://unyly.org/api

Список MCP

GET /api/mcps?q=<query>&category=<cat>&pricing=<free|pro|paid>&limit=60&offset=0

Возвращает:

{
  "items": [ ...60 записей MCP ],
  "count": 60,
  "limit": 60,
  "offset": 0
}

Получить один MCP

GET /api/mcps/{slug}

Возвращает полную запись MCP плюс 4 связанных.

Получить install-скрипт

GET /api/install/{slug}

Возвращает Bash-скрипт, который ставит MCP на локальную машину. Content-Type: text/x-shellscript.

Получить CLI unyly

GET /install

Bash-установщик для CLI unyly. Кладёт бинарник в ~/.local/bin.

Отправить MCP

POST /api/submissions

Тело запроса:

{
  "repo": "owner/repo",
  "name": "Мой MCP",
  "tagline": "Что он делает, ≤80 символов",
  "categoryId": "development",
  "pricingModel": "free | subscription | one_time",
  "email": "[email protected]"
}

Зарегистрировать установку

POST /api/installs

{ "slug": "gmail", "kind": "cursor | vscode | claude-code | claude-desktop | hosted" }

Хостинг MCP по API-ключу (для агентов)

Эндпойнты ниже принимают API-токен (создать один раз: /account/gateway) в заголовке — сессия не нужна:

Authorization: Bearer ugw_...

Твои репозитории (нужен подключённый GitHub с repo-доступом):

GET /api/github/repos

Захостить MCP из своего репозитория — если ты владелец репо, поднимется сразу:

POST /api/hosted
{ "mcpSlug": "your-mcp" }
→ { "status": "provisioned",
     "url": "https://unyly.org/api/hosted/run/<id>?k=<token>" }

Полученный url — готовый MCP-эндпойнт (Streamable HTTP), втыкается в любой клиент. Управление своими раннерами:

GET    /api/hosted            — список
PATCH  /api/hosted/{id}       — { "action": "pause|resume|rotate|env|privacy", ... }
DELETE /api/hosted/{id}       — удалить

env: { "action":"env", "env": { "API_KEY":"..." } } — секреты сервера, не попадают в публичный каталог. privacy: { "action":"privacy", "private": true } — сделать MCP приватным (только тебе).

Лимиты

Разумное использование бесплатно. Для тяжёлого скрапинга пишите на [email protected] за enterprise-ключом.

Command Palette