Simplicate MCP Server

Instructions

Implementation Reference

• src/mcp/server-full.ts:467-470 (handler)

  MCP tool handler for 'create_person': delegates to simplicateService.createPerson with tool arguments and returns JSON stringified result.

  case 'create_person': {
    const data = await this.simplicateService.createPerson(toolArgs);
    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
  }

• src/simplicate/services-extended.ts:41-48 (schema)

  Type definition for SimplicatePerson used in createPerson method.

  export interface SimplicatePerson {
    id: string;
    first_name: string;
    family_name: string;
    email?: string;
    phone?: string;
    organization?: { id: string; name: string };
  }

• src/mcp/server-full.ts:190-203 (registration)

  Registers the 'create_person' tool in ListToolsRequestHandler with description and input schema.

  {
    name: 'create_person',
    description: 'Create a new contact person',
    inputSchema: {
      type: 'object',
      properties: {
        first_name: { type: 'string' },
        family_name: { type: 'string' },
        email: { type: 'string' },
        organization_id: { type: 'string' },
      },
      required: ['first_name', 'family_name'],
    },
  },

• src/simplicate/services-extended.ts:309-312 (helper)

  Core implementation of createPerson: sends POST request to Simplicate CRM /person endpoint.

  async createPerson(data: Partial<SimplicatePerson>): Promise<SimplicatePerson> {
    const response = await this.client.post('/crm/person', data);
    return response.data;
  }