# Viralmaxing developer documentation

> MCP and REST setup for people and agents. Each guide is available as Markdown by adding `.md` to its path.

## English

- [Developer documentation](/developers.md): Connect Viralmaxing to AI agents through MCP or to applications through the REST API.
- [MCP quick start](/developers/mcp/quick-start.md): Add the Viralmaxing MCP server, sign in through the browser, and give the agent its first safe request.
- [Verify the connection](/developers/mcp/verification.md): Check the tool list, current workspace, and data access without running a paid operation.
- [MCP troubleshooting](/developers/mcp/troubleshooting.md): Checks for missing tools, repeated sign-in, incorrect workspace data, and authorization errors.
- [Viralmaxing skills for agents](/developers/mcp/skills.md): Five ready-made skills and the connector in one command: npx skills add Viralmaxing/skill.
- [REST API quick start](/developers/rest/quick-start.md): Create an API key, store it in an environment variable, and make the first request.
- [REST API authentication](/developers/rest/authentication.md): How to send, store, rotate, and revoke an API key without exposing it.
- [Your first REST request](/developers/rest/first-request.md): Verify a key with cURL or server-side JavaScript and handle common API responses.

## Русский

- [Документация для разработчиков](/ru/developers.md): Подключение Viralmaxing к AI-агентам через MCP и к приложениям через REST API.
- [Быстрый старт с MCP](/ru/developers/mcp/quick-start.md): Добавьте MCP-сервер Viralmaxing, войдите через браузер и дайте агенту первый безопасный запрос.
- [Проверка подключения](/ru/developers/mcp/verification.md): Проверьте список инструментов, текущее пространство и доступ к данным без платных операций.
- [Проблемы с MCP](/ru/developers/mcp/troubleshooting.md): Что проверить, если клиент не видит инструменты, вход зациклился или данные пространства не совпадают.
- [Навыки Viralmaxing для агентов](/ru/developers/mcp/skills.md): Пять готовых навыков и коннектор одной командой: npx skills add Viralmaxing/skill.
- [Быстрый старт с REST API](/ru/developers/rest/quick-start.md): Создайте API-ключ, сохраните его в переменной окружения и выполните первый запрос.
- [Авторизация REST API](/ru/developers/rest/authentication.md): Как передавать ключ, хранить его и отзывать без утечки секретов.
- [Первый REST-запрос](/ru/developers/rest/first-request.md): Проверьте ключ через cURL или JavaScript и разберите типовые ответы API.

## Machine-readable resources

- [/auth.md](/auth.md): как агенту получить доступ (discover → register → claim → use → revoke)
- [/.well-known/mcp/server-card.json](/.well-known/mcp/server-card.json): карточка MCP-сервера
- [/.well-known/agent-card.json](/.well-known/agent-card.json): A2A agent card
- [/.well-known/api-catalog](/.well-known/api-catalog): каталог API (RFC 9727)
- [/llms-full.txt](/llms-full.txt): полный корпус документации