# Paris Elementary School Data AI Agent Connect

> Paris Schools: Elementary Schools & Catchment Sectors provides direct access to the City of Paris open-data platform. Your AI client can query the school census from 2020 to 2027, identify specific school addresses, and determine which catchment sectors assign children to specific streets or schools.

## Overview
- **Category:** education
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_HuXXCEx7pjGHAC0hgMzJVXmJSezVKeNH5DX9QPK4/ai-agent-connect
- **Tags:** paris, france, schools, elementary, catchment-sectors, school-census, keyless

## Description

This MCP gives your AI client direct access to the official Paris open-data registry for elementary education. You can pull specific census rows for any school year between 2020 and 2027, including school names, addresses, and arrondissement details. Because the data includes catchment sectors (secteurs scolaires), your agent can perform reverse lookups to find which zones or streets feed into a specific school. The data is organized by school year and type, distinguishing between Elémentaire and Polyvalent institutions. Since the names are stored in uppercase with specific school codes in parentheses, your AI can use the lookup tools to ensure it matches the exact registry format before running complex queries. It is a precise way to navigate the administrative geography of Paris schools without manual searching.

## Tools

### count_school_sectors
Returns the total number of catchment-sector rows, which usually sits between 370 and 380 per school year.

### school_census
Provides a summary of the school census and sector counts for a specific year alongside city-wide totals.

### count_schools
Calculates the total number of elementary school rows for a given year, typically around 350 to 380 entries.

### find_school_sectors
Identifies which catchment sectors assign children to a specific school by checking all four assigned-school columns.

### list_school_sectors
Lists catchment sectors including their labels, zones, and the up to four assigned schools and addresses.

### list_schools
Retrieves the full list of Paris public elementary schools with their addresses, arrondissement, and school year.

### school_lookup
Finds a specific school by its registered name, including the uppercase format and school code.

## Prompt Examples

**Prompt:** 
```
Which catchment sectors assign children to the LITTRÉ school?
```

**Response:** 
```
First, I'll use school_lookup to confirm the exact name is 'LITTRE (6) ELEM'. Then, I'll run find_school_sectors to identify the specific zones that feed into it.
```

**Prompt:** 
```
How many elementary schools does Paris run in the 2026-2027 year?
```

**Response:** 
```
I will call count_schools for the 2026-2027 school year to get the exact total.
```

**Prompt:** 
```
List the polyvalent schools of the 6th arrondissement in 2025-2026.
```

**Response:** 
```
I'll use list_schools with the filters for '6ème Ardt', 'Polyvalent' type, and the '2025-2026' school year.
```

## Capabilities

### School Census Access
Your agent pulls specific school year data from 2020 through 2027.

### Catchment Mapping
The AI identifies which street zones or sectors are assigned to specific schools.

### Reverse Sector Lookups
Your client finds all sectors that feed into a single school name.

### District Filtering
The agent filters school lists by specific arrondissements.

### Data Summarization
Your AI calculates total school and sector counts for any given year.

## Use Cases

### Residential Planning
A parent uses the MCP to find out which school their new address in Paris falls into.

### Urban Research
A researcher compares the number of schools in an arrondissement against the number of catchment sectors.

### Data Journalism
A reporter pulls census totals for 2020 versus 2027 to track changes in school availability.

### Administrative Audits
Verifying that school sector assignments match the current year's census data.

## Benefits

- Direct connection to the Paris open-data platform.
- Eliminates manual searching through complex administrative tables.
- Provides exact school codes and uppercase names for accurate matching.
- Allows for year-over-year census comparisons.

## How It Works

The MCP connects your AI client to the Paris open-data registry for immediate querying.

1. Connect your AI client to the Vinkius-hosted MCP.
2. Use school_lookup to find the exact uppercase name and code for a school.
3. Run list_schools or list_school_sectors to pull specific datasets.
4. Use find_school_sectors to map schools to their catchment zones.

## Frequently Asked Questions

**What years of school data are available?**
The census data covers school years from 2020 through 2027.

**How do I find the correct name for a school?**
You should use the school_lookup or list_schools tools first. Names are stored in uppercase with a school code in parentheses.

**Can I find which school a specific street belongs to?**
Yes, you can use list_school_sectors to see the zones and assigned schools for specific areas.

**Is this data official?**
Yes, the data comes directly from the Paris open-data platform (opendata.paris.fr).

**What is the difference between Elémentaire and Polyvalent?**
These are the two school types stored in the census data, which you can filter for using list_schools.

**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.

**What is a catchment sector?**
A secteur scolaire is a neighborhood group that the city assigns to up to four elementary schools (the lib_etab_1..4 columns). Children in the sector's zone are enrolled in those schools — find_school_sectors answers "which sectors send children to school X".

**Why do I sometimes get 0 rows from school_lookup?**
Names are stored UPPERCASE with the school code in parentheses and an ELEM/POLY suffix ("LITTRE (6) ELEM"). The match is exact — run list_schools first to discover the stored form. School years rotate, so a school may only appear in the years it was open.

**Which school years are covered?**
Both datasets span 2020-2021 through 2026-2027; the census also holds a few rows with a null year. The newest year (2026-2027) is the current assignment calendar.
