Fibaro HC3 MCP Server

Instructions

Implementation Reference

• src/index.ts:549-563 (handler)

  MCP tool handler for fibaro_run_scene: extracts scene ID from arguments, calls FibaroClient.runScene, and returns success message.

  case 'fibaro_run_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.runScene(sceneId);
    return {
      content: [
        {
          type: 'text',
          text: `Successfully started scene ${sceneId}`,
        },
      ],
    };
  }

• src/index.ts:301-313 (registration)

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

  {
    name: 'fibaro_run_scene',
    description: 'Run/start a scene',
    inputSchema: {
      type: 'object',
      properties: {
        id: {
          type: 'number',
          description: 'Scene ID to run',
        },
      },
      required: ['id'],
    },

• src/fibaro-client.ts:164-172 (helper)

  FibaroClient helper method that performs the HTTP POST to start the scene via Fibaro API.

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

• src/index.ts:304-313 (schema)

  Input schema definition for the fibaro_run_scene tool.

  inputSchema: {
    type: 'object',
    properties: {
      id: {
        type: 'number',
        description: 'Scene ID to run',
      },
    },
    required: ['id'],
  },