# Paris Lighting Street-Light Inventory AI Agent Connect

> Paris Lighting: Street-Light Inventory provides direct access to the official Paris open-data registry of public lighting. Your AI client can query specific fixture codes, count lamps by road or arrondissement, and analyze the split between public and private street lighting across the city.

## Overview
- **Category:** government-public-data
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_rZXYBE4zv6L51gQ78bQCWvMQbXKKnwDmXNIkQGiZ/ai-agent-connect
- **Tags:** paris, france, lighting, street-lights, luminaires, urban-infrastructure, keyless

## Description

This MCP connects your agent to the official Paris open-data platform to access the city's fixed asset register for street lighting. You can pull specific technical details for any of the 165,000 fixtures, including WGS84 coordinates, maintenance notes, and lighting regimes. It is built for precision, using the exact road labels and zero-padded arrondissement identifiers used by the city. Instead of digging through web portals, you can ask your AI client to count the lamps on a specific street or find the total number of fixtures in a particular district. Note that this is a static asset register for infrastructure, not a live feed for reporting outages or dimming status.

## Tools

### arrondissement_lighting
Counts the total number of light fixtures within a specific Paris arrondissement. You provide the district number from 1 to 20.

### count_light_fixtures
Returns a fast total count of fixtures filtered by road, category, sector, or arrondissement. Use this to quickly gauge the scale of lighting in a specific area.

### lighting_overview
Provides a high-level summary of the entire lighting network. It breaks down the top maintenance sectors, lamp families, and road category splits.

### fixtures_by_road
Lists and counts the specific fixtures located on a given road. You must use the uppercase road label as stored in the city database.

### light_fixture_lookup
Retrieves the full technical profile for a single fixture using its unique code. It returns coordinates, work type, and maintenance notes.

### list_light_fixtures
Queries the full inventory of Paris street lights with exact-match filters. You can filter by road, sector, or arrondissement to get a paginated list of fixture details.

### public_private_split
Calculates the distribution of the lighting network between public and private roads. It returns three totals: the entire network, public roads, and private roads.

## Prompt Examples

**Prompt:** 
```
How many street lights does the 6th arrondissement have?
```

**Response:** 
```
The 6th arrondissement has a specific count of fixtures. You can use arrondissement_lighting to get this total immediately.
```

**Prompt:** 
```
How many lamps light the rue Legendre?
```

**Response:** 
```
There are a specific number of lamps on rue Legendre. Running fixtures_by_road with the label "LEGENDRE (RUE)" will give you the total and the first page of fixture details.
```

**Prompt:** 
```
How is the lighting network split between public and private roads?
```

**Response:** 
```
The public_private_split tool provides the exact totals for the whole network, public roads, and private roads in one call.
```

## Capabilities

### Fixture Identification
Your agent uses the unique code to find exact coordinates and maintenance history.

### Spatial Counting
The AI calculates how many lamps exist on specific streets or within districts.

### Infrastructure Auditing
Your agent analyzes the distribution of lamp families and maintenance sectors.

### Ownership Analysis
The AI determines the ratio of lighting on public versus private roads.

## Use Cases

### Street-Level Audits
An urban planner asks for the total number of lamps on a specific road to plan upgrades.

### District Comparisons
A researcher compares the lighting density between different arrondissements.

### Infrastructure Mapping
A developer uses fixture coordinates to overlay lighting data onto a map.

### Ownership Research
A policy analyst checks the proportion of lighting on private versus public roads.

## Benefits

- Direct access to the official Paris open-data registry.
- Automated mapping of arrondissement numbers to official zero-padded labels.
- Instant filtering by road category, maintenance sector, or lighting regime.
- Eliminates manual searching through the Paris open-data web portal.

## How It Works

Connect your client to Vinkius to access the Paris lighting database through your agent.

1. Connect your MCP-compatible client to Vinkius.
2. Ask your agent a question about Paris street lighting.
3. The agent selects the appropriate tool from the Paris Lighting MCP.
4. The tool queries the Paris open-data platform.
5. Your agent receives the raw data and presents the answer to you.

## Frequently Asked Questions

**Is this a live feed for reporting broken street lights?**
No. This MCP accesses the city's fixed asset register, which contains technical details and locations, not live outage or dimming reports.

**How do I search for a specific road?**
You must use the road label exactly as it is stored in the database, which is in UPPERCASE and includes a type suffix, such as "LEGENDRE (RUE)".

**Can I find the exact location of a lamp?**
Yes. Using the light_fixture_lookup tool with a fixture code will return the WGS84 coordinates.

**Do I need to know the official arrondissement format?**
No. You can provide a simple number from 1 to 20, and the MCP will automatically map it to the required zero-padded label.

**What kind of data is included for each fixture?**
The data includes the fixture code, work type, lighting regime, maintenance notes, coordinates, road name, road category, maintenance sector, and arrondissement.

**Do I need an API key?**
No. opendata.paris.fr serves all city datasets anonymously over its Opendatasoft REST API. This MCP defines no credentials and needs nothing configured.

**How are the road names stored?**
UPPERCASE with a type suffix in parentheses, e.g. "LEGENDRE (RUE)" or "CINQ MARS (AVENUE)". The voie filter is an exact match on the stored label — fetch a page of list_light_fixtures to see the exact forms.

**What does the public/private split mean?**
voie_categorie separates the network between streets maintained on public land (VOIES PUBLIQUES) and privately owned roads lit by the city (VOIES PRIVEES) — public_private_split returns both totals plus the grand total in one call.

**Is this a live sensor feed?**
No. The dataset is the city's fixed asset register of each fixture — its code, location, lamp/support family and lighting regime. It is not a dimming, outage or occupancy feed.
