Simplicate MCP Server

Instructions

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;
    };
  }