atlas-mcp-server

Developer Tools
OS Automation

TypeScript

Apache-2.0

security – no known vulnerabilities (report Issue)

license - permissive license (Apache-2.0)

quality - confirmed to work

ATLAS (Adaptive Task & Logic Automation System) is a Model Context Protocol server that provides hierarchical task management capabilities to Large Language Models. This tool provides LLMs with the structure and context needed to manage complex tasks and dependencies.

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

Tools

Functions exposed to the LLM to take actions

Name	Description
`create_task`	Creates a new task with rich content support and automatic status tracking. Supports nested subtask creation. Best Practices: 1. Dependencies must use actual task IDs, not arbitrary strings 2. Create dependent tasks in order, using the returned task IDs 3. Notes support markdown, code, and JSON formats 4. Use metadata.context to provide clear task context 5. Use metadata.tags for categorization 6. Consider task hierarchy - group related tasks under a parent 7. Use reasoning fields to document decision-making process - be clear and concise; 1-2 sentences max. Focus on actionable insights. Example: 1. Create parent task first 2. Note its ID from the response 3. Create child tasks using parentId 4. Use previous task IDs for dependencies Common Mistakes: - Using string identifiers instead of task IDs for dependencies - Creating tasks with dependencies before their dependent tasks exist - Not maintaining proper task hierarchy - Missing context in metadata - Not documenting task reasoning and assumptions
`bulk_create_tasks`	Creates multiple tasks at once under the same parent. Best Practices: 1. Use for creating related tasks that share the same parent 2. Consider task order and dependencies 3. Create dependent tasks in separate calls if they need IDs from previous tasks 4. Provide clear context and metadata for each task 5. Document reasoning for task organization Common Mistakes: - Trying to create dependent tasks before their dependencies exist - Missing task context and metadata - Not considering task hierarchy - Missing reasoning documentation
`get_task`	Retrieves a task by ID with all its content and metadata. Best Practices: 1. Use to verify task creation and updates 2. Check task status and dependencies 3. Review subtask hierarchy
`update_task`	Updates an existing task with automatic parent status updates and dependency validation. Best Practices: 1. Verify task exists before updating 2. Consider impact on dependent tasks 3. Update status appropriately 4. Maintain task context in metadata 5. Document reasoning changes Status Flow: - pending → in_progress → completed - pending → blocked (if dependencies not met) - in_progress → failed (if issues occur)
`bulk_update_tasks`	Updates multiple tasks at once with automatic parent status updates and dependency validation. Best Practices: 1. Use for batch status updates or metadata changes 2. Consider impact on task hierarchy 3. Maintain data consistency 4. Document changes in reasoning Common Mistakes: - Not using valid task IDs - Creating circular dependencies - Inconsistent status updates - Missing context in updates
`delete_task`	Safely deletes a task and its subtasks with dependency checking. Best Practices: 1. Check for dependent tasks first 2. Consider impact on parent task 3. Verify task completion status Common Mistakes: - Deleting tasks that others depend on - Not considering impact on project structure
`get_subtasks`	Retrieves all subtasks of a task for hierarchy navigation. Best Practices: 1. Use for understanding task breakdown 2. Check subtask status and progress 3. Verify task relationships
`get_task_tree`	Retrieves the entire task hierarchy starting from root tasks. Best Practices: 1. Use for understanding overall project structure 2. Check task relationships and dependencies 3. Monitor project progress 4. Verify task organization
`get_tasks_by_status`	Retrieves all tasks with a specific status for progress tracking. Best Practices: 1. Monitor task progress 2. Identify blocked or failed tasks 3. Track completion status 4. Find tasks needing attention

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`TASK_STORAGE_DIR`	Yes	Directory for task data storage

Need Help?View Source Code Report Issue

README.md

ATLAS MCP Server

Overview
Features
Installation
Configuration
Task Structure
Tools
Best Practices
Development
Up Next
Contributing
License

Overview

Model Context Protocol Server

ATLAS implements the Model Context Protocol (MCP), created by Anthropic, which is a standardized communication protocol between LLMs and external systems. The architecture consists of:

Clients (Claude Desktop, IDEs) that maintain server connections
Servers that provide tools and resources to clients
LLMs that interact with servers through client applications

This architecture creates a secure boundary between LLMs and external systems while enabling controlled access to functionality.

Core Components

ATLAS is built on several robust core components:

TaskManager: Central coordinator for all task operations
TaskStore: Handles persistent storage and retrieval of tasks
DependencyValidator: Ensures valid task relationships and dependencies
StatusManager: Manages task state transitions and propagation
StorageManager: Provides durable data persistence
RateLimiter: Controls request rates (600 req/min)
HealthMonitor: Tracks system health
MetricsCollector: Gathers performance metrics
RequestTracer: Traces request flow

Through the MCP protocol, ATLAS empowers LLMs to break down complex projects into manageable tasks, track their progress, and maintain dependencies — all within an organized hierarchical structure.

Features

Task Organization

Hierarchical task structures with parent-child relationships
Dependency management and validation
Status tracking and automatic propagation
Bulk operations for efficient task management
Session-based task isolation

Content Support

Markdown documentation
Code snippets with syntax highlighting
JSON data structures
Rich metadata and tagging
Task reasoning documentation
Decision-making history

System Features

Rate limiting (600 requests/minute)
Health monitoring and metrics
Request tracing
Error handling with detailed context
Graceful shutdown handling
Session management
Audit logging

Performance

Efficient task storage and retrieval
Bulk operation support
Request timeout handling
Concurrent request management
Resource cleanup

Installation

Setup Steps

Clone the repository:

git clone https://github.com/cyanheads/atlas-mcp-server.git

Navigate to the project directory:

cd atlas-mcp-server

Install dependencies:

npm install

Build the project:

npm run build

Create a storage directory for tasks:

mkdir -p ~/Documents/atlas-tasks

The server is now ready to be configured and used with your MCP client.

Configuration

ATLAS requires configuration in your MCP client settings:

{
  "mcpServers": {
    "atlas": {
      "command": "node",
      "args": ["/path/to/atlas-mcp-server/build/index.js"],
      "env": {
        "TASK_STORAGE_DIR": "/path/to/storage/directory"
      }
    }
  }
}

Environment Variables

Variable	Description	Required
TASK_STORAGE_DIR	Directory for task data storage	Yes

Task Structure

Tasks support rich content, metadata, and reasoning documentation:

{
  "name": "Implementation Task",
  "description": "Implement core functionality",
  "type": "task",
  "notes": [
    {
      "type": "markdown",
      "content": "# Requirements\n- Feature A\n- Feature B"
    },
    {
      "type": "code",
      "language": "typescript",
      "content": "interface Feature {\n  name: string;\n  enabled: boolean;\n}"
    }
  ],
  "reasoning": {
    "approach": "Modular development with focus on reusability",
    "assumptions": [
      "System supports TypeScript",
      "Features can be toggled independently"
    ],
    "alternatives": [
      "Monolithic implementation",
      "Feature flags in configuration"
    ],
    "risks": [
      "Increased complexity from modularity",
      "Performance overhead from dynamic loading"
    ],
    "tradeoffs": [
      "Flexibility vs simplicity",
      "Runtime performance vs maintainability"
    ],
    "constraints": [
      "Must maintain backward compatibility",
      "Must work in all supported browsers"
    ],
    "dependencies_rationale": [
      "Depends on core module for type definitions",
      "Requires configuration service for feature flags"
    ],
    "impact_analysis": [
      "Affects system startup time",
      "Changes how features are loaded and managed"
    ]
  },
  "metadata": {
    "context": "Core implementation phase",
    "tags": ["core", "implementation"]
  }
}

The reasoning field provides structured documentation of decision-making:

approach: High-level implementation strategy
assumptions: Key assumptions made during planning
alternatives: Other approaches that were considered
risks: Potential issues and challenges
tradeoffs: Key decisions and their implications
constraints: Technical or business limitations
dependencies_rationale: Reasoning for task dependencies
impact_analysis: Analysis of changes on the system

Example Task List (Without reasoning)

The following example demonstrates a task breakdown for a personal portfolio website project. The task list was generated from the following prompt:

You are a web developer for modern apps. Architect, design, and plan the required tasks for a personal portfolio website for a web dev that has a modern UI/UX.

<details> <summary><b>Portfolio Website Development Task List</b></summary>

[
  {
    "id": "8b4f40b2-1941-46c6-bc9f-b68d1c1b4aa2",
    "name": "Personal Portfolio Website Development",
    "description": "Design and develop a modern personal portfolio website with strong UI/UX focus",
    "type": "group",
    "status": "pending",
    "dependencies": [],
    "subtasks": [
      {
        "id": "479251ce-6e13-446a-b650-d5a4179dcc5e",
        "name": "Project Setup and Architecture",
        "description": "Initialize project and set up development environment",
        "type": "group",
        "status": "pending",
        "dependencies": [],
        "subtasks": [
          {
            "id": "fa5751e0-6005-495a-a191-85c72eb644c5",
            "name": "Technology Stack Selection",
            "description": "Choose and document the tech stack:\n- Next.js for SSG/SSR\n- Tailwind CSS for styling\n- TypeScript for type safety\n- Framer Motion for animations\n- MDX for blog content\n- Vercel for deployment",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "479251ce-6e13-446a-b650-d5a4179dcc5e"
          },
          {
            "id": "a28016aa-1eed-44e2-93a0-a7182c5ee54b",
            "name": "Project Repository Setup",
            "description": "Initialize Git repository with proper structure and configuration files",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "479251ce-6e13-446a-b650-d5a4179dcc5e"
          },
          {
            "id": "4f60ae3d-d650-4e47-b66f-d3bf523bd00f",
            "name": "Development Environment Configuration",
            "description": "Set up ESLint, Prettier, Husky hooks, and TypeScript configuration",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "479251ce-6e13-446a-b650-d5a4179dcc5e"
          }
        ],
        "metadata": {
          "created": "2024-12-16T10:47:53.916Z",
          "updated": "2024-12-16T10:47:53.916Z",
          "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
        },
        "parentId": "8b4f40b2-1941-46c6-bc9f-b68d1c1b4aa2"
      },
      {
        "id": "6e301694-88a3-4d48-959d-9d634269250b",
        "name": "UI/UX Design",
        "description": "Design the user interface and experience",
        "type": "group",
        "status": "pending",
        "dependencies": [],
        "subtasks": [
          {
            "id": "07f398eb-f3a0-42c1-8bca-84759eae7bf2",
            "name": "Design System Creation",
            "description": "Create design tokens and system:\n- Color palette\n- Typography scale\n- Spacing system\n- Component library\n- Animation guidelines",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "6e301694-88a3-4d48-959d-9d634269250b"
          },
          {
            "id": "1e0db359-05a5-4654-b60f-adab5f9c91b2",
            "name": "Wireframing",
            "description": "Create wireframes for all pages and responsive layouts",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "6e301694-88a3-4d48-959d-9d634269250b"
          },
          {
            "id": "fcb873ae-611a-4cea-af2b-cde5bd933aa7",
            "name": "High-fidelity Design",
            "description": "Create detailed designs including dark mode variants",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "6e301694-88a3-4d48-959d-9d634269250b"
          }
        ],
        "metadata": {
          "created": "2024-12-16T10:47:53.916Z",
          "updated": "2024-12-16T10:47:53.916Z",
          "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
        },
        "parentId": "8b4f40b2-1941-46c6-bc9f-b68d1c1b4aa2"
      },
      {
        "id": "3819ed9c-cbc8-4f82-92e1-014d874bb8e1",
        "name": "Core Features Development",
        "description": "Develop main features and components",
        "type": "group",
        "status": "pending",
        "dependencies": [],
        "subtasks": [
          {
            "id": "be6de74c-6a57-470f-95aa-481e7e275566",
            "name": "Layout Components",
            "description": "Develop base layout components:\n- Header with navigation\n- Footer\n- Layout wrapper\n- Mobile menu",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "3819ed9c-cbc8-4f82-92e1-014d874bb8e1"
          },
          {
            "id": "81415232-3e47-4d42-8a67-f147ab82c94c",
            "name": "Home Page",
            "description": "Create landing page with:\n- Hero section\n- Featured projects\n- Skills showcase\n- Quick contact",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "3819ed9c-cbc8-4f82-92e1-014d874bb8e1"
          },
          {
            "id": "2cf6bd8d-6e5a-42ce-a163-3c9e18abc891",
            "name": "Projects Section",
            "description": "Build projects showcase with:\n- Project cards\n- Filtering system\n- Project detail pages\n- Live demo links",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "3819ed9c-cbc8-4f82-92e1-014d874bb8e1"
          },
          {
            "id": "379e7fbd-ce61-4d9f-b36c-87baba126b69",
            "name": "About Page",
            "description": "Develop about page with:\n- Professional summary\n- Skills and technologies\n- Work experience\n- Education",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "3819ed9c-cbc8-4f82-92e1-014d874bb8e1"
          },
          {
            "id": "1da3052c-1d09-4120-ab9d-051db6226531",
            "name": "Contact Section",
            "description": "Create contact form and social links:\n- Form validation\n- Email integration\n- Social media links\n- Resume download",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "3819ed9c-cbc8-4f82-92e1-014d874bb8e1"
          }
        ],
        "metadata": {
          "created": "2024-12-16T10:47:53.916Z",
          "updated": "2024-12-16T10:47:53.916Z",
          "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
        },
        "parentId": "8b4f40b2-1941-46c6-bc9f-b68d1c1b4aa2"
      },
      {
        "id": "edf1e5f7-d747-494d-8a0f-559b3670d4a4",
        "name": "Enhancement Features",
        "description": "Implement additional features for better UX",
        "type": "group",
        "status": "pending",
        "dependencies": [],
        "subtasks": [
          {
            "id": "f1d67821-95b4-4602-9c23-1cfdd6b1d090",
            "name": "Dark Mode Implementation",
            "description": "Add dark mode support with system preference detection",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "edf1e5f7-d747-494d-8a0f-559b3670d4a4"
          },
          {
            "id": "9fdf1798-0f7b-4bf2-85a7-55ed49c57e10",
            "name": "Animations and Transitions",
            "description": "Implement smooth animations:\n- Page transitions\n- Scroll animations\n- Hover effects\n- Loading states",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "edf1e5f7-d747-494d-8a0f-559b3670d4a4"
          },
          {
            "id": "bd466a22-5a56-434b-9f4a-d6a83c26530c",
            "name": "Blog Section",
            "description": "Set up blog functionality:\n- MDX integration\n- Blog list page\n- Article template\n- Code syntax highlighting",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "edf1e5f7-d747-494d-8a0f-559b3670d4a4"
          }
        ],
        "metadata": {
          "created": "2024-12-16T10:47:53.916Z",
          "updated": "2024-12-16T10:47:53.916Z",
          "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
        },
        "parentId": "8b4f40b2-1941-46c6-bc9f-b68d1c1b4aa2"
      },
      {
        "id": "eaf454d2-48e1-4b4b-94ce-9c3e60ed1ed8",
        "name": "Performance Optimization",
        "description": "Optimize website performance and accessibility",
        "type": "group",
        "status": "pending",
        "dependencies": [],
        "subtasks": [
          {
            "id": "c645be45-3cf2-4cd2-8117-60a66d90f186",
            "name": "Image Optimization",
            "description": "Implement image optimization:\n- Next.js Image component\n- Responsive images\n- Lazy loading\n- WebP format",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "eaf454d2-48e1-4b4b-94ce-9c3e60ed1ed8"
          },
          {
            "id": "b1d0c9a1-be60-4776-ae77-835197c84110",
            "name": "SEO Setup",
            "description": "Configure SEO:\n- Meta tags\n- Open Graph\n- Sitemap\n- Robots.txt",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "eaf454d2-48e1-4b4b-94ce-9c3e60ed1ed8"
          },
          {
            "id": "7f102e4a-8016-43ef-93e7-3123d9f774e8",
            "name": "Accessibility Improvements",
            "description": "Ensure WCAG compliance:\n- Semantic HTML\n- ARIA labels\n- Keyboard navigation\n- Color contrast",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "eaf454d2-48e1-4b4b-94ce-9c3e60ed1ed8"
          }
        ],
        "metadata": {
          "created": "2024-12-16T10:47:53.916Z",
          "updated": "2024-12-16T10:47:53.916Z",
          "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
        },
        "parentId": "8b4f40b2-1941-46c6-bc9f-b68d1c1b4aa2"
      },
      {
        "id": "89479531-17de-4964-b702-f3c0fb181417",
        "name": "Testing and Deployment",
        "description": "Test and deploy the website",
        "type": "group",
        "status": "pending",
        "dependencies": [],
        "subtasks": [
          {
            "id": "16f68998-a367-48d5-9440-213ceb86f6d3",
            "name": "Testing Implementation",
            "description": "Set up and write tests:\n- Unit tests\n- Integration tests\n- E2E tests\n- Accessibility tests",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "89479531-17de-4964-b702-f3c0fb181417"
          },
          {
            "id": "afb28769-f67a-4fef-9bc8-2d06490cb449",
            "name": "Deployment Setup",
            "description": "Configure deployment:\n- Vercel setup\n- CI/CD pipeline\n- Environment variables\n- Domain configuration",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "89479531-17de-4964-b702-f3c0fb181417"
          },
          {
            "id": "a587eca0-f28a-4ca3-8b22-751301e9243a",
            "name": "Documentation",
            "description": "Create documentation:\n- Setup instructions\n- Content management guide\n- Deployment process\n- Maintenance guidelines",
            "type": "task",
            "status": "pending",
            "dependencies": [],
            "subtasks": [],
            "metadata": {
              "created": "2024-12-16T10:47:53.916Z",
              "updated": "2024-12-16T10:47:53.916Z",
              "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
            },
            "parentId": "89479531-17de-4964-b702-f3c0fb181417"
          }
        ],
        "metadata": {
          "created": "2024-12-16T10:47:53.916Z",
          "updated": "2024-12-16T10:47:53.916Z",
          "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79"
        },
        "parentId": "8b4f40b2-1941-46c6-bc9f-b68d1c1b4aa2"
      }
    ],
    "metadata": {
      "created": "2024-12-16T10:47:53.915Z",
      "updated": "2024-12-16T10:47:53.915Z",
      "sessionId": "4bcc6aad-b123-416d-a71c-58b3788cca79",
      "context": "Web development project for creating a personal portfolio",
      "tags": [
        "web-development",
        "portfolio",
        "frontend",
        "ui-ux"
      ]
    },
    "parentId": "ROOT-4bcc6aad-b123-416d-a71c-58b3788cca79"
  }
]

</details>

Tools

Task Management

create_task

Creates a new task with optional subtasks.

{
  "parentId": string | null,  // Parent task ID or null for root tasks
  "name": string,            // Task name (required)
  "description": string,     // Task description
  "notes": Note[],          // Rich content notes
  "reasoning": {            // Task reasoning documentation
    "approach": string,     // Implementation strategy
    "assumptions": string[],// Key assumptions
    "alternatives": string[],// Other approaches considered
    "risks": string[],      // Potential issues
    "tradeoffs": string[], // Key decisions and implications
    "constraints": string[],// Technical/business limitations
    "dependencies_rationale": string[], // Dependency reasoning
    "impact_analysis": string[] // System impact analysis
  },
  "type": "task" | "milestone" | "group",
  "dependencies": string[], // Task IDs this task depends on
  "metadata": {             // Additional task metadata
    "context": string,
    "tags": string[]
  }
}

bulk_create_tasks

Creates multiple tasks efficiently in a single operation. Supports:

Batch creation under a common parent
Automatic dependency validation
Status propagation
Transaction handling for consistency

{
  "parentId": string | null,  // Parent task ID or null for root tasks
  "tasks": Array<{
    name: string,            // Task name (required)
    description?: string,    // Task description
    notes?: Note[],         // Rich content notes
    reasoning?: TaskReasoning, // Decision documentation
    type?: TaskType,        // task, milestone, or group
    dependencies?: string[], // Task dependencies
    metadata?: {            // Additional context
      context?: string,
      tags?: string[]
    },
    subtasks?: CreateTaskInput[] // Nested tasks
  }>
}

update_task

Updates an existing task with automatic status propagation and validation:

Validates status transitions
Updates dependent tasks
Maintains task hierarchy
Preserves task history

{
  "taskId": string,         // Task ID to update
  "updates": {
    "name"?: string,        // New task name
    "description"?: string, // New description
    "notes"?: Note[],      // Updated notes
    "reasoning"?: TaskReasoning, // Updated reasoning
    "type"?: TaskType,     // New task type
    "status"?: TaskStatus, // New status
    "dependencies"?: string[], // Updated dependencies
    "metadata"?: {         // Updated metadata
      "context"?: string,
      "tags"?: string[]
    }
  }
}

delete_task

Safely removes a task and its subtasks:

Recursive deletion of subtasks
Dependency cleanup
Status propagation
Reference removal
Transaction handling

Task Retrieval

get_task

Retrieves a task by ID with full context:

Complete task details
Status information
Dependency data
Metadata and history
Error context if applicable

get_subtasks

Lists all subtasks of a specified task:

Direct child tasks
Status information
Dependency relationships
Metadata and context
Hierarchical structure

get_task_tree

Retrieves the complete task hierarchy:

Full task tree structure
Status aggregation
Dependency mapping
Metadata inheritance
Performance optimized

get_tasks_by_status

Filters tasks by their current status:

Status-based filtering
Optional parent filtering
Dependency context
Metadata inclusion
Performance optimized

System Features

Rate Limiting

600 requests per minute limit
Automatic request throttling
Queue management
Error handling
Client feedback

Health Monitoring

System health checks
Resource monitoring
Error tracking
Performance metrics
Status reporting

Request Tracing

Request lifecycle tracking
Performance monitoring
Error context capture
Debug information
Audit logging

Error Handling

ATLAS provides comprehensive error handling:

Validation errors with context
Dependency conflict detection
Task state inconsistencies
System resource issues
Transaction failures
Rate limit violations
Request timeout handling

Best Practices

Task Management

Create parent tasks before subtasks
Use task IDs for dependencies
Provide clear context in metadata
Use appropriate task types
Document reasoning and assumptions
Handle status transitions carefully
Monitor dependency relationships
Maintain task hierarchy

Content Organization

Use appropriate note types
Include relevant code samples
Maintain clear documentation
Document decision-making process
Keep metadata current
Tag tasks appropriately
Structure hierarchies logically

Performance Optimization

Use bulk operations for multiple tasks
Monitor rate limits
Handle long-running operations
Implement proper error handling
Optimize task retrieval
Cache frequently accessed data
Clean up completed tasks

Error Recovery

Handle validation errors gracefully
Resolve dependency conflicts
Manage status inconsistencies
Recover from system issues
Maintain data integrity
Document error contexts
Implement retry strategies

Development

# Build the project
npm run build

# Watch for changes
npm run watch

# Run MCP inspector
npm run inspector

# Run tests
npm test

# Check types
npm run type-check

Up Next

Enhanced Task Management

Task scheduling with time-based triggers
Recurring task support
Task templates and presets
Advanced filtering and search
Custom task types
Task archiving

System Improvements

Enhanced performance monitoring
Advanced caching strategies
Improved error recovery
Better dependency management
Transaction optimizations
Resource usage tracking

Integration Features

Webhook support
External system integration
Event streaming
Custom tool support
Plugin architecture
API versioning

Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Create a Pull Request

For bugs and feature requests, please create an issue.

License

Apache License 2.0

<div align="center"> Built with the Model Context Protocol </div>

GitHub Badge

Glama performs regular codebase and documentation scans to:

Confirm that the MCP server is working as expected.
Confirm that there are no obvious security issues with dependencies of the server.
Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

<a href="https://glama.ai/mcp/servers/b8veo1exod">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/b8veo1exod/badge" />
</a>

Prompts

Resources

Tools

Server Configuration

ATLAS MCP Server

Table of Contents

Overview

Model Context Protocol Server

Core Components

Features

Task Organization

Content Support

System Features

Performance

Installation

Setup Steps

Configuration

Environment Variables

Task Structure

Example Task List (Without reasoning)

Tools

Task Management

create_task

bulk_create_tasks

update_task

delete_task

Task Retrieval

get_task

get_subtasks

get_task_tree

get_tasks_by_status

System Features

Rate Limiting

Health Monitoring

Request Tracing

Error Handling

Best Practices

Task Management

Content Organization

Performance Optimization

Error Recovery

Development

Up Next

Enhanced Task Management

System Improvements

Integration Features

Contributing

License

GitHub Badge

Alternative MCP servers

jira-mcp-server

mcp-notion-server

notion_mcp

servers