atlas-tracker
Work with Atlas Tracker (RedForester) mindmaps via MCP tools. Use when reading, creating, or updating nodes and branches in Atlas Tracker maps — including navigating map structure, creating solution trees, updating node properties, managing typed nodes, creating link nodes, uploading files to nodes, and working with node comments. Requires at_read_branch, at_create_branch, at_update_branch, at_get_node_types, at_read_attachments, at_create_link_node, at_upload_file, at_get_comments, at_add_comment, at_delete_comment, at_update_comment tools (provided by the Atlas Tracker OpenClaw plugin).
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/didro/atlas-trackerAtlas Tracker Skill
Atlas Tracker (app.redforester.com) is a graph-based knowledge system combining mindmaps, Kanban, and structured properties. This skill covers working with it via the OpenClaw AT plugin tools.
Setup
This skill requires two components to be installed and running:
1. AT MCP Server
A local Node.js server that proxies requests to the Atlas Tracker REST API.
The AT MCP server is maintained by the Atlas Tracker / RedForester team.
Contact @gmdidro (Telegram) or visit app.redforester.com to request access.
Once you have the server files:
cd at-mcp/
yarn install
yarn build
# Run directly
node build/index.js
# Or run as a systemd user service (recommended)
cp at-mcp.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now at-mcp
The server listens on http://localhost:3222 by default.
Required environment variables (set in the service file or .env):
AT_BASE_URL=https://app.redforester.com/api
AUTH_HEADER=Basic <base64(username:md5(password))>
API_KEY=<your-local-api-key>
PORT=3222
2. OpenClaw Plugin
Copy the plugin file to your OpenClaw extensions directory:
mkdir -p ~/.openclaw/extensions/atlas-tracker/
cp index.ts ~/.openclaw/extensions/atlas-tracker/
cp openclaw.plugin.json ~/.openclaw/extensions/atlas-tracker/
Then configure the plugin in your openclaw.json:
{
"plugins": {
"atlas-tracker": {
"serverUrl": "http://localhost:3222",
"apiKey": "<your-local-api-key>"
}
}
}
OpenClaw will hot-reload the plugin automatically. Verify with:
openclaw status
You should see at_read_branch, at_create_branch, at_update_branch, at_get_node_types, at_read_attachments listed as available tools.
Core Concepts
- Map — a mindmap, identified by
mapId(full UUID) - Node — a single item in the map; has
id,title(HTML), optionaltypeId,typeProperties,children[] - Branch — a node + all its descendants
- Node type — a schema defining available properties (enum, text, htmltext, file, user, date, etc.)
- Title format — always HTML:
<p>My title</p>, never plain text
Tool URLs
All tools take a nodeUrl in format:
https://app.redforester.com/mindmap?mapid=<UUID>&nodeid=<UUID>
Both mapid and nodeid must be full UUIDs (e.g. 3d7340e8-c763-4c9e-b049-4e900b7cf565), never partial.
Workflow
Reading a branch
Always read before modifying — never assume structure:
at_read_branch(nodeUrl) → returns node tree with children, types, properties
Finding the right node
If you don't know a nodeId, search via AT REST API:
POST /api/search body: {"query": "...", "map_ids": ["<mapId>"]}
# Returns hits[].id — then at_read_branch each candidate to verify title
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-didro-atlas-tracker": {
"enabled": true,
"auto_update": true
}
}
}