DeepPVMapper

Open registry of 1.14M+ rooftop-solar detections across France, queryable by natural language.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
83%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~7,135Tokens (tool definitions)
~3.2 KBTypical response size
Significant attention impact (5.57% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "deeppvmapper": {
      "url": "https://zelhliylrlktnasircwp.supabase.co/functions/v1/mcp/mcp"
    }
  }
}

Remote endpoints

https://zelhliylrlktnasircwp.supabase.co/functions/v1/mcp/mcpstreamable-http

What it can do

Tool inventory

Tools (17)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_data_quality_reference

Return the DeepPVMapper/OpenPVMapper registry's documented data-quality characteristics: estimated detection recall, which fields are model-derived estimates vs. structural/observed fields, the source-encoding table, the recommended confidence threshold, confidence signals, and licensing/liability terms. Call this before advising how much to trust a result for a specific use case (e.g. exploratory research vs. a commercial or regulatory decision) — pair it with the quality_summary attached to search_detections / aggregate_detection_capacity results, which reflects the specific query rather than the registry as a whole.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_department_capacity_stats(dpt, top_n)

Get installed rooftop-PV capacity (total kWp) and system counts for one or all French départements, from the DeepPVMapper/OpenPVMapper registry. This is a fixed, pre-computed department-wide aggregate with no other filters — use aggregate_detection_capacity instead if you need a filtered subset (e.g. only cross-validated detections). Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "French département code, e.g. \"33\" for Gironde. Omit for all départements.",
      "type": "string"
    },
    "top_n": {
      "description": "If set and dpt is omitted, return only the top N départements by installed capacity.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 96
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_department_yearly_stats(dpt)

Get yearly system counts and capacity by département, based on first-seen imagery year. Useful for tracking apparent PV deployment growth over time. Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "French département code, e.g. \"33\". Omit for all départements.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢search_detections(dpt, insee, min_kwp, max_kwp, min_vintages, ...)

Search individual rooftop-PV detections by département, commune (INSEE code), estimated capacity range, and/or cross-validation confidence (min_vintages, cross_validated). Returns a bounded list of detection records plus a quality_summary for the returned sample (use get_detections_in_bbox instead for map/spatial queries with geometry). Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "French département code, e.g. \"33\".",
      "type": "string"
    },
    "insee": {
      "description": "INSEE commune code.",
      "type": "string"
    },
    "min_kwp": {
      "description": "Minimum estimated installed capacity, in kWp.",
      "type": "number"
    },
    "max_kwp": {
      "description": "Maximum estimated installed capacity, in kWp.",
      "type": "number"
    },
    "min_vintages": {
      "description": "Minimum number of distinct imagery vintages (years) the installation was independently detected in. Use 2+ as a persistence/confidence signal, since a one-off detection in a single vintage is more likely to be a transient artifact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "cross_validated": {
      "description": "Alias of quality_filter, kept for backward compatibility.",
      "type": "boolean"
    },
    "quality_filter": {
      "default": false,
      "description": "If true, only include detections identified by 2 OR MORE sources(the `sources` field lists at least two codes, e.g. \"0,1\" = DeepPVMapper pipeline + FRPV reference, \"0,2\" = pipeline + OpenStreetMap). Default false: all detections are included, including those found by a single source (typically the automated pipeline alone).",
      "type": "boolean"
    },
    "sources_include": {
      "description": "Only include detections present in ALL of these sources. Accepts names or codes, case-insensitive: dpvm/deeppvmapper/kasmi (0), frpv/thebault (1), osm/openstreetmap (2), manual/annotation (3), recall (4). Examples: [\"osm\"] = detections that are in OpenStreetMap; [\"dpvm\",\"frpv\"] = present in both DeepPVMapper and FRPV. See get_source_reference for what each source is and where it comes from.",
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "integer",
            "minimum": 0,
            "maximum": 4
          },
          {
            "type": "string"
          }
        ]
      }
    },
    "min_frpv_proba": {
      "description": "Minimum frpv_proba. The data contract recommends 0.1 as a precision/recall trade-off. Note: detections with a null frpv_proba (no FRPV comparison available) are excluded when this is set; null does not mean probability 0.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "has_rnb_id": {
      "description": "true = only detections matched to an RNB building identifier (rnb_id not null); false = only detections without one.",
      "type": "boolean"
    },
    "has_frpv_proba": {
      "description": "true = only detections that have an FRPV comparison (frpv_proba not null); false = only those without one. A null frpv_proba means \"no comparison available\", not probability 0.",
      "type": "boolean"
    },
    "false_positive_status": {
      "description": "flagged = false_positive is true; not_flagged = false_positive is false; unrecorded = false_positive is null (no status recorded — NOT a confirmed true positive).",
      "type": "string",
      "enum": [
        "flagged",
        "not_flagged",
        "unrecorded"
      ]
    },
    "min_surface": {
      "description": "Minimum estimated PV array area, in m².",
      "type": "number"
    },
    "max_surface": {
      "description": "Maximum estimated PV array area, in m².",
      "type": "number"
    },
    "min_tilt": {
      "description": "Minimum estimated tilt from horizontal, in degrees.",
      "type": "number"
    },
    "max_tilt": {
      "description": "Maximum estimated tilt from horizontal, in degrees.",
      "type": "number"
    },
    "min_azimuth": {
      "description": "Minimum estimated azimuth, degrees clockwise from true north (180 = south).",
      "type": "number"
    },
    "max_azimuth": {
      "description": "Maximum estimated azimuth, degrees clockwise from true north (180 = south).",
      "type": "number"
    },
    "min_first_seen": {
      "description": "Earliest imagery year of first detection, lower bound (e.g. 2018). Not an installation date.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_first_seen": {
      "description": "Upper bound on first_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "min_last_seen": {
      "description": "Lower bound on last_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_last_seen": {
      "description": "Upper bound on last_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_vintages": {
      "description": "Maximum number of imagery vintages (e.g. 1 = seen in a single year only).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of records to return (max 200).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 200
    }
  },
  "required": [
    "quality_filter",
    "limit"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟡aggregate_detection_capacity(dpt, insee, min_kwp, max_kwp, min_vintages, ...)

Compute the total estimated installed capacity (kWp) and count of detections matching a set of filters — département, commune, capacity range, and cross-validation across sources (cross_validated) or imagery vintages (min_vintages) — plus a quality_summary for the summed sample. Unlike get_department_capacity_stats, which is a fixed pre-computed département-wide aggregate with no other filters, this tool sums a live filtered subset, up to max_rows detections. Example: "installed capacity in Gironde confirmed by at least two sources" -> dpt="33", cross_validated=true. Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "French département code, e.g. \"33\".",
      "type": "string"
    },
    "insee": {
      "description": "INSEE commune code.",
      "type": "string"
    },
    "min_kwp": {
      "description": "Minimum estimated installed capacity, in kWp.",
      "type": "number"
    },
    "max_kwp": {
      "description": "Maximum estimated installed capacity, in kWp.",
      "type": "number"
    },
    "min_vintages": {
      "description": "Minimum number of distinct imagery vintages (years) the installation was independently detected in. Use 2+ as a persistence/confidence signal, since a one-off detection in a single vintage is more likely to be a transient artifact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "cross_validated": {
      "description": "Alias of quality_filter, kept for backward compatibility.",
      "type": "boolean"
    },
    "quality_filter": {
      "default": false,
      "description": "If true, only include detections identified by 2 OR MORE sources(the `sources` field lists at least two codes, e.g. \"0,1\" = DeepPVMapper pipeline + FRPV reference, \"0,2\" = pipeline + OpenStreetMap). Default false: all detections are included, including those found by a single source (typically the automated pipeline alone).",
      "type": "boolean"
    },
    "sources_include": {
      "description": "Only include detections present in ALL of these sources. Accepts names or codes, case-insensitive: dpvm/deeppvmapper/kasmi (0), frpv/thebault (1), osm/openstreetmap (2), manual/annotation (3), recall (4). Examples: [\"osm\"] = detections that are in OpenStreetMap; [\"dpvm\",\"frpv\"] = present in both DeepPVMapper and FRPV. See get_source_reference for what each source is and where it comes from.",
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "integer",
            "minimum": 0,
            "maximum": 4
          },
          {
            "type": "string"
          }
        ]
      }
    },
    "min_frpv_proba": {
      "description": "Minimum frpv_proba. The data contract recommends 0.1 as a precision/recall trade-off. Note: detections with a null frpv_proba (no FRPV comparison available) are excluded when this is set; null does not mean probability 0.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "has_rnb_id": {
      "description": "true = only detections matched to an RNB building identifier (rnb_id not null); false = only detections without one.",
      "type": "boolean"
    },
    "has_frpv_proba": {
      "description": "true = only detections that have an FRPV comparison (frpv_proba not null); false = only those without one. A null frpv_proba means \"no comparison available\", not probability 0.",
      "type": "boolean"
    },
    "false_positive_status": {
      "description": "flagged = false_positive is true; not_flagged = false_positive is false; unrecorded = false_positive is null (no status recorded — NOT a confirmed true positive).",
      "type": "string",
      "enum": [
        "flagged",
        "not_flagged",
        "unrecorded"
      ]
    },
    "min_surface": {
      "description": "Minimum estimated PV array area, in m².",
      "type": "number"
    },
    "max_surface": {
      "description": "Maximum estimated PV array area, in m².",
      "type": "number"
    },
    "min_tilt": {
      "description": "Minimum estimated tilt from horizontal, in degrees.",
      "type": "number"
    },
    "max_tilt": {
      "description": "Maximum estimated tilt from horizontal, in degrees.",
      "type": "number"
    },
    "min_azimuth": {
      "description": "Minimum estimated azimuth, degrees clockwise from true north (180 = south).",
      "type": "number"
    },
    "max_azimuth": {
      "description": "Maximum estimated azimuth, degrees clockwise from true north (180 = south).",
      "type": "number"
    },
    "min_first_seen": {
      "description": "Earliest imagery year of first detection, lower bound (e.g. 2018). Not an installation date.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_first_seen": {
      "description": "Upper bound on first_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "min_last_seen": {
      "description": "Lower bound on last_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_last_seen": {
      "description": "Upper bound on last_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_vintages": {
      "description": "Maximum number of imagery vintages (e.g. 1 = seen in a single year only).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "max_rows": {
      "default": 5000,
      "description": "Cap on the number of matching detection rows fetched to compute the capacity sum. If the true match count exceeds this, total_kwp is a partial lower bound and `truncated` is true — increase max_rows or narrow the filters (e.g. add dpt or insee) for an exact total.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 20000
    }
  },
  "required": [
    "quality_filter",
    "max_rows"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_detections_in_bbox(min_lon, min_lat, max_lon, max_lat, max_count)

Get rooftop-PV detections within a geographic bounding box (WGS84 lon/lat), including footprint geometry. Intended for map-style spatial queries over a small area. Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "min_lon": {
      "type": "number"
    },
    "min_lat": {
      "type": "number"
    },
    "max_lon": {
      "type": "number"
    },
    "max_lat": {
      "type": "number"
    },
    "max_count": {
      "default": 100,
      "description": "Maximum number of detections to return (max 500 here; the underlying API defaults to 2000, capped lower to keep responses manageable for an LLM).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 500
    }
  },
  "required": [
    "min_lon",
    "min_lat",
    "max_lon",
    "max_lat",
    "max_count"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟡get_community_activity(recent_limit)

Get a snapshot of ongoing community contribution activity on the map: how many corrections are currently pending moderation, their breakdown by action type (add / modify / delete), and the most recent submissions (timestamp, action, target). Submitted free-text comments are intentionally excluded from this tool. This reflects unmoderated, unverified user activity, not the registry itself — do not present it as confirmed detection data.

Input Schema

{
  "type": "object",
  "properties": {
    "recent_limit": {
      "default": 15,
      "description": "How many of the most recent pending contributions to list.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "required": [
    "recent_limit"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_community_activity_in_area(dpt, min_lon, min_lat, max_lon, max_lat, ...)

Find pending, unmoderated community contributions relevant to a specific area, to answer "has anyone flagged anything here that is not in the registry yet?" Two independent filters: dpt finds pending edits/deletions (action=modify/delete) targeting existing detections in that département; a full bounding box (min_lon/min_lat/max_lon/max_lat) finds pending new additions (action=add) whose proposed footprint centroid falls inside it. Combine with get_department_capacity_stats / search_detections / get_detections_in_bbox for the confirmed registry picture, and present this separately and clearly as unverified, pending community input — not confirmed detection data. Free-text comments are never included.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "Filter pending edits/deletions of EXISTING detections (action=modify or delete) to this département. Does not apply to proposed new additions (action=add), which have no département recorded on the pending item itself — use the bbox parameters for those.",
      "type": "string"
    },
    "min_lon": {
      "type": "number"
    },
    "min_lat": {
      "type": "number"
    },
    "max_lon": {
      "type": "number"
    },
    "max_lat": {
      "type": "number"
    },
    "scan_limit": {
      "default": 500,
      "description": "How many recent proposed additions (action=add) to scan for a bbox match. Only relevant when all four bbox parameters are given — there is no server-side spatial index on pending items, so matching is done by fetching this many of the most recent ones and checking their centroid against the box.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 2000
    },
    "recent_limit": {
      "default": 30,
      "description": "Maximum number of matching items to return per category.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "scan_limit",
    "recent_limit"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟡count_detections(dpt, insee, min_kwp, max_kwp, min_vintages, ...)

Count detections matching a set of filters, exactly, without downloading rows (fast, no row cap). Use this for "how many ..." questions, e.g. "how many installations have an RNB id?" -> has_rnb_id=true; "how many are identified by 2+ sources?" -> quality_filter=true; "how many come from OpenStreetMap?" -> sources_include=[2]. Returns the matching count, the unfiltered registry total and the percentage. Counts are DETECTED systems, not an inventory. Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "French département code, e.g. \"33\".",
      "type": "string"
    },
    "insee": {
      "description": "INSEE commune code.",
      "type": "string"
    },
    "min_kwp": {
      "description": "Minimum estimated installed capacity, in kWp.",
      "type": "number"
    },
    "max_kwp": {
      "description": "Maximum estimated installed capacity, in kWp.",
      "type": "number"
    },
    "min_vintages": {
      "description": "Minimum number of distinct imagery vintages (years) the installation was independently detected in. Use 2+ as a persistence/confidence signal, since a one-off detection in a single vintage is more likely to be a transient artifact.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "cross_validated": {
      "description": "Alias of quality_filter, kept for backward compatibility.",
      "type": "boolean"
    },
    "quality_filter": {
      "default": false,
      "description": "If true, only include detections identified by 2 OR MORE sources(the `sources` field lists at least two codes, e.g. \"0,1\" = DeepPVMapper pipeline + FRPV reference, \"0,2\" = pipeline + OpenStreetMap). Default false: all detections are included, including those found by a single source (typically the automated pipeline alone).",
      "type": "boolean"
    },
    "sources_include": {
      "description": "Only include detections present in ALL of these sources. Accepts names or codes, case-insensitive: dpvm/deeppvmapper/kasmi (0), frpv/thebault (1), osm/openstreetmap (2), manual/annotation (3), recall (4). Examples: [\"osm\"] = detections that are in OpenStreetMap; [\"dpvm\",\"frpv\"] = present in both DeepPVMapper and FRPV. See get_source_reference for what each source is and where it comes from.",
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "integer",
            "minimum": 0,
            "maximum": 4
          },
          {
            "type": "string"
          }
        ]
      }
    },
    "min_frpv_proba": {
      "description": "Minimum frpv_proba. The data contract recommends 0.1 as a precision/recall trade-off. Note: detections with a null frpv_proba (no FRPV comparison available) are excluded when this is set; null does not mean probability 0.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "has_rnb_id": {
      "description": "true = only detections matched to an RNB building identifier (rnb_id not null); false = only detections without one.",
      "type": "boolean"
    },
    "has_frpv_proba": {
      "description": "true = only detections that have an FRPV comparison (frpv_proba not null); false = only those without one. A null frpv_proba means \"no comparison available\", not probability 0.",
      "type": "boolean"
    },
    "false_positive_status": {
      "description": "flagged = false_positive is true; not_flagged = false_positive is false; unrecorded = false_positive is null (no status recorded — NOT a confirmed true positive).",
      "type": "string",
      "enum": [
        "flagged",
        "not_flagged",
        "unrecorded"
      ]
    },
    "min_surface": {
      "description": "Minimum estimated PV array area, in m².",
      "type": "number"
    },
    "max_surface": {
      "description": "Maximum estimated PV array area, in m².",
      "type": "number"
    },
    "min_tilt": {
      "description": "Minimum estimated tilt from horizontal, in degrees.",
      "type": "number"
    },
    "max_tilt": {
      "description": "Maximum estimated tilt from horizontal, in degrees.",
      "type": "number"
    },
    "min_azimuth": {
      "description": "Minimum estimated azimuth, degrees clockwise from true north (180 = south).",
      "type": "number"
    },
    "max_azimuth": {
      "description": "Maximum estimated azimuth, degrees clockwise from true north (180 = south).",
      "type": "number"
    },
    "min_first_seen": {
      "description": "Earliest imagery year of first detection, lower bound (e.g. 2018). Not an installation date.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_first_seen": {
      "description": "Upper bound on first_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "min_last_seen": {
      "description": "Lower bound on last_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_last_seen": {
      "description": "Upper bound on last_seen imagery year.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_vintages": {
      "description": "Maximum number of imagery vintages (e.g. 1 = seen in a single year only).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "breakdown_rnb_id": {
      "default": false,
      "description": "If true, also return how many of the matching detections do / do not have an rnb_id (ignores has_rnb_id for this breakdown).",
      "type": "boolean"
    }
  },
  "required": [
    "quality_filter",
    "breakdown_rnb_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟡get_source_breakdown(dpt)

Break down detections by source code (0=DPVM pipeline, 1=FRPV reference, 2=OSM, 3=manual correction, 4=recall sample), for one département or all of France, with human-readable labels. A detection can carry several sources, so per-source counts overlap and do not add up to the total. Also returns how many detections are identified by 2+ sources (the meaning of quality_filter). Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "French département code, e.g. \"33\". Omit for all of France.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_detection_details(id)

Get the full record of one detection by id: technical characteristics (surface, kwp, tilt, azimuth — model estimates), imagery years, sources decoded into plain labels, frpv_proba, false-positive flag, rnb_id and location codes, plus simple confidence signals. Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Registry identifier of the detection (the `id` field)."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_department_profile(dpt)

One-call profile of a département: installed capacity and national rank, yearly trend (by first-seen imagery year), source mix, share identified by 2+ sources, and share matched to an RNB building id. Cross-references the pre-computed department statistics with live counts. Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "type": "string",
      "description": "French département code, e.g. \"33\"."
    }
  },
  "required": [
    "dpt"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_field_coverage(dpt)

Completeness report: for each optional field of the registry (rnb_id, frpv_proba, false_positive, false_positive_source), how many detections have it filled in and what percentage. Answers "how many installations have an RNB id / an FRPV comparison / a false-positive flag?" in one call, for France or one département. For a single filtered count use count_detections instead. Null means "not available/recorded", never "0" or "confirmed ok". Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "dpt": {
      "description": "French département code. Omit for all of France.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_field_distribution(field, dpt, bin_edges, min_year, max_year, ...)

Histogram of a numeric field (kwp, surface, tilt, azimuth, n_vintages, first_seen, last_seen) with exact counts per bin, for France or one département. Answers "how are installations distributed by size / tilt / orientation / year?". kwp, surface, tilt and azimuth are model estimates. first_seen/last_seen are imagery years, not installation dates. Data quality note: this is a detection dataset, not an exhaustive inventory (estimated recall ~0.6). A missing detection does not mean no PV installation exists there. kwp, surface, tilt and azimuth are model estimates, not surveyed values. In this server, quality_filter=true keeps only detections identified by 2 or more sources (see source_encoding in get_data_quality_reference). Call get_data_quality_reference for the full picture before assessing fitness for a specific use case.

Input Schema

{
  "type": "object",
  "properties": {
    "field": {
      "type": "string",
      "enum": [
        "kwp",
        "surface",
        "tilt",
        "azimuth",
        "n_vintages",
        "first_seen",
        "last_seen"
      ],
      "description": "Numeric field to describe."
    },
    "dpt": {
      "description": "French département code. Omit for all of France.",
      "type": "string"
    },
    "bin_edges": {
      "description": "Custom ascending bin edges; each bin is [edge_i, edge_i+1) and the last is closed. Ignored for first_seen / last_seen, which are counted per year (use min_year / max_year).",
      "minItems": 2,
      "maxItems": 25,
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "min_year": {
      "description": "For first_seen / last_seen: first year to count.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "max_year": {
      "description": "For first_seen / last_seen: last year to count.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "quality_filter": {
      "default": false,
      "description": "If true, restrict to detections identified by 2+ sources.",
      "type": "boolean"
    }
  },
  "required": [
    "field",
    "quality_filter"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_field_reference

Field-by-field documentation of a detection record: type, unit, nullability, whether it is observed or a model estimate, how to read it, and which tool filters or reports it. Call this when the user asks what a field means or how reliable it is.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_source_reference(source)

Explain the data sources behind the registry's `sources` field: for each source, its code, short key, name, accepted aliases, and where the data comes from (with references: code, thesis, papers). Use it for questions like "what is FRPV?", "where does the OSM data come from?", "what is a manual correction?". The `sources` field answers "where do we have this installation?": each listed code is a dataset or process that contains it. Example: "0,1" = present in both DeepPVMapper (DPVM) and FRPV; "0,2" = present in DeepPVMapper and OpenStreetMap.

Input Schema

{
  "type": "object",
  "properties": {
    "source": {
      "description": "A source name, alias or code (e.g. \"frpv\", \"OpenStreetMap\", \"kasmi\", \"3\"). Omit to list all.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢get_started

START HERE. Call this first when the user is new, asks what this server can do, or asks a vague question about DeepPVMapper. Returns a plain-language introduction, example questions, which tool answers which kind of question, a glossary and the main caveats. Reply to the user in their own language.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded17 tools
verifiedversion not recorded17 tools
verifiedversion not recorded17 tools
verifiedversion not recorded8 tools
verifiedversion not recorded8 tools
verifiedversion not recorded8 tools