Tool reference

run_code

Execute JavaScript or Python in Factorial Code’s secure environment. Enable via tools=run_code in the connection URL.

Input: { code: string; options?: { language?: 'javascript'|'python'; comment?: string; settings?: object } }
Response: { returnValue?: unknown; logs?: string[]; error?: string }

Code runs in an isolated sandbox. Subject to plans and limits.

---

Environment (set_env_var, remove_env_var)

set_env_var: { key: string; value: string; isSensitive?: boolean } — isSensitive defaults to true (masked in logs)
remove_env_var: { key: string }

---

Storage (list_files, upload_file, download_file, delete_file)

Uses Factorial Code Storage. Supports text and base64 binary. list_files accepts optional prefix.

---

Locales (get_locales, get_locale, save_locale, delete_locale)

Manages the translations fcode.i18n resolves in processes, modules and form schemas.

get_locales: { page?: number; limit?: number } — includes locales inherited from parent workspaces
get_locale: { locale: string } — follows inheritance
save_locale: { locale: string; content: string } — creates or replaces; content is the YAML document
delete_locale: { locale: string } — only locales this workspace owns

---

Process execution (dynamic)

Process tools: tag with mcp-tool (auto-exposed) or custom tags (add to the tools query param). See Configuration.

Input: { parameters?: any; options?: { tag?: string; comment?: string }; synchronousExecution?: boolean }
Sync response: { executionId, logs, returnValue?, error? }
Async response: { executionId }

Define a clear JSON Schema for process inputs so the AI can call correctly.

---

API management (fc_api, fc_api_full)

Enable via tools=fc_api or fc_api_full (adds version management) in the connection URL.

fc_api	fc_api_full adds
Processes, schedules, variables, locales, storage, executions, modules	Process/module versions

Examples: get_processes, execute_process_sync, get_execution, etc. Full list and payloads: REST API Reference.