FluentCRM MCP Server

Instructions

Implementation Reference

• src/fluentcrm-mcp-server.ts:945-946 (handler)

  MCP tool handler case that executes the tool by calling FluentCRMClient.listContacts with input args and returns JSON response.

  case 'fluentcrm_list_contacts':
    return { content: [{ type: 'text', text: JSON.stringify(await client.listContacts(args || {}), null, 2) }] };

• src/fluentcrm-mcp-server.ts:491-498 (schema)

  Input schema defining optional parameters: page, per_page, search for listing contacts.

  inputSchema: {
    type: 'object',
    properties: {
      page: { type: 'number', description: 'Numer strony (default: 1)' },
      per_page: { type: 'number', description: 'Ilość rekordów na stronę (default: 10)' },
      search: { type: 'string', description: 'Szukaj po emailu/imieniu' },
    },
  },

• src/fluentcrm-mcp-server.ts:488-499 (registration)

  Tool registration in ListTools response, including name, description, and input schema.

  {
    name: 'fluentcrm_list_contacts',
    description: 'Pobiera listę wszystkich kontaktów z FluentCRM',
    inputSchema: {
      type: 'object',
      properties: {
        page: { type: 'number', description: 'Numer strony (default: 1)' },
        per_page: { type: 'number', description: 'Ilość rekordów na stronę (default: 10)' },
        search: { type: 'string', description: 'Szukaj po emailu/imieniu' },
      },
    },
  },

• src/fluentcrm-mcp-server.ts:54-57 (helper)

  Core implementation: Calls FluentCRM REST API /subscribers endpoint with params and returns the data.

  async listContacts(params: any = {}) {
    const response = await this.apiClient.get('/subscribers', { params });
    return response.data;
  }