Planning System MCP Server

Instructions

Implementation Reference

• src/tools.js:718-752 (handler)

  Handler function that processes batch artifact requests by fetching each artifact and its content using apiClient, collecting successes and errors, and returning formatted response.

  if (name === "batch_get_artifacts") {
    const { plan_id, artifact_requests } = args;
    
    const results = [];
    const errors = [];
    
    for (const request of artifact_requests) {
      const { node_id, artifact_id } = request;
      try {
        const artifact = await apiClient.artifacts.getArtifact(plan_id, node_id, artifact_id);
        const content = await apiClient.artifacts.getArtifactContent(plan_id, node_id, artifact_id);
        results.push({
          node_id,
          artifact_id,
          success: true,
          data: { ...artifact, content }
        });
      } catch (error) {
        errors.push({
          node_id,
          artifact_id,
          success: false,
          error: error.message
        });
      }
    }
    
    return formatResponse({
      total: artifact_requests.length,
      successful: results.length,
      failed: errors.length,
      results,
      errors
    });
  }

• src/tools.js:376-398 (schema)

  Tool schema definition including name, description, and input schema for batch_get_artifacts, used in tool registration.

  {
    name: "batch_get_artifacts",
    description: "Get multiple artifacts at once",
    inputSchema: {
      type: "object",
      properties: {
        plan_id: { type: "string", description: "Plan ID" },
        artifact_requests: {
          type: "array",
          description: "List of artifact requests",
          items: {
            type: "object",
            properties: {
              node_id: { type: "string", description: "Node ID" },
              artifact_id: { type: "string", description: "Artifact ID" }
            },
            required: ["node_id", "artifact_id"]
          }
        }
      },
      required: ["plan_id", "artifact_requests"]
    }
  },