Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WORKFLOWY_API_KEY | Yes | Your WorkFlowy API key from https://beta.workflowy.com/api-key | |
| WORKFLOWY_API_URL | No | The WorkFlowy API URL | https://workflowy.com/api/v1 |
| WORKFLOWY_MAX_RETRIES | No | Maximum number of retries for failed requests | 3 |
| WORKFLOWY_REQUEST_TIMEOUT | No | Request timeout in seconds | 30 |
| WORKFLOWY_RATE_LIMIT_WINDOW | No | Rate limit window in seconds | 60 |
| WORKFLOWY_RATE_LIMIT_REQUESTS | No | Number of requests allowed per rate limit window | 60 |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mcp_job_status | Get status/result for long-running MCP jobs (ETCH, NEXUS, etc.). |
| mcp_cancel_job | Request cancellation of a long-running MCP job (ETCH, NEXUS, etc.). |
| workflowy_create_single_node | DEPRECATED: Use workflowy_etch (ETCH) instead |
| workflowy_create_single_node__WARNING__prefer_ETCH | ⚠️ WARNING: Prefer workflowy_etch (ETCH) instead. This creates ONE node only. |
| workflowy_update_node | Update an existing WorkFlowy node |
| workflowy_get_node | DEPRECATED: Use workflowy_glimpse (GLIMPSE) instead |
| workflowy_get_node__WARNING__prefer_glimpse | ⚠️ WARNING: Prefer workflowy_glimpse (GLIMPSE) for reading trees. Retrieve a specific WorkFlowy node by ID |
| workflowy_list_nodes | DEPRECATED: Use workflowy_glimpse (GLIMPSE) instead |
| workflowy_list_nodes__WARNING__prefer_glimpse | ⚠️ WARNING: Prefer workflowy_glimpse (GLIMPSE) for reading trees. List WorkFlowy nodes (omit parent_id for root) |
| workflowy_delete_node | Delete a WorkFlowy node and all its children |
| workflowy_complete_node | Mark a WorkFlowy node as completed |
| workflowy_uncomplete_node | Mark a WorkFlowy node as not completed |
| workflowy_move_node | Move a WorkFlowy node to a new parent |
| nexus_glimpse | GLIMPSE → TERRAIN + PHANTOM GEM (zero API calls). Captures what you've expanded in Workflowy via WebSocket GLIMPSE and creates both coarse_terrain.json and phantom_gem.json from that single local extraction. No Workflowy API calls, instant, you control granularity by expanding nodes. |
| workflowy_export_node | Export a WorkFlowy node with all its children |
| workflowy_refresh_nodes_export_cache | Force a fresh /nodes-export snapshot and update the local cache used by NEXUS and the UUID Navigator. |
| nexus_scry | INITIATE a CORINTHIAN NEXUS on the ETHER: perform a COARSE SCRY of Workflowy under a root to reveal a limited TERRAIN (a new geography named by your NEXUS TAG). Choose max_depth and child_limit carefully—keep them minimal. Optionally set max_nodes to guard against accidental 1M-node SCRYs. Later, you will IGNITE the ETHER more deeply on selected SHARDS. |
| nexus_ignite_shards | IGNITE selected SHARDS so the ETHER glows more deeply around them, revealing deeper layers (but not necessarily to FULL depth). The deeper revelation is captured as a PHANTOM GEM (S0), an unrefracted witness of those subtrees. |
| nexus_anchor_gems | Let the PHANTOM GEM ILLUMINATE the TRUE GEMS that were ALWAYS PRESENT in the TERRAIN but not yet revealed: where SHARDS were marked, the TERRAIN now shimmers with deeper revealed structure (FIRST IMBUE—NOTHING CHANGES in the ETHER). The PHANTOM GEM remains a REFLECTION: an untouched witness. |
| nexus_anchor_jewels | Anchor the PHANTOM JEWELS (S1) within the SHIMMERING TERRAIN (T1), transmuting the REVEALED GEMS into NEW JEWELS that are an exact impregnation of the PHANTOM JEWELS. The TERRAIN becomes ENCHANTED (SECOND IMBUE), with the PHANTOM GEM (S0) as witness to the ORIGINAL state. The ENCHANTED TERRAIN is now EMBODIED and REAL as JSON—Workflowy remains untouched until WEAVE. |
| nexus_transform_jewel | Apply JEWELSTORM semantic operations to a NEXUS working_gem JSON file (PHANTOM GEM working copy). This is the semantic analogue of edit_file for PHANTOM GEM JSON: MOVE_NODE, DELETE_NODE, RENAME_NODE, SET_NOTE, SET_ATTRS, CREATE_NODE, all referencing nodes by jewel_id, plus text-level SEARCH_REPLACE / SEARCH_AND_TAG over name/note fields (substring/whole-word, optional regex, tagging in name and/or note based on matches). |
| nexus_weave_enchanted_async | Start an async NEXUS ENCHANTED WEAVE job (WEAVE T2 back into Workflowy ETHER) and return a job_id for status polling and cancellation. |
| nexus_start_exploration | Start a NEXUS exploration session over a Workflowy subtree. The engine always controls traversal and returns frontiers (batches of leaves) for you to label. In dfs_guided_explicit you explicitly decide every leaf; in dfs_guided_bulk you may also perform bulk branch/descendant actions. Set editable=True to enable update-and-engulf actions that mutate names/notes in the cached tree. |
| nexus_explore_step | Apply exploration decisions to an existing NEXUS session and return the next frontier. The engine always drives traversal and returns a frontier of leaves; in dfs_guided_explicit you explicitly label every leaf, and in dfs_guided_bulk you may also use bulk descendant actions. |
| nexus_list_exploration_sessions | List all exploration sessions (optionally filter by nexus_tag). |
| nexus_resume_exploration | Resume an exploration session after MCP restart or in new conversation. Provide either session_id (exact) or nexus_tag (finds latest session for tag). |
| nexus_finalize_exploration | Finalize an exploration session into coarse_terrain.json (always) plus optional phantom_gem.json + shimmering_terrain.json for use with NEXUS JEWELSTORM and WEAVE. |
| generate_markdown_from_json | Convert exported/edited JSON to Markdown format (without metadata). |
| workflowy_glimpse | Load entire node tree into context (no file intermediary). GLIMPSE command for direct context loading. Optional output_file writes TERRAIN export (WebSocket+API merge with full NEXUS semantics). |
| workflowy_scry | Load entire node tree via API (bypass WebSocket). Use when Key Files doesn't have parent UUID for ETCH, or when Dan wants complete tree regardless of expansion state. |
| workflowy_etch | Create multiple nodes from JSON structure (no file intermediary). ETCH command for direct node creation. |
| workflowy_etch_async | Start an async ETCH job (Workflowy node creation) and return a job_id for status polling. |
| nexus_list_keystones | List all available NEXUS Keystone backups. |
| nexus_restore_keystone | Restore a Workflowy node tree from a NEXUS Keystone backup. |
| nexus_purge_keystones | Delete one or more NEXUS Keystone backup files. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| workflowy_outline | The complete WorkFlowy outline structure |