list_providers
Find healthcare providers in your practice by name or specialty to support clinical workflows and patient care coordination.
Instructions
List all healthcare providers in the practice
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results | |
| name | No | Filter by provider name | |
| specialty | No | Filter by specialty |
Implementation Reference
- src/handlers/tool-handlers.ts:334-360 (handler)The MCP tool handler function that executes the list_providers tool. It calls the AthenaHealthClient.getProviders method with the input arguments and returns the formatted JSON response or error message.async handleListProviders(args: any) { try { const providers = await this.client.getProviders(args); return { content: [ { type: 'text' as const, text: JSON.stringify(providers, null, 2), }, ], }; } catch (error: any) { return { content: [ { type: 'text' as const, text: JSON.stringify({ error: 'Failed to list providers', message: error.message || 'Unknown error occurred', details: error.details || error.message, }, null, 2), }, ], }; } }
- src/definitions/tools.ts:114-125 (schema)The input schema definition for the list_providers tool, specifying optional parameters like limit, name, and specialty.name: 'list_providers', description: 'List all healthcare providers in the practice', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Maximum number of results', default: 50 }, name: { type: 'string', description: 'Filter by provider name' }, specialty: { type: 'string', description: 'Filter by specialty' }, }, required: [], }, },
- src/mcp-server.ts:197-198 (registration)Tool call registration in the MCP server that routes 'list_providers' calls to the ToolHandlers.handleListProviders method.case 'list_providers': return await this.toolHandlers.handleListProviders(args);
- Core helper function in SchedulingService that performs the actual HTTP GET request to the Athenahealth API /providers endpoint, handles various response formats, and returns the list of providers.async getProviders(params?: { limit?: number; offset?: number; name?: string; specialty?: string; }): Promise<Provider[]> { try { const response = await this.makeRequest<any>( `${this.config.practice_id}/providers`, { method: 'GET', params, } ); console.error('Providers response:', JSON.stringify(response, null, 2)); if (response.providers && Array.isArray(response.providers)) { return response.providers; } if (Array.isArray(response)) { return response; } if (response.data && Array.isArray(response.data)) { return response.data; } console.error('Unexpected providers response structure, returning empty array'); return []; } catch (error: any) { console.error('Get providers error:', error.message); throw error; } }