GetRecordsByIds
Retrieve multiple database records simultaneously by specifying their unique IDs. This tool enables efficient batch data access from RushDB's graph database.
Instructions
Get multiple records by their IDs
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recordIds | Yes | Array of record IDs to retrieve |
Implementation Reference
- tools/GetRecordsByIds.ts:19-31 (handler)The core handler function implementing the tool logic: validates recordIds array, fetches records using db.records.findById, maps and returns data with count.
export async function GetRecordsByIds(params: { recordIds: string[] }) { const { recordIds } = params if (!Array.isArray(recordIds) || recordIds.length === 0) { return { success: false, message: 'recordIds must be a non-empty array', data: [] } } const result = await db.records.findById(recordIds) return { success: true, count: result.data.length, data: result.data.map((r: any) => r.data) } } - tools.ts:168-182 (registration)Registers the GetRecordsByIds tool in the MCP server's tools list, including its description and input schema for validation.
{ name: 'GetRecordsByIds', description: 'Get multiple records by their IDs', inputSchema: { type: 'object', properties: { recordIds: { type: 'array', items: { type: 'string' }, description: 'Array of record IDs to retrieve' } }, required: ['recordIds'] } }, - index.ts:443-452 (helper)Helper code in the main CallToolRequestSchema handler that invokes the GetRecordsByIds function and formats the MCP response.
case 'GetRecordsByIds': const recordsByIds = await GetRecordsByIds({ recordIds: args.recordIds as string[] }) return { content: [ { type: 'text', text: recordsByIds.count > 0 ? JSON.stringify(recordsByIds.data, null, 2) : 'No records found' } ] }