Simplicate MCP Server

Instructions

Implementation Reference

• src/mcp/server.ts:240-255 (handler)

  MCP tool handler for 'get_organization': validates input, calls SimplicateService.getOrganizationById, and returns JSON response.

  case 'get_organization': {
    if (!toolArgs.organization_id) {
      throw new Error('organization_id is required');
    }
    const organization = await this.simplicateService.getOrganizationById(
      toolArgs.organization_id as string
    );
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(organization, null, 2),
        },
      ],
    };
  }

• src/mcp/server.ts:85-98 (schema)

  Tool registration including name, description, and input schema requiring 'organization_id'.

  {
    name: 'get_organization',
    description: 'Get details of a specific organization by ID',
    inputSchema: {
      type: 'object',
      properties: {
        organization_id: {
          type: 'string',
          description: 'The ID of the organization to retrieve',
        },
      },
      required: ['organization_id'],
    },
  },

• src/simplicate/services.ts:96-99 (helper)

  Core implementation fetches organization data from Simplicate API endpoint `/crm/organization/{id}`.

  async getOrganizationById(organizationId: string): Promise<SimplicateOrganization> {
    const response = await this.client.get(`/crm/organization/${organizationId}`);
    return response.data;
  }

• src/simplicate/services.ts:22-30 (schema)

  TypeScript interface defining the structure of an organization object.

  export interface SimplicateOrganization {
    id: string;
    name: string;
    coc_code?: string;
    email?: string;
    phone?: string;
    website?: string;
    relation_type?: string;
  }