`pv_performance`

Pack: pvgis · Endpoint: https://gateway.pipeworx.io/pvgis/mcp

Model annual + monthly PV system output. Returns kWh/year estimates and monthly breakdowns.

Parameters

Name	Type	Required	Description
`latitude`	number	yes	Latitude in degrees
`longitude`	number	yes	Longitude in degrees
`peakpower`	number	no	Nominal peak power (kWp). Default 1.
`loss`	number	no	System losses (%) — default 14
`mountingplace`	string	no	free \| building (BIPV). Default free.
`angle`	number	no	Tilt angle in degrees from horizontal. Default 35.
`aspect`	number	no	Azimuth: 0=south, 90=west, -90=east, 180=north. Default 0.
`pvtechchoice`	string	no	crystSi \| CIS \| CdTe \| Unknown. Default crystSi.

Example call

Arguments

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "peakpower": 5,
  "loss": 14,
  "angle": 35,
  "aspect": 0,
  "pvtechchoice": "crystSi"
}

curl

curl -X POST https://gateway.pipeworx.io/pvgis/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"pv_performance","arguments":{"latitude":40.7128,"longitude":-74.006,"peakpower":5,"loss":14,"angle":35,"aspect":0,"pvtechchoice":"crystSi"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('pv_performance', {
  "latitude": 40.7128,
  "longitude": -74.006,
  "peakpower": 5,
  "loss": 14,
  "angle": 35,
  "aspect": 0,
  "pvtechchoice": "crystSi"
});

More examples

{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "peakpower": 10,
  "mountingplace": "building"
}

Response shape

Field	Type	Description
`inputs`	object	Input parameters echoed back
`outputs`	object

Full JSON Schema

{
  "type": "object",
  "properties": {
    "inputs": {
      "type": "object",
      "description": "Input parameters echoed back"
    },
    "outputs": {
      "type": "object",
      "properties": {
        "fixed": {
          "type": "object",
          "properties": {
            "E_year": {
              "type": "number",
              "description": "Annual energy output in kWh"
            },
            "E_month": {
              "type": "array",
              "items": {
                "type": "number"
              },
              "description": "Monthly energy output in kWh (12 values)"
            }
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "pvgis": {
      "url": "https://gateway.pipeworx.io/pvgis/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

pv_performance