Share a Telegram URL to get a one-time MCP token. The link has no secret. After the Mini App shows the token once, run aiworkers-mcp login and paste it. Works without an existing key.

Return the AIWorkers MCP SKILL.md (how to log in and which tools to call). No existing key required.

Write/refresh SKILL.md into ~/.cursor/skills/aiworkers (and project .cursor/skills if present). Call this to pick up the latest skill after a deploy. No existing key required.

Show what this API key can see: groups, modules, endpoint map. Call this first. If there is no key, returns the login URL.

Mint a child awm_ token for one module + one group. Parent awp_ only. Token is shown once. save=true (default) writes it to credentials.json so this MCP can call that module without Mini App. Free for now; later will debit group TokenTime.

Fetch current Survey DSL parsing rules from the server.

Validate Survey DSL without saving.

List surveys for this API token (scoped by group_id). Archived hidden unless include_archived.

Get survey DSL and metadata. survey_id may be the full id, public slug, or form URL.

Update survey DSL (POST; nginx often 405s PUT).

Fetch respondent answers for a survey.

Get post-submit automation scenarios.

Save post-submit scenarios (JSON array or {"scenarios": [...]}).

Agent skill: auth, endpoints, group-bound token.

Create a survey from DSL. Child token: group_id must match the key or be omitted. Mismatch → 403.

Funnel stats for a survey.

Read survey settings (view mode, etc.).

Save survey settings. settings_json is an object or {"settings": {...}}.

Archive (hide from list) or restore a survey. Does not delete answers.

Permanently delete a survey, DSL file, and answers. Requires confirm=true.

form_url + chat_text for workers_chat_send / readyreply. No native open-in-chat widget.

List tasks for a Telegram group (manual + booking).

Count tasks with the same filters as tasks_list.

Get one task by id.

Create a manual task (optional Telegram card + calendar hold).

Update task fields. patch_json: JSON object with title/description/status/dates.

Batch update: updates_json is JSON array of {id, ...fields}.

Mark task done (releases calendar hold).

Cancel task (releases calendar hold).

List workers this key can access. Each row has group tt/usd/stars. Root account is the shared USD wallet once. For one group use workers_balance.

Read the worker card (no bot tokens). For money prefer workers_balance.

Update worker fields: status, lang, paid_until, translate_langs. Never write tt here — use workers_salary_quote or workers_tt_buy_quote.

Two layers: account.usd (shared wallet) and group.tt (TokenTime). Empty group_id uses credentials / AIWORKERS_GROUP_ID, else «нужен group_id». Does not charge.

URL to top up the ACCOUNT wallet in @aiworkersbot (users.balance). Does not credit group tt. No tt_credit. If amount_usd omitted: ask_amount=true and start=addBalance. If set: start=addBalance_10 (integer USD); bot shows Change amount. Dot in start payload is invalid.

Preview raising YOUR contribution by whole USD. Debits account, adds add_usd*3600 tt, raises solary. Does not charge until workers_salary_confirm(quote_id, confirm=true). Other admins can raise their own share.

Charge a salary quote. confirm must be true. Quote lives ~5 min; reuse is 409. Cannot decrease contribution (write @dimaneuron).

Preview one-time tt buy at 10x subscription ($10 → 3600 tt). Does not change solary. Pass amount_usd or tt. Does not charge until workers_tt_buy_confirm.

Charge a one-time tt quote. confirm must be true. Quote lives ~5 min; reuse is 409. solary unchanged.

Platform partner terms, catalog/builder/community URLs, ref_link. rates is a constants dict — do not invent percents if empty. Not the worker-bot /ref product.

Read memory topics and entries. Optional topic=topic_.

Add a memory entry to a topic (topic_*).

Edit a memory entry by message_id.

Delete a memory entry by message_id.

Create a new memory forum topic.

List user chats (no message logs).

Get one user chat card (no message logs).

Send one message to a known chat from workers_chats_list. channel=auto|bot|embed|topic (auto: bot DM, or embed outbox for widget users). Mirrors into the user's forum topic. Need text and/or rr_id. Does not send to arbitrary Telegram ids. Rate-limited.

Preview a one-shot DM blast of a ready reply to everyone who already wrote this worker bot. Does not send until workers_broadcast_confirm(quote_id, confirm=true). Not widget, not folders, not arbitrary ids.

Start the quoted bot-user blast. confirm must be true. Quote lives ~5 min; reuse 409. Status goes to the mailing topic.

List ready replies, or one item if rr_id is set.

Create or update a ready reply. Posts the donor into the native ready-reply Telegram topic (P{message_id} + customization button). item_json: text/triggers/caption/buttons/topic_name.

Delete a ready reply by id.

Create a Telegram topic for ready replies.

Bot connection status (username/id, no token). Does not send messages.

Read bot command menu (segments + translations). Does not send messages.

Save bot commands. JSON: builtin/custom/segments/translations. Syncs Bot API menu, no chats.

Restart this group's Telegram worker process (pm2 aibot-). Same as /telegram_bot «Перезапустить скрипт». Rate-limited (60s per bot); on 429 wait retry_after, do not loop. Use when the user asks to restart the bot — not workers_update. Does not send messages.

Resolve Booking CRM context: linked Telegram group and topic keys.

Create/update/cancel a Booking CRM event. payload_json: {action, event, ...}.