get_project_status

Check a Trace MCP project's configuration, cache state, and validation results to monitor schema consistency between data producers and consumers.

Instructions

Get the status of a trace project including config, cache state, and last validation result.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`projectDir`	Yes	Root directory with .trace-mcp config

Implementation Reference

src/index.ts:693-740 (handler)

Main execution logic for the get_project_status tool. Parses input, loads the TraceProject, checks if it exists, retrieves configuration and watcher status, and returns a detailed JSON status report.

case 'get_project_status': {
  const input = GetProjectStatusInput.parse(args);
  log(`Getting project status for: ${input.projectDir}`);
  
  const project = loadProject(input.projectDir);
  
  if (!project.exists()) {
    return {
      content: [{
        type: 'text',
        text: JSON.stringify({
          success: false,
          exists: false,
          error: `No trace project found at ${input.projectDir}`,
        }, null, 2),
      }],
    };
  }
  
  const config = project.config;
  const activeWatchers = listActiveWatchers();
  const isWatching = activeWatchers.includes(project.rootDir);
  
  let watcherStatus = null;
  if (isWatching) {
    const watcher = getWatcher(project);
    watcherStatus = watcher.getStatus();
  }
  
  return {
    content: [{
      type: 'text',
      text: JSON.stringify({
        success: true,
        exists: true,
        projectDir: project.rootDir,
        traceDir: project.traceDir,
        config,
        isWatching,
        watcherStatus,
        paths: {
          producer: project.producerPath,
          consumer: project.consumerPath,
        },
      }, null, 2),
    }],
  };
}

src/index.ts:109-111 (schema)
Zod schema for validating the input to the get_project_status tool, requiring a projectDir string.
```
const GetProjectStatusInput = z.object({
  projectDir: z.string().describe('Root directory with .trace-mcp config'),
});
```

src/index.ts:265-274 (registration)

Registration of the get_project_status tool in the ListTools response, defining its name, description, and input schema.

  name: 'get_project_status',
  description: 'Get the status of a trace project including config, cache state, and last validation result.',
  inputSchema: {
    type: 'object',
    properties: {
      projectDir: { type: 'string', description: 'Root directory with .trace-mcp config' },
    },
    required: ['projectDir'],
  },
},

Trace MCP