Tuqo MCP server

Static site hosting in Russia, controlled by AI agents. This repository is the public home of the Tuqo MCP server: server.json for the official MCP Registry, a Claude Code plugin with the tuqo skill, and ready-to-paste client configs. The server itself is remote — nothing to install.

• Endpoint: https://mcp.tuqo.ru/mcp (Streamable HTTP, JSON-RPC 2.0)
• Auth: OAuth 2.1 with Dynamic Client Registration (the browser opens on first call), or an API key Authorization: Bearer tqk_… from the Tuqo panel
• Server card with all tools: https://mcp.tuqo.ru/.well-known/mcp.json
• Agent instructions: https://mcp.tuqo.ru/ · https://tuqo.ru/ai.md · one-liner: https://tuqo.ru/prompt.md
• Skill for Claude Code / Cursor / Codex: https://tuqo.ru/SKILL.md
• REST API (OpenAPI 3.1): https://tuqo.ru/openapi.json
• Website: https://tuqo.ru · for AI assistants: https://tuqo.ru/ai/

What the agent can do

50 tools: create and update sites, deploy files as they are (no archive, no build minutes) or a tar.gz/zip that Tuqo builds on Node 20, follow build status and logs, roll back to any kept version, preview a build before publishing, attach custom domains with automatic SSL and A-record diagnostics, read form submissions, set up auto-reply with a lead-magnet file, gate a site (password, email code, Telegram/MAX subscribers, self-registration with moderation, paid access on the owner's own payment provider), read server-side analytics. Every response carries next_action — a hint for the next step. No signup? An agent can publish a 24-hour draft anonymously via POST https://api.tuqo.ru/instant/deploy.

Quick start

# Claude Code
claude mcp add --transport http tuqo https://mcp.tuqo.ru/mcp

# Codex CLI
codex mcp add tuqo --url https://mcp.tuqo.ru/mcp && codex mcp login tuqo

Cursor (.cursor/mcp.json):

{ "mcpServers": { "tuqo": { "url": "https://mcp.tuqo.ru/mcp" } } }

More clients (VS Code, Windsurf, Zed, Gemini CLI, Cline, Continue, Qwen Code, GigaChat, Kimi, OpenCode, claude.ai, ChatGPT): clients/ and https://tuqo.ru/connect/.

Then call whoami, and ask the agent to publish a site.

Claude Code plugin

/plugin marketplace add antiblef/tuqo-mcp
/plugin install tuqo@tuqo

Installs the remote server and the tuqo skill (publishing rules, error handling).

Files

• server.json — manifest for the official MCP Registry (ru.tuqo/mcp)
• .claude-plugin/marketplace.json, plugins/tuqo/ — Claude Code marketplace and plugin
• clients/ — config snippets per client
• SUBMISSIONS.md — texts for catalogs (maintainers only)

Examples

examples/ holds six single-file demo sites (QR menu, wedding RSVP, tutor landing, résumé, library docs, meetup registration) that an agent can publish as-is with deploy_files. Three of them include a working Tuqo form — replace the __FORM_ENDPOINT__ and __HONEYPOT__ placeholders with the values from get_forms_overview. Live copies and the prompts behind them: https://tuqo.ru/primery/ (Russian).

License

Configs and docs in this repository — MIT. The Tuqo service is governed by its own terms.

---

Tuqo MCP-сервер (по-русски)

Российский хостинг статических сайтов, которым управляют ИИ-агенты. Здесь лежат server.json для официального реестра MCP, плагин Claude Code со skill tuqo и готовые конфиги клиентов. Сам сервер удалённый — ставить ничего не нужно.

• Endpoint: https://mcp.tuqo.ru/mcp (Streamable HTTP, JSON-RPC 2.0)
• Авторизация: OAuth 2.1 с динамической регистрацией (браузер откроется сам) или ключ Authorization: Bearer tqk_… из панели app.tuqo.ru
• Карточка сервера со всеми инструментами: https://mcp.tuqo.ru/.well-known/mcp.json
• Инструкции агенту: https://mcp.tuqo.ru/ · https://tuqo.ru/ai.md · одной строкой: https://tuqo.ru/prompt.md
• Skill для Claude Code / Cursor / Codex: https://tuqo.ru/SKILL.md
• REST API (OpenAPI 3.1): https://tuqo.ru/openapi.json
• Сайт: https://tuqo.ru · для ИИ-ассистентов: https://tuqo.ru/ai/

Что умеет агент: 50 инструментов — сайты, деплой файлами или архивом со сборкой, статус и логи, откат, предпросмотр, домены с SSL и диагностикой A-записи, заявки форм и автоответ с лид-магнитом, пять режимов закрытого доступа (пароль, код на почту, подписчики Telegram/MAX, регистрация с модерацией, платный доступ на эквайринге владельца), серверная аналитика. Без аккаунта — черновик на 24 часа через POST https://api.tuqo.ru/instant/deploy.

Быстрый старт — команды выше; остальные клиенты: https://tuqo.ru/connect/.