Tally MCP

Instructions

Implementation Reference

• src/server.ts:1629-1648 (handler)

  The main handler logic for the 'manage_workspace' tool in the _handleToolsCall method. It handles the 'get_info' action by calling listWorkspaces on the WorkspaceManagementTool instance and returns the result as text. Other actions return a placeholder message.
  case 'manage_workspace': if (args && args.action === 'get_info') { const workspaceInfo = await this.tools.workspaceManagement.listWorkspaces(); return { content: [ { type: 'text', text: JSON.stringify(workspaceInfo, null, 2) } ] }; } return { content: [ { type: 'text', text: 'Workspace management functionality is being implemented' } ] };
• src/server.ts:1512-1532 (schema)

  JSON Schema definition for the 'manage_workspace' tool input, including supported actions: get_info, update_settings, list_members.
  name: 'manage_workspace', description: 'Manage workspace settings and information', inputSchema: { type: 'object', properties: { action: { type: 'string', enum: ['get_info', 'update_settings', 'list_members'], description: 'Action to perform on the workspace' }, settings: { type: 'object', properties: { name: { type: 'string', description: 'Workspace name' }, description: { type: 'string', description: 'Workspace description' } } } }, required: ['action'] } },
• src/server.ts:1732-1734 (registration)

  Registration of the generic tool call handler via MCP SDK's setRequestHandler for CallToolRequestSchema, which routes to _handleToolsCall containing the manage_workspace case.
  this.setRequestHandler(CallToolRequestSchema, async (request) => { return this._handleToolsCall(request); });
• src/tools/workspace-tool.ts:5-31 (helper)

  WorkspaceManagementTool class providing workspace operations, used by the manage_workspace handler. The listWorkspaces method is called for 'get_info' action.
  export class WorkspaceManagementTool { private workspaceService: WorkspaceService; constructor(apiClientConfig: TallyApiClientConfig = {}) { this.workspaceService = new WorkspaceService(apiClientConfig); } public async listWorkspaces(options: { page?: number; limit?: number } = {}): Promise<TallyWorkspacesResponse> { return this.workspaceService.getWorkspaces(options); } public async getWorkspaceDetails(workspaceId: string): Promise<TallyWorkspace> { return this.workspaceService.getWorkspace(workspaceId); } public async inviteUserToWorkspace(workspaceId: string, email: string, role: UserRole): Promise<any> { return this.workspaceService.inviteUser(workspaceId, email, role); } public async removeUserFromWorkspace(workspaceId: string, userId: string): Promise<any> { return this.workspaceService.removeUser(workspaceId, userId); } public async updateUserRoleInWorkspace(workspaceId: string, userId: string, role: UserRole): Promise<any> { return this.workspaceService.updateUserRole(workspaceId, userId, role); } }
• src/services/workspace-service.ts:4-30 (helper)

  WorkspaceService class that delegates workspace operations to TallyApiClient, used by WorkspaceManagementTool.
  export class WorkspaceService { private apiClient: TallyApiClient; constructor(config: TallyApiClientConfig = {}) { this.apiClient = new TallyApiClient(config); } public async getWorkspaces(options: { page?: number; limit?: number } = {}): Promise<TallyWorkspacesResponse> { return this.apiClient.getWorkspaces(options); } public async getWorkspace(workspaceId: string): Promise<TallyWorkspace> { return this.apiClient.getWorkspace(workspaceId); } public async inviteUser(workspaceId: string, email: string, role: UserRole): Promise<any> { return this.apiClient.inviteUserToWorkspace(workspaceId, email, role); } public async removeUser(workspaceId: string, userId: string): Promise<any> { return this.apiClient.removeUserFromWorkspace(workspaceId, userId); } public async updateUserRole(workspaceId: string, userId: string, role: UserRole): Promise<any> { return this.apiClient.updateUserRole(workspaceId, userId, role); } }