uCoz MCP

Manage a uCoz site with AI: templates, materials, shop, users, and files

MCP skills library for your AI agents

Ready scenarios for Cursor, Claude Code, and VS Code: landings, shop setup, site translation, and more. Connect a skill — the agent learns how to work with your site.

Open catalog

What is MCP for uCoz

MCP connects the AI in your editor to your uCoz site. Instead of working only in the control panel, you write normally: “update the header”, “add a news post”, “create a product with sizes”. The ucoz-mcp server exposes ten tools: template and page editing, publishing materials, online shop, subscriptions, users, FTP, and official skills.

Requires Node.js 18+. Connect with one command: npx ucoz-mcp@latest. Below are MCP capabilities in plain language; exact parameters are visible to the AI in Cursor, Claude, or ChatGPT (Codex).

MCP features

⚡ Template editing

Update site HTML templates in pieces: edit blocks, validate code, keep an automatic backup before save, and roll back quickly.

🏗️ Whole-site design

Build a shared design skeleton and publish it to every template at once — header, footer, module pages, and global blocks.

📰 Publishing materials

Create and edit news, blog posts, articles, listings, photos, and videos; manage categories, comments, and the forum.

🛒 Online shop

Create categories and products, size and color variants, stock, basket, checkout, order statuses, and customer balance.

💳 Paid subscriptions

Set up plans, grant or cancel access, track payments, and check whether paid content is open to a specific user.

👥 User management

Register and edit accounts, access groups, permissions, ranks, and extra profile fields.

📁 Files and FTP

Upload and update CSS, JavaScript, and images, create folders, and change the FTP password without opening the panel by hand.

📦 Site modules

Install the uCoz modules you need, enable module API access, and unlock indexing quarantine after launch.

🎯 Ready AI skills

Pick a scenario from the uCoz catalog — landing, shop, translation, and more — install it in your editor and follow the guide.

📚 API documentation help

When details are missing, the AI finds the right section in the official OpenAPI docs on api.ucoz.net.

📬 Menus, forms, and pages

Create navigation, contact forms with email templates, and standalone pages — with the site design or a personal template.

🧩 Works in AI editors

Connect your uCoz site from Cursor, Claude Desktop, ChatGPT (Codex), Google Antigravity, and other MCP-capable apps.

Before you start

1

Install Node.js

The MCP server runs via npx.

  • Install Node.js 18+
  • Check: node -v and npx -v
Download Node.js
2

Create a uAPI token

Control panel → Site → uAPI.

  • Create a token and keep it safe
  • For full MCP access, a key with Control Panel settings access is recommended — otherwise whole-site design, module install, FTP password changes, and some subscription admin actions will not work
uAPI token help
3

FTP access

Required for file actions in ftp_tool.

  • Control panel → FTP: host, login, password
  • Password activation may take up to 15 minutes
  • You can also set it via ftp_password_set / ftp_password_change
FTP help

Connect by platform

Cursor
  1. Open Customize → MCPs (or Settings → Tools & MCP).
  2. Add a server in the UI, or edit mcp.json: project — .cursor/mcp.json, global — ~/.cursor/mcp.json.
  3. Paste:
{
	"mcpServers": {
		"ucoz-mcp": {
			"command": "npx",
			"args": ["-y", "ucoz-mcp@latest"],
			"env": {
				"UCOZ_API_TOKEN": "YOUR_UCOZ_API_TOKEN",
				"UCOZ_SITE_URL":  "https://your-site.ucoz.net/",
				"UCOZ_FTP_HOST":  "your-site.ucoz.net",
				"UCOZ_FTP_USER":  "your-ftp-login",
				"UCOZ_FTP_PASS":  "your-ftp-password"
			}
		}
	}
}

Optional: UCOZ_WORKSPACE — project root for skill installs. Save and restart MCP in Cursor.

ChatGPT (Codex)

MCP is configured in Codex CLI / the ChatGPT agent via ~/.codex/config.toml (or project .codex/config.toml). Format is TOML, not JSON.

  1. Quick way: codex mcp add ucoz-mcp --env UCOZ_API_TOKEN=… --env UCOZ_SITE_URL=… --env UCOZ_FTP_HOST=… --env UCOZ_FTP_USER=… --env UCOZ_FTP_PASS=… -- npx -y ucoz-mcp@latest
  2. Or add the block by hand:
[mcp_servers.ucoz-mcp]
command = "npx"
args = ["-y", "ucoz-mcp@latest"]
startup_timeout_sec = 20

[mcp_servers.ucoz-mcp.env]
UCOZ_API_TOKEN = "YOUR_UCOZ_API_TOKEN"
UCOZ_SITE_URL  = "https://your-site.ucoz.net/"
UCOZ_FTP_HOST  = "your-site.ucoz.net"
UCOZ_FTP_USER  = "your-ftp-login"
UCOZ_FTP_PASS  = "your-ftp-password"

Check with codex mcp list. Optionally add UCOZ_WORKSPACE under env.

Google Antigravity
  1. In the agent panel: … → MCP Servers → Manage MCP Servers → View raw config.
  2. Or edit the file directly: global ~/.gemini/config/mcp_config.json, project — .agents/mcp_config.json.
  3. Add:
{
	"mcpServers": {
		"ucoz-mcp": {
			"command": "npx",
			"args": ["-y", "ucoz-mcp@latest"],
			"env": {
				"UCOZ_API_TOKEN": "YOUR_UCOZ_API_TOKEN",
				"UCOZ_SITE_URL":  "https://your-site.ucoz.net/",
				"UCOZ_FTP_HOST":  "your-site.ucoz.net",
				"UCOZ_FTP_USER":  "your-ftp-login",
				"UCOZ_FTP_PASS":  "your-ftp-password"
			}
		}
	}
}

Save and refresh the MCP list. In Antigravity 2.0, servers also appear under Settings → Customizations → Installed MCP Servers.

Claude Desktop

Add the config to claude_desktop_config.json. Easiest: open it via Developer → Edit Config in the app.

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: usually %APPDATA%\Claude\claude_desktop_config.json (if MCP does not load, open the file via Edit Config in the app)
{
	"mcpServers": {
		"ucoz-mcp": {
			"command": "npx",
			"args": ["-y", "ucoz-mcp@latest"],
			"env": {
				"UCOZ_API_TOKEN": "YOUR_UCOZ_API_TOKEN",
				"UCOZ_SITE_URL":  "https://your-site.ucoz.net/",
				"UCOZ_FTP_HOST":  "your-site.ucoz.net",
				"UCOZ_FTP_USER":  "your-ftp-login",
				"UCOZ_FTP_PASS":  "your-ftp-password"
			}
		}
	}
}

Save the file and fully restart Claude Desktop.

MCP tools

Ten tools for different jobs. Open a card for a short summary of each. Names like templates_tool are for the AI; you mainly need the meaning.

templates_tool

Edit one template, menus, forms, and pages

Everyday design tmaker_tool

Roll out a new design across the whole site

Constructor content_tool

News, blog, forum, photo, and other sections

Content shop_tool

Products, variants, stock, basket, and orders

Shop subscriptions_tool

Paid plans, access, and payments

Subscriptions users_tool

Users, groups, and permissions

Accounts ftp_tool

Server files and the FTP password

Files modules_tool

Install a site module and open its API

Modules skills_tool

Find and install a ready scenario from the catalog

Skills docs_tool

Look up the official API documentation

Help
templates_tool One template at a time. A safety copy is made before saving. In templates you can output menus and forms: $NMENU_<ID>$, $SMENU_<ID>$, $MFORM_<ID>$.
Action group Covers
list_modules, get_variables, read_template, patch_template, update_template, validate_templateRead/edit. For existing code use only patch_template; update_template is a full rewrite. Take variables from the API — do not invent them.
list_backups, create_backup, delete_backup, restore_backupVersion history and rollback.
gblock_create, gblock_deleteGlobal blocks. Delete needs gblock_id + confirm=true.
menu_*List, CRUD menus, and item tree (menu_update_items).
mail_*Forms, fields, email HTML template.
page_*Site pages; personal page_tmpl must include $POWERED_BY$.
get_reference, get_guide, get_backup_guideBuilt-in guides for the template language and backups.
patch_template — surgical edits
ParameterDescription
code_searchExact fragment from read_template (byte-exact, exactly one match).
code_pasteReplacement; "" deletes the fragment. Never remove or hide $POWERED_BY$.
tmaker_tool Whole-design level. One skeleton expands into every template. Requires Control Panel settings access.
Actions Meaning
skeleton_guide, skeleton_rulesStart with service-block rules and allowed variables.
designs_list, design_get, project_*Stock designs and your skeleton snapshots.
skeleton_validate, skeleton_archiveValidate without publishing; ZIP the skeleton.
skeleton_publishPublish to all templates. Only with confirm=true after “Yes, I confirm.”; rejected without $POWERED_BY$.
content_tool Content of site modules. Pick a module (news, blog…), then an action: list, create, edit, and so on.
Group Typical actions
Entrieslist, get, add, update, delete, fields, tags, rate
Categories / albums / channelscategory_*, album_list, channel_*, channel_category_*
Comments and filterscomments_*, comments_all, filter_*, smiles
Forumsection_*, topic_*, post_*, poll_*
shop_tool Online shop: catalog, variations, option stock, basket, checkout, orders, balance.
Group Typical actions
Catalogcategory_*, list/get/add/update/delete/hide, img_*
Variationsvariation_dict → variation_gen (fields with var_*, confirm) → variations_list / variation_*
Stock / basketstock_*, basket_*, checkout_*
Orders and balanceinvoices_*, order_*, currencies, balance_*, comments_*
subscriptions_tool Paid plans and access. Admin actions need Control Panel settings access.
Group Typical actions
Plansplans_*, legacy_item*
Subscriptionssubscription_*, user_subscriptions, subscribers_list, access_check
Paymentspayments_*, payment_* (incl. confirm / refund with confirm=true)
users_tool Site users, groups and rights, ranks, profile fields.
Group Typical actions
Userslist, get, add, register, update, delete, chlogin, chgroup, chpass
Groupsgroups / groups_list, group_add/update/delete, groups_rights, group_permissions
Dictionariesranks, fields
ftp_tool Files via FTP env credentials; FTP password via uAPI (needs CP access).
Action What it does Key params
list / mkdir / deleteListing, mkdir, deletepath; delete also needs confirm
read / writeRead/write a text filefilepath; write also needs content
renameRename / movesource, destination
uploadLocal file → FTPlocal_path, remote_path
ftp_password_getFTP settings without password—
ftp_password_set / changeSet or change passwordftp_password
ftp_password_resetReset passwordconfirm=true
modules_tool Install and remove site modules, enable uAPI, and manage indexing quarantine. Most actions need Control Panel access.
Action What it does
modules_list / module_status / active_modsCatalog and statuses
module_install / module_uninstallInstall / uninstall (confirm on uninstall)
module_enable_uapi / module_disable_uapiToggle module uAPI methods
quarantine_status / quarantine_unlockIndexing quarantine; unlock with confirm
skills_tool Ready scenarios from the uCoz catalog: the AI finds a match, installs it in your editor, and follows the guide.
Action In plain words
resolveSuggests which skill fits your request
catalogLists official skills
statusChecks whether the skill is already installed
installInstalls it into Cursor, Claude, ChatGPT (Codex), etc.
register_usageMarks that the skill ran successfully on the site (usually done by the skill itself)
docs_tool If the AI needs more detail, it can search the official API docs on api.ucoz.net.
Action Why
searchFind a docs section by keywords
listModules that have documentation
fetch_specOpen a specific module docs file

Typical scenarios

1. Homepage landing

  1. Read the current homepage template
  2. Set up a menu with anchor links
  3. Upload CSS and JS
  4. Apply the template edits (a safety copy is saved automatically)

2. Contact form

  1. Create a form and add fields
  2. Set up the email text
  3. Place the form into the template

3. News or article

  1. Make sure the module is on and available via API
  2. Create or edit the entry in chat
  3. Update the modification date if you need it refreshed

4. Product with sizes and colors

  1. Define properties in the dictionary (Size, Color…)
  2. Generate combinations for the product
  3. Review the variants and adjust price or stock if needed

5. New design for the whole site

  1. Read the skeleton rules
  2. Validate without publishing
  3. Save a snapshot and publish (after an explicit confirmation)

6. Prepare a new site

  1. Enable the modules you need and open their API
  2. Check or set the FTP password
  3. Unlock indexing quarantine when the site is ready for search

7. Work through a catalog skill

  1. Ask the AI to pick a skill for the task
  2. Install it if it is not installed yet
  3. Follow the skill’s instructions

8. Roll back a template

  1. Browse saved copies
  2. Restore the version you need
  3. Check that the site looks right again

9. Create a page with a custom template

  1. Review existing pages
  2. Create a page with a title, content, and its own HTML template
  3. Check the page on the site and unlock indexing quarantine if needed

10. Create a site menu

  1. See which menus already exist
  2. Create a horizontal or vertical menu and fill in the links
  3. Place the menu output in a template (header, footer, or sidebar)

11. Edit a module template

  1. Open the module template and the list of allowed variables
  2. Copy the fragment to replace and apply a surgical edit
  3. Check the result; if something breaks, restore a saved copy

12. Subscription plan and access

  1. Create or update a subscription plan
  2. Grant the user a subscription for the needed period
  3. Confirm that paid content is open for them