feat(forestadmin-client): add MCP server configuration service

Add service to fetch MCP server configurations from Forest Admin API.

- New McpServerConfigService for fetching MCP server configs
- Add getMcpServerConfigs endpoint to ForestHttpApi
- Integrate service into ForestAdminClient

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: alban bertolini

packages/agent/test/__factories__/forest-admin-client.ts

@@ -43,6 +43,9 @@ const forestAdminClientFactory = ForestAdminClientFactory.define(() => ({
   modelCustomizationService: {
     getConfiguration: jest.fn(),
   },
+  mcpServerConfigService: {
+    getConfiguration: jest.fn(),
+  },
   subscribeToServerEvents: jest.fn(),
   close: jest.fn(),
   onRefreshCustomizations: jest.fn(),

packages/forestadmin-client/package.json

@@ -31,6 +31,7 @@
     "test": "jest"
   },
   "devDependencies": {
+    "@forestadmin/ai-proxy": "0.1.0",
     "@forestadmin/datasource-toolkit": "1.50.0",
     "@types/json-api-serializer": "^2.6.3",
     "@types/jsonwebtoken": "^9.0.1",

packages/forestadmin-client/src/build-application-services.ts

@@ -3,6 +3,7 @@ import EventsSubscriptionService from './events-subscription';
 import NativeRefreshEventsHandlerService from './events-subscription/native-refresh-events-handler-service';
 import { RefreshEventsHandlerService } from './events-subscription/types';
 import IpWhiteListService from './ip-whitelist';
+import McpServerConfigFromApiService, { McpServerConfigService } from './mcp-server-config';
 import ModelCustomizationFromApiService from './model-customizations/model-customization-from-api';
 import { ModelCustomizationService } from './model-customizations/types';
 import ActionPermissionService from './permissions/action-permission';
@@ -32,6 +33,7 @@ export default function buildApplicationServices(
   chartHandler: ChartHandler;
   auth: ForestAdminAuthServiceInterface;
   modelCustomizationService: ModelCustomizationService;
+  mcpServerConfigService: McpServerConfigService;
   eventsSubscription: EventsSubscriptionService;
   eventsHandler: RefreshEventsHandlerService;
 } {
@@ -87,5 +89,9 @@ export default function buildApplicationServices(
       forestAdminServerInterface,
       optionsWithDefaults,
     ),
+    mcpServerConfigService: new McpServerConfigFromApiService(
+      forestAdminServerInterface,
+      optionsWithDefaults,
+    ),
   };
 }

packages/forestadmin-client/src/forest-admin-client-with-cache.ts

@@ -5,6 +5,7 @@ import {
 } from './events-subscription/types';
 import IpWhiteListService from './ip-whitelist';
 import { IpWhitelistConfiguration } from './ip-whitelist/types';
+import { McpServerConfigService } from './mcp-server-config';
 import { ModelCustomizationService } from './model-customizations/types';
 import RenderingPermissionService from './permissions/rendering-permission';
 import { RawTree } from './permissions/types';
@@ -30,6 +31,7 @@ export default class ForestAdminClientWithCache implements ForestAdminClient {
     protected readonly schemaService: SchemaService,
     public readonly authService: ForestAdminAuthServiceInterface,
     public readonly modelCustomizationService: ModelCustomizationService,
+    public readonly mcpServerConfigService: McpServerConfigService,
     protected readonly eventsSubscription: BaseEventsSubscriptionService,
     protected readonly eventsHandler: RefreshEventsHandlerService,
   ) {}

packages/forestadmin-client/src/index.ts

@@ -43,6 +43,7 @@ export default function createForestAdminClient(
     schema,
     auth,
     modelCustomizationService,
+    mcpServerConfigService,
     eventsSubscription,
     eventsHandler,
   } = buildApplicationServices(new ForestHttpApi(), options);
@@ -57,6 +58,7 @@ export default function createForestAdminClient(
     schema,
     auth,
     modelCustomizationService,
+    mcpServerConfigService,
     eventsSubscription,
     eventsHandler,
   );

packages/forestadmin-client/src/mcp-server-config/index.ts

@@ -0,0 +1,17 @@
+import type { McpConfiguration } from '@forestadmin/ai-proxy';
+
+import { McpServerConfigService } from './types';
+import { ForestAdminClientOptionsWithDefaults, ForestAdminServerInterface } from '../types';
+
+export default class McpServerConfigFromApiService implements McpServerConfigService {
+  constructor(
+    private readonly forestadminServerInterface: ForestAdminServerInterface,
+    private readonly options: ForestAdminClientOptionsWithDefaults,
+  ) {}
+
+  async getConfiguration(): Promise<McpConfiguration> {
+    return this.forestadminServerInterface.getMcpServerConfigs(this.options);
+  }
+}
+
+export { McpServerConfigService } from './types';

packages/forestadmin-client/src/mcp-server-config/types.ts

@@ -0,0 +1,5 @@
+import type { McpConfiguration } from '@forestadmin/ai-proxy';
+
+export interface McpServerConfigService {
+  getConfiguration(): Promise<McpConfiguration>;
+}

packages/forestadmin-client/src/permissions/forest-http-api.ts

@@ -1,3 +1,5 @@
+import type { McpConfiguration } from '@forestadmin/ai-proxy';
+
 import { EnvironmentPermissionsV4, RenderingPermissionV4, UserPermissionV4 } from './types';
 import AuthService from '../auth';
 import { ModelCustomization } from '../model-customizations/types';
@@ -34,6 +36,14 @@ export default class ForestHttpApi implements ForestAdminServerInterface {
     return ServerUtils.query<ModelCustomization[]>(options, 'get', '/liana/model-customizations');
   }
 
+  async getMcpServerConfigs(options: HttpOptions): Promise<McpConfiguration> {
+    return ServerUtils.query<McpConfiguration>(
+      options,
+      'get',
+      '/liana/mcp-server-configs-with-details',
+    );
+  }
+
   makeAuthService(options: Required<ForestAdminClientOptions>): ForestAdminAuthServiceInterface {
     return new AuthService(options);
   }

packages/forestadmin-client/src/schema/types.ts

@@ -6,6 +6,7 @@ export type ForestSchema = {
     liana: string;
     liana_version: string;
     liana_features: Record<string, string> | null;
+    ai_llms?: Array<{ provider: string }> | null;
     stack: {
       engine: string;
       engine_version: string;

packages/forestadmin-client/src/types.ts

@@ -1,10 +1,12 @@
 import type { ChartRequest } from './charts/chart-handler';
 import type { Chart, QueryChart } from './charts/types';
+import type { McpConfiguration } from '@forestadmin/ai-proxy';
 
 import { ParsedUrlQuery } from 'querystring';
 
 import { Tokens, UserInfo } from './auth/types';
 import { IpWhitelistConfiguration } from './ip-whitelist/types';
+import { McpServerConfigService } from './mcp-server-config/types';
 import { ModelCustomization, ModelCustomizationService } from './model-customizations/types';
 import { HttpOptions } from './permissions/forest-http-api';
 import {
@@ -49,6 +51,7 @@ export interface ForestAdminClient {
   readonly contextVariablesInstantiator: ContextVariablesInstantiatorInterface;
   readonly chartHandler: ChartHandlerInterface;
   readonly modelCustomizationService: ModelCustomizationService;
+  readonly mcpServerConfigService: McpServerConfigService;
   readonly authService: ForestAdminAuthServiceInterface;
 
   verifySignedActionParameters<TSignedParameters>(signedParameters: string): TSignedParameters;
@@ -161,5 +164,6 @@ export interface ForestAdminServerInterface {
   getUsers: (...args) => Promise<UserPermissionV4[]>;
   getRenderingPermissions: (renderingId: number, ...args) => Promise<RenderingPermissionV4>;
   getModelCustomizations: (options: HttpOptions) => Promise<ModelCustomization[]>;
+  getMcpServerConfigs: (options: HttpOptions) => Promise<McpConfiguration>;
   makeAuthService(options: ForestAdminClientOptionsWithDefaults): ForestAdminAuthServiceInterface;
 }