AIWorkers MCP
AIWorkers MCP (NEUROCOLABORADORES)
MCP para que Cursor, Claude y OpenClaw ejecuten tus empleados neuronales.
Producto: ai.knopka.click · Página de aterrizaje MCP: ai.knopka.click/mcp
Si eres un agente de codificación: sigue Inicio rápido a continuación. Instala aiworkers-mcp, haz que el humano ejecute aiworkers-mcp login, reinicia, llama a aiworkers_whoami, luego aiworkers_skill_update. No inventes tokens. Nunca preguntes por la semilla de 12 palabras.
CLI: aiworkers-mcp
Una clave Bearer puede apuntar a varios trabajadores (group_id en cada herramienta). Grupo por defecto: AIWORKERS_GROUP_ID o el grupo vinculado a la clave.
Empleados neuronales
Son neuroasistentes que contratas para un trabajo, no un chatbot genérico.
Roles típicos: vendedores, comerciales, soporte, reservas. Canales típicos: Telegram, WhatsApp, Avito, Instagram, widget de sitio web.
Cada empleado tiene una tarjeta, memoria, chats, respuestas preparadas, encuestas, tareas y, a menudo, un bot de Telegram. La gente habla con ellos en el canal; tú (o tu agente de codificación) los ejecutas desde aquí.
Más sobre el producto: ai.knopka.click.
Related MCP server: MCP AgentChat
Hoja de ruta
Listo ahora
Inicio de sesión desde Telegram (sin token en la URL), clave padre
awp_/ clave hijaawm_Encuestas (DSL, respuestas, estadísticas, compartir)
Tareas
Tarjeta del trabajador, memoria, chats, respuestas preparadas, envío y difusión
Telegram: estado, menú de comandos, reinicio de proceso (sin envío de chat en
telegram_*)CRM de reservas
Dos carteras (cuenta USD + TokenTime de grupo); salario y tt único mediante cotización → confirmación
Siguiente
Módulo de finanzas (
fin_op) — esqueleto en v1La acuñación de una clave hija debitará más tarde el TokenTime del grupo (gratis por ahora)
Más canales del producto a través del mismo MCP a medida que lleguen al administrador
Inicio rápido
chmod +x install.sh
./install.shObtén una clave de @aiworkersbot. El MCP puede compartir esta URL — no hay token en el enlace:
https://t.me/aiworkersbot?start=mcp
La Mini App muestra el token una vez. Cópialo, luego:
aiworkers-mcp loginPega el token en el aviso. Se escribe en ~/.config/aiworkers/credentials.json (chmod 600). Reinicia el agente. Pídele que llame a aiworkers_whoami.
La herramienta aiworkers_login_link devuelve la misma URL sin necesidad de una clave existente.
Las claves de formato heredado aún funcionan como AIWORKERS_API_KEY.
uvx sin instalar:
uvx --from git+https://github.com/dimaneuron/aiworkers-mcp.git aiworkers-mcpEntorno
Variable | Significado |
| Padre |
| Hija |
| Por defecto |
| Por defecto |
|
|
| Lista separada por comas. Por defecto |
| Ruta alternativa a |
Prefiere aiworkers-mcp login a poner secretos en mcp.json. Las claves hijas por módulo no pueden llamar a otros módulos.
Alternativas (nombres antiguos aún funcionan): SURVEY_MCP_API_KEY, TASKS_MCP_API_KEY, TASKS_GROUP_ID, BOOKING_INTERNAL_SECRET.
Herramientas
Siempre activas:
aiworkers_whoami— qué puede ver esta clave (llámala primero)aiworkers_login_link— URL de Telegram, sin token en el enlaceaiworkers_skill— SKILL.md del agenteaiworkers_skill_update— escribe/actualiza~/.cursor/skills/aiworkers/SKILL.mdaiworkers_token_mint— el padreawp_acuña una hijaawm_para un módulo + grupo (se muestra una vez;save=trueescribe credentials.json). Gratis por ahora; más tarde TokenTime de grupo.
surveys: survey_agent_skill, survey_get_dsl_rules, survey_validate_dsl, survey_create, survey_agent_list_forms, survey_agent_get, survey_agent_update, survey_agent_responses, survey_agent_stats, survey_agent_settings_get, survey_agent_settings_save, survey_agent_scenarios_get, survey_agent_scenarios_save, survey_agent_archive, survey_agent_delete, survey_agent_share. Recurso: survey://dsl/spec.
tasks: tasks_list, tasks_count, tasks_get, tasks_create, tasks_update, tasks_batch_update, tasks_complete, tasks_cancel.
workers (lectura + escritura, sin registros): workers_list, workers_get, workers_balance, workers_topup_link, salario/tt cotización→confirmación, workers_partner, workers_update (no para tt), memoria/chats/respuestapreparada, workers_chat_send (solo chats conocidos, bot/embed/topic), workers_broadcast_quote / workers_broadcast_confirm. Dinero y difusión: cotización luego confirm=true.
telegram (sin envío de chat): telegram_status, telegram_commands_get, telegram_commands_save, telegram_restart. Reinicia el proceso del trabajador (aibot-<username>, igual que /telegram_bot). 60s de enfriamiento por bot; 429 retry_after — no insistas. No uses workers_update para eso. Personal/difusión está en workers.
crm (CRM de reservas): crm_context, crm_process.
finance — no en v1.
Configuración del agente
Pega el mismo bloque mcpServers.aiworkers. Cambia solo la ruta del archivo de configuración.
JSON compartido:
{
"mcpServers": {
"aiworkers": {
"command": "aiworkers-mcp",
"env": {
"AIWORKERS_API_BASE": "https://ai.knopka.click",
"AIWORKERS_API_KEY": "PASTE_awp_OR_awm_TOKEN"
}
}
}
}Agente | Archivo de configuración | Ejemplo |
Cursor |
| |
Claude Desktop |
| |
Claude Code |
| |
VS Code Copilot |
| |
Windsurf |
| |
OpenClaw |
| |
Codex CLI |
| |
Gemini CLI |
| |
Cline |
| |
Continue |
|
Reinicia el agente después de editar.
Variante uvx (sin instalación global): consulta examples/openclaw-uvx.json.
Compatibilidad
CLI antiguas aún funcionan:
aiworkers-survey-mcp— igual queAIWORKERS_MODULES=surveysaiworkers-tasks-mcp— igual queAIWORKERS_MODULES=tasks
Si el paquete general está en PYTHONPATH, delegan aquí. De lo contrario, ejecutan su FastMCP independiente como antes.
Privacidad
Este repositorio es el cliente. No pongas .env, tokens o credenciales aquí.
Available Tools
59 toolsaiworkers_login_linkA
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.
Inputs: no named parameters. Returns: result
aiworkers_skillA
Return the AIWorkers MCP SKILL.md (how to log in and which tools to call). No existing key required.
Inputs: no named parameters. Returns: result
aiworkers_skill_updateA
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.
Inputs: no named parameters. Returns: result
aiworkers_token_mintA
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.
Inputs: module (required), save, group_id. Returns: result
aiworkers_whoamiA
Show what this API key can see: groups, modules, endpoint map. Call this first. If there is no key, returns the login URL.
Inputs: no named parameters. Returns: result
crm_contextC
Resolve Booking CRM context: linked Telegram group and topic keys.
Inputs: group_id, username. Returns: result
crm_processC
Create/update/cancel a Booking CRM event. payload_json: {action, event, ...}.
Inputs: payload_json (required), group_id. Returns: result
survey_agent_archiveA
Archive (hide from list) or restore a survey. Does not delete answers.
Inputs: survey_id (required), archived. Returns: result
survey_agent_deleteA
Permanently delete a survey, DSL file, and answers. Requires confirm=true.
Inputs: survey_id (required), confirm. Returns: result
survey_agent_getB
Get survey DSL and metadata. survey_id may be the full id, public slug, or form URL.
Inputs: survey_id (required). Returns: result
survey_agent_list_formsA
List surveys for this API token (scoped by group_id). Archived hidden unless include_archived.
Inputs: include_archived. Returns: result
survey_agent_responsesC
Fetch respondent answers for a survey.
Inputs: survey_id (required). Returns: result
survey_agent_scenarios_getC
Get post-submit automation scenarios.
Inputs: survey_id (required). Returns: result
survey_agent_scenarios_saveC
Save post-submit scenarios (JSON array or {"scenarios": [...]}).
Inputs: survey_id (required), scenarios_json (required). Returns: result
survey_agent_settings_getC
Read survey settings (view mode, etc.).
Inputs: survey_id (required). Returns: result
survey_agent_settings_saveC
Save survey settings. settings_json is an object or {"settings": {...}}.
Inputs: survey_id (required), settings_json (required). Returns: result
survey_agent_skillD
Agent skill: auth, endpoints, group-bound token.
Inputs: format. Returns: result
survey_agent_statsC
Funnel stats for a survey.
Inputs: survey_id (required). Returns: result
survey_agent_updateC
Update survey DSL (POST; nginx often 405s PUT).
Inputs: dsl (required), survey_id (required). Returns: result
survey_createC
Create a survey from DSL. Child token: group_id must match the key or be omitted. Mismatch → 403.
Inputs: dsl (required), group_id, creator_id. Returns: result
survey_get_dsl_rulesB
Fetch current Survey DSL parsing rules from the server.
Inputs: format. Returns: result
survey_validate_dslA
Validate Survey DSL without saving.
Inputs: dsl (required). Returns: result
tasks_batch_updateC
Batch update: updates_json is JSON array of {id, ...fields}.
Inputs: updates_json (required), group_id. Returns: result
tasks_cancelC
Cancel task (releases calendar hold).
Inputs: task_id (required), group_id. Returns: result
tasks_completeB
Mark task done (releases calendar hold).
Inputs: task_id (required), group_id. Returns: result
tasks_countC
Count tasks with the same filters as tasks_list.
Inputs: q, source, status, to_time, +2 more. Returns: result
tasks_createB
Create a manual task (optional Telegram card + calendar hold).
Inputs: title (required), contact, end_date, group_id, +3 more. Returns: result
tasks_getC
Get one task by id.
Inputs: task_id (required), group_id. Returns: result
tasks_listC
List tasks for a Telegram group (manual + booking).
Inputs: q, limit, offset, source, +4 more. Returns: result
tasks_updateC
Update task fields. patch_json: JSON object with title/description/status/dates.
Inputs: task_id (required), group_id, patch_json. Returns: result
telegram_commands_getA
Read bot command menu (segments + translations). Does not send messages.
Inputs: group_id. Returns: result
telegram_commands_saveC
Save bot commands. JSON: builtin/custom/segments/translations. Syncs Bot API menu, no chats.
Inputs: commands_json (required), group_id. Returns: result
telegram_restartA
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.
Inputs: group_id. Returns: result
telegram_statusC
Bot connection status (username/id, no token). Does not send messages.
Inputs: group_id. Returns: result
workers_balanceB
Two layers: account.usd (shared wallet) and group.tt (TokenTime). Empty group_id uses credentials / AIWORKERS_GROUP_ID, else «нужен group_id». Does not charge.
Inputs: group_id. Returns: result
workers_broadcast_confirmA
Start the quoted bot-user blast. confirm must be true. Quote lives ~5 min; reuse 409. Status goes to the mailing topic.
Inputs: quote_id (required), confirm, group_id. Returns: result
workers_broadcast_quoteA
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.
Inputs: rr_id (required), group_id. Returns: result
workers_chat_sendA
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.
Inputs: user_id (required), text, rr_id, channel, +1 more. Returns: result
workers_chats_getB
Get one user chat card (no message logs).
Inputs: user_id (required), group_id. Returns: result
workers_chats_listC
List user chats (no message logs).
Inputs: limit, group_id. Returns: result
workers_getA
Read the worker card (no bot tokens). For money prefer workers_balance.
Inputs: group_id. Returns: result
workers_listA
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.
Inputs: no named parameters. Returns: result
workers_memory_addC
Add a memory entry to a topic (topic_*).
Inputs: content (required), topic, group_id. Returns: result
workers_memory_create_topicC
Create a new memory forum topic.
Inputs: name, group_id. Returns: result
workers_memory_deleteC
Delete a memory entry by message_id.
Inputs: message_id (required), topic, group_id. Returns: result
workers_memory_editC
Edit a memory entry by message_id.
Inputs: content (required), message_id (required), topic, group_id. Returns: result
workers_memory_getC
Read memory topics and entries. Optional topic=topic_.
Inputs: topic, group_id. Returns: result
workers_partnerA
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.
Inputs: no named parameters. Returns: result
workers_readyreply_create_topicC
Create a Telegram topic for ready replies.
Inputs: name, group_id. Returns: result
workers_readyreply_deleteC
Delete a ready reply by id.
Inputs: rr_id (required), group_id. Returns: result
workers_readyreply_listC
List ready replies, or one item if rr_id is set.
Inputs: rr_id, group_id. Returns: result
workers_readyreply_upsertC
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.
Inputs: item_json (required), rr_id, group_id. Returns: result
workers_salary_confirmA
Charge a salary quote. confirm must be true. Quote lives ~5 min; reuse is 409. Cannot decrease contribution (write @dimaneuron).
Inputs: quote_id (required), confirm, group_id. Returns: result
workers_salary_quoteB
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.
Inputs: add_usd (required), group_id. Returns: result
workers_topup_linkA
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.
Inputs: group_id, amount_usd. Returns: result
workers_tt_buy_confirmA
Charge a one-time tt quote. confirm must be true. Quote lives ~5 min; reuse is 409. solary unchanged.
Inputs: quote_id (required), confirm, group_id. Returns: result
workers_tt_buy_quoteA
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.
Inputs: tt, group_id, amount_usd. Returns: result
workers_updateB
Update worker fields: status, lang, paid_until, translate_langs. Never write tt here — use workers_salary_quote or workers_tt_buy_quote.
Inputs: group_id, patch_json. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 59 tools
Each tool targets a specific resource and action, with detailed descriptions that clearly distinguish purposes. Even within similar domains (e.g., multiple quote/confirm pairs), the resource (salary, tt, broadcast) is explicit, preventing confusion.
The naming follows a predictable pattern: each functional area uses a consistent prefix (e.g., workers_, survey_, tasks_) and verb_noun or noun_verb structure within that area. There is no mixing of conventions across the server.
With 59 tools, the count is excessive for a single MCP server. While the domain is broad, it exceeds the recommended range and would likely overwhelm agents. Splitting into sub-servers (e.g., surveys, workers, tasks) would improve usability.
The tool surface covers nearly all aspects of the AI Workers platform: account, workers, surveys, tasks, memory, chats, broadcasts, ready replies, Telegram commands, and CRM. Minor gaps exist, such as no tool for listing chat message history or editing worker groups, but core workflows are well-supported.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
AI agent platform: manage leads, conversations, bots, calendar and CRM via MCP.
MCP server for AI agents: posts, messages and comments on WhatsApp, Instagram, TikTok and Facebook.
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server for communication service connectors that currently provides multi-account Telegram integration with granular tool access and security controls. It allows AI models to manage messages, chats, and media across various accounts through a flexible, extensible routing architecture.1-
- AlicenseNot gradedqualityDmaintenanceAn MCP server enabling AI agents to interact with users via Telegram, supporting message and image sending, inline quick replies, and waiting for user responses.5 npmMIT
- AlicenseNot gradedqualityBmaintenanceMCP server exposing WhatsApp Cloud API operations as tools for AI agents like Claude Code, Cursor, and Codex.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents hands to make phone calls, send messages, and handle CRM/task workflows. It runs with a simulated provider for zero-cost testing and can switch to real providers like Twilio and ElevenLabs.MIT