Fibaro HC3 MCP Server

Instructions

Implementation Reference

• src/index.ts:565-579 (handler)

  MCP tool handler for fibaro_stop_scene: validates connection, extracts scene ID from args, calls fibaroClient.stopScene, and returns success message.

  case 'fibaro_stop_scene': {
    if (!this.fibaroClient) {
      throw new Error('Not connected to Fibaro HC3. Please check your configuration and restart the MCP server.');
    }
    const sceneId = args?.id as number;
    await this.fibaroClient.stopScene(sceneId);
    return {
      content: [
        {
          type: 'text',
          text: `Successfully stopped scene ${sceneId}`,
        },
      ],
    };
  }

• src/index.ts:316-328 (registration)

  Tool registration including name, description, and input schema definition (requires scene ID). Part of the tools array passed to server.setTools.

    name: 'fibaro_stop_scene',
    description: 'Stop a running scene',
    inputSchema: {
      type: 'object',
      properties: {
        id: {
          type: 'number',
          description: 'Scene ID to stop',
        },
      },
      required: ['id'],
    },
  },

• src/fibaro-client.ts:174-182 (helper)

  Core implementation: sends POST request to Fibaro HC3 API endpoint /api/scenes/{id}/action/stop to stop the scene.

  async stopScene(id: number): Promise<void> {
    try {
      await this.client.post(`/api/scenes/${id}/action/stop`, {
        args: []
      });
    } catch (error) {
      throw new Error(`Failed to stop scene ${id}: ${error}`);
    }
  }