get_projects_by_realm
Filter and retrieve projects in the addTaskManager MCP Server based on specified realms—Assess, Decide, or Do—to streamline task and project management within the ADD framework.
Instructions
Filter projects by realm.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| realm | Yes | Realm to query (maps to realmId 1, 2, or 3) |
Implementation Reference
- src/services/CloudKitService.ts:413-422 (handler)Core handler function in CloudKitService that executes the CloudKit query to fetch projects filtered by the given realmId. This is the primary implementation logic used in production by other tools.async getProjectsByRealm(realmId: number): Promise<ZenTaskticProject[]> { return this.queryRecords<ZenTaskticProject>('Projects', { filterBy: [{ fieldName: 'realmId', fieldValue: realmId, comparator: 'EQUALS' }], sortBy: [{ fieldName: 'lastModified', ascending: false }] }); }
- src/index.ts:558-568 (registration)MCP tool registration defining the tool name, description, and input schema (realm string mapped to realmId).{ name: 'get_projects_by_realm', description: 'Filter projects by realm.', inputSchema: { type: 'object', properties: { realm: { type: 'string', enum: ['assess', 'decide', 'do'], description: 'Realm to query (maps to realmId 1, 2, or 3)' } }, required: ['realm'] } },
- src/index.ts:561-567 (schema)Input schema validation for the tool: requires 'realm' as string enum ['assess','decide','do'].inputSchema: { type: 'object', properties: { realm: { type: 'string', enum: ['assess', 'decide', 'do'], description: 'Realm to query (maps to realmId 1, 2, or 3)' } }, required: ['realm'] }
- src/index.ts:744-746 (handler)Tool dispatch handler in MCP server switch statement: validates args and delegates to internal getProjectsByRealm method (mock implementation).this.validateArgs(args, ['realm']); return await this.getProjectsByRealm(args.realm as RealmString); case 'get_ideas':
- src/index.ts:1452-1456 (helper)Mock implementation of getProjectsByRealm used in development/non-production mode, returns sample project data formatted as MCP response.private async getProjectsByRealm(realm: RealmString) { const realmId = realmStringToId(realm); const mockProjects = [{ recordName: 'project_456', projectName: 'Sample Project X', realmId }]; return { content: [{ type: 'text', text: `Projects in ${realm} realm (ID: ${realmId}):\n${mockProjects.map(p => `- ${p.projectName} (${p.recordName})`).join('\n')}` }] }; }