@bldbl/mcp

Implementation Reference

• src/cli.ts:41-55 (handler)

  The MCP tool handler and registration for 'get_next_task'. It checks client connection, calls client.getNextTask(), and returns the result as a text content block with JSON stringification.

  this.server.tool('get_next_task', {}, async () => {
    if (!this.client) {
      throw new Error('Not connected to Buildable API');
    }
  
    const nextTask = await this.client.getNextTask();
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(nextTask, null, 2),
        },
      ],
    };
  });

• src/client.ts:97-117 (helper)

  Helper method in BuildableMCPClient that performs the actual API request to retrieve the next task from the Buildable backend.

  async getNextTask(): Promise<NextTaskResponse> {
    this.log('debug', 'Getting next recommended task...');
  
    try {
      const response = await this.makeRequest<NextTaskResponse>(
        'GET',
        `/projects/${this.config.projectId}/next-task`
      );
  
      if (response.data?.task) {
        this.log('info', `Next task: "${response.data.task.title}"`);
      } else {
        this.log('info', 'No tasks available:', response.data?.message);
      }
  
      return response.data!;
    } catch (error) {
      this.log('error', 'Failed to get next task:', error);
      throw error;
    }
  }

• src/types.ts:66-76 (schema)

  Type definition for the NextTaskResponse returned by the getNextTask method, defining the structure of the tool's output.

  export interface NextTaskResponse {
    success: boolean;
    task?: TaskSummary;
    message: string;
    context?: {
      phase: string;
      dependencies_met: boolean;
      recommended_approach: string;
      related_files: string[];
    };
  }

• src/types.ts:43-64 (schema)

  Type definition for TaskSummary, which is the core task object contained within NextTaskResponse.

  export interface TaskSummary {
    id: string;
    title: string;
    description: string;
    status: 'pending' | 'in_progress' | 'completed';
    phase: string;
    difficulty: 'easy' | 'medium' | 'hard';
    estimated_hours: number;
    technologies: string[];
    dependencies: string[];
    files_to_modify: string[];
    acceptance_criteria: string[];
  
    // AI Execution Fields for Autonomous Task Execution
    context_summary?: string; // 1-3 sentence scope for agent context
    commands?: string[]; // Shell commands for lint, tests, build
    reference_impl?: string; // Pseudocode/snippet for expected structure
    rollback_plan?: string; // How to revert if task fails
    success_checks?: string[]; // Machine-checkable assertions
    estimated_tokens?: number; // Prompt-size hint for scheduling
    skill_tags?: string[]; // Agent skill-based routing tags
  }