get_person
Retrieve detailed contact information from Simplicate CRM using a person ID to access specific individual records and business data.
Instructions
Get specific person by ID
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| person_id | Yes |
Input Schema (JSON Schema)
{
"properties": {
"person_id": {
"type": "string"
}
},
"required": [
"person_id"
],
"type": "object"
}
Implementation Reference
- src/mcp/server.ts:116-129 (registration)Registration of the 'get_person' tool in ListToolsRequestHandler, including name, description, and input schema requiring 'person_id'.{ name: 'get_person', description: 'Get details of a specific person by ID', inputSchema: { type: 'object', properties: { person_id: { type: 'string', description: 'The ID of the person to retrieve', }, }, required: ['person_id'], }, },
- src/mcp/server.ts:272-287 (handler)MCP tool handler for 'get_person': validates input, calls SimplicateService.getPersonById, returns JSON response.case 'get_person': { if (!toolArgs.person_id) { throw new Error('person_id is required'); } const person = await this.simplicateService.getPersonById( toolArgs.person_id as string ); return { content: [ { type: 'text', text: JSON.stringify(person, null, 2), }, ], }; }
- src/simplicate/services.ts:107-110 (helper)Core helper function getPersonById that performs API GET request to Simplicate /crm/person/{personId}.async getPersonById(personId: string): Promise<SimplicatePerson> { const response = await this.client.get(`/crm/person/${personId}`); return response.data; }
- src/simplicate/services.ts:32-42 (schema)TypeScript interface defining the structure of a SimplicatePerson object returned by the tool.export interface SimplicatePerson { id: string; first_name: string; family_name: string; email?: string; phone?: string; organization?: { id: string; name: string; }; }