# Paris Sports Facility Time Slots AI Agent Connect

> Paris Sports: Public Facility Time Slots provides direct access to the Paris open-data platform. Your AI client can query nearly 19,000 time slots to find specific sports disciplines, facility locations, age requirements, and pricing. Whether you need to find free weekend activities or map out all basketball sessions at a specific gym, this MCP handles the data retrieval for you.

## Overview
- **Category:** government-public-data
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_yd69k1K92aDs9ozeSKOWqRR4FtfWl16PkeFuKxN6/ai-agent-connect
- **Tags:** paris, france, sports, facilities, time-slots, associations, keyless

## Description

You can query the complete occupancy data for Paris's public sports facilities directly through your AI client. This MCP pulls from the official Paris open-data platform to give you granular details on how local associations use city-run gyms, pools, and courts. You'll get specific information on the association running the session, the exact discipline, the facility address, and whether the slot is free or paid. It's built for precise filtering, meaning you can target specific age groups or specific weekdays. If you're looking for a specific gym, you can pull every scheduled activity for that location. The data includes everything from the postal code to the average annual price, making it easy to plan your schedule or research the city's sports landscape without manually digging through government spreadsheets.

## Tools

### free_sport_slots
This tool returns only the unpaid sports time slots available in Paris. Use it to quickly find free activities for any given day.

### list_sport_slots
This tool provides a full list of all ~18,800 sports association time slots. Each entry includes the discipline, facility address, gender requirements, age bounds, and pricing.

### slots_by_age
This tool filters the database for slots matching a specific age. It works by matching the exact age value stored in the system.

### sport_equipment_lookup
This tool retrieves all scheduled activities for a specific facility name. It's the fastest way to see what's happening at a particular gym or pool.

### count_sport_slots
This tool provides a total count of available slots. Use it to compare how many sessions a specific discipline or district has compared to others.

## Prompt Examples

**Prompt:** 
```
What free sports can I do on a Saturday in Paris?
```

**Response:** 
```
I found several free options for Saturday, including Judo at Gymnase X and Swimming at Piscine Y. You can check the specific hours and locations for each.
```

**Prompt:** 
```
Which facility runs gym sessions for 8-year-olds?
```

**Response:** 
```
Gymnase Huyghens and Gymnase Z both have scheduled sessions specifically for 8-year-olds. I can pull the exact times for you.
```

**Prompt:** 
```
What is happening at Gymnase Suchet?
```

**Response:** 
```
Gymnase Suchet hosts several activities, including Basketball on Tuesdays and Tennis on Thursdays. Some of these are paid sessions run by local clubs.
```

## Capabilities

### Free Activity Discovery
Your agent can isolate only the unpaid slots to find zero-cost sports options.

### Facility Auditing
Your AI client can list every single scheduled activity at a specific named facility.

### Age-Specific Filtering
Your agent can find sports sessions that match exact age requirements for children or adults.

### Volume Analysis
Your AI client can count total slots to compare sports availability across different areas.

## Use Cases

### Weekend Planning
Ask your agent to find free sports activities available this Saturday in your specific arrondissement.

### Facility Research
Check the full schedule of a specific gym to see if it fits your availability.

### Demographic Mapping
Compare the number of available basketball slots versus tennis slots in the city.

### Child Activity Search
Find sports sessions that match a specific age requirement for a child.

## Benefits

- Access 18,800+ real-time data rows without manual searching.
- Filter by exact age, weekday, or price status.
- Get direct facility addresses and contact info for local associations.
- Avoid manual data entry by using structured tool outputs.

## How It Works

Connect your client to Vinkius and start querying Paris open data immediately.

1. Connect your MCP-compatible client to the Vinkius platform.
2. Ask your AI client a question about Paris sports.
3. The agent selects the appropriate tool like free_sport_slots or sport_equipment_lookup.
4. The tool pulls the exact data from the Paris open-data source.
5. Your agent presents the filtered results in a readable format.

## Frequently Asked Questions

**How many sports slots are available in the data?**
The MCP provides access to approximately 18,800 individual time slots.

**Can I find free sports activities?**
Yes, you can use the free_sport_slots tool to find the roughly 7,800 unpaid sessions available in Paris.

**Does the data include the location of the facilities?**
Yes, every slot includes the facility name, the specific location within the facility, and the full street address.

**How do I filter by age?**
You can use the slots_by_age tool to find sessions where the age minimum or maximum matches your requirement.

**Is the data updated frequently?**
The data is pulled directly from the Paris open-data platform (opendata.paris.fr).

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

**Why can I not filter slots between ages 8 and 12?**
The age_minimum / age_maximum columns are stored as text, and the ODS platform rejects range comparisons on text columns. slots_by_age matches the stored bound exactly (age_min 8 → slots starting at 8) — chain a few calls to cover a band.

**Is this a live booking system?**
No. It is the city's occupancy reference: which association occupies which facility, on which weekday and hours, and whether the slot is paid. It is not a booking API.

**How do I find all free tennis slots in the 16th?**
Run free_sport_slots with discipline "TENNIS" and code_postal "75016" — the facility postal code is a stored value you can filter on, and the free tool pins payant "non" automatically.
