RGB Lightning Network MCP Server

Instructions

Implementation Reference

• src/server.ts:73-81 (handler)

  Handler function for the 'rgb_get_asset_balance' MCP tool. It calls rgbClient.getAssetBalance(assetId), stringifies the result as JSON, and handles errors.

  async ({ assetId }) => {
    try {
      const balance = await rgbClient.getAssetBalance(assetId);
      return { content: [{ type: 'text', text: JSON.stringify(balance, null, 2) }] };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      return { content: [{ type: 'text', text: `Error: ${errorMessage}` }], isError: true };
    }
  }

• src/server.ts:70-72 (schema)

  Zod schema defining the input parameters for the tool: a required 'assetId' string.

  {
    assetId: z.string().describe('The ID of the RGB asset'),
  },

• src/server.ts:67-82 (registration)

  Registration of the 'rgb_get_asset_balance' tool on the MCP server using server.tool(), including description, input schema, and handler function.

  server.tool(
    'rgb_get_asset_balance',
    'Get balance for a specific RGB asset',
    {
      assetId: z.string().describe('The ID of the RGB asset'),
    },
    async ({ assetId }) => {
      try {
        const balance = await rgbClient.getAssetBalance(assetId);
        return { content: [{ type: 'text', text: JSON.stringify(balance, null, 2) }] };
      } catch (error) {
        const errorMessage = error instanceof Error ? error.message : String(error);
        return { content: [{ type: 'text', text: `Error: ${errorMessage}` }], isError: true };
      }
    }
  );

• src/rgb-client.ts:56-58 (helper)

  Supporting method in RGBApiClientWrapper class that wraps the underlying RGB API SDK call to get the balance for a specific asset ID.

  async getAssetBalance(assetId: string) {
    return await this.client.rgb.getAssetBalance({ asset_id: assetId });
  }