FluentCRM MCP Server

Instructions

Implementation Reference

• src/fluentcrm-mcp-server.ts:343-357 (handler)

  Core implementation of the tool logic: calls FluentCRM API to retrieve smart link details by ID, handles 404 gracefully since the endpoint may not exist yet.

  async getSmartLink(smartLinkId: number) {
    try {
      const response = await this.apiClient.get(`/smart-links/${smartLinkId}`);
      return response.data;
    } catch (error: any) {
      if (error.response?.status === 404) {
        return {
          success: false,
          message: "Smart Links API endpoint not available yet in FluentCRM",
          suggestion: "Use FluentCRM admin panel to view Smart Link details"
        };
      }
      throw error;
    }
  }

• src/fluentcrm-mcp-server.ts:830-840 (registration)

  Tool registration in MCP server's listTools handler, defining name, description, and input schema.

  {
    name: 'fluentcrm_get_smart_link',
    description: 'Pobiera szczegóły konkretnego Smart Link',
    inputSchema: {
      type: 'object',
      properties: {
        smartLinkId: { type: 'number', description: 'ID Smart Link' },
      },
      required: ['smartLinkId'],
    },
  },

• src/fluentcrm-mcp-server.ts:833-839 (schema)

  Input schema validation: requires smartLinkId as number.

  inputSchema: {
    type: 'object',
    properties: {
      smartLinkId: { type: 'number', description: 'ID Smart Link' },
    },
    required: ['smartLinkId'],
  },

• src/fluentcrm-mcp-server.ts:1007-1008 (handler)

  MCP server request handler switch case that invokes the tool implementation with the provided smartLinkId argument.

  case 'fluentcrm_get_smart_link':
    return { content: [{ type: 'text', text: JSON.stringify(await client.getSmartLink((args as any)?.smartLinkId), null, 2) }] };