# Paris Procurement MCP for public data. AI Agent Connect

> Paris Procurement MCP provides direct access to the City of Paris public-tender register. You can query over 19,000 tender records from 2013 to 2023, including market types, supplier details, contract amounts, and notification years. It turns raw open data from opendata.paris.fr into actionable intelligence for your AI client.

## Overview
- **Category:** government
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OAbmDsBHMwF22oImu4vIiPh42WiOYsnBpvl6Toci/ai-agent-connect
- **Tags:** paris, france, procurement, public-tenders, suppliers, public-spending, keyless

## Description

You can pull specific contract details or broad spending trends directly through your AI client. This MCP connects to the official Paris open-data platform to give you the full history of city tenders. You can look up a specific contract by its number or pull a list of the largest service and construction deals. If you need to investigate a specific company, you can see every tender they have won and their total volume across different market types. The data includes the negotiated amount ranges, the specific budgeting perimeter, and the purchase category. Because the notification year is date-typed, you can ask your agent for yearly totals or specific time windows without worrying about formatting. It is a direct window into how the City of Paris allocates its budget for services, works, and supplies.

## Tools

### procurement_overview
This tool provides a high-level snapshot of the entire dataset. It returns top suppliers and category breakdowns in a single call.

### supplier_tenders
This tool lists all tenders won by a specific supplier. You can filter these results by a specific year or market type like services or works.

### big_tenders
This tool finds the highest-value contracts in the registry. You provide a minimum amount to filter for the city's largest deals.

### count_tenders
This tool returns a fast total count of tenders. Use it to compare volumes across different years or categories.

### list_tenders
This tool retrieves detailed rows from the tender register. Each result includes the tender number, supplier info, amount ranges, and purchase categories.

### tender_lookup
This tool pulls a single specific record using its tender number. It returns the object, supplier, and financial details for that exact contract.

### tenders_by_category
This tool counts how many tenders fall under a specific purchase category. It helps you quantify spending in niche sectors.

### tenders_by_year
This tool calculates tender volumes for specific years. It provides the annual totals and the delta between the first and last year in your range.

## Prompt Examples

**Prompt:** 
```
How many services tenders did Paris notify in 2023?
```

**Response:** 
```
The count_tenders tool returns the total for 2023 services by automatically applying the year window to the date column.
```

**Prompt:** 
```
Show me the ten biggest construction contracts of 2023.
```

**Response:** 
```
Running list_tenders with the nature set to TRAVAUX, the year to 2023, and a minimum amount of 1000000 returns the top ten high-value contracts.
```

**Prompt:** 
```
Which supplier wins the most city tenders?
```

**Response:** 
```
The procurement_overview tool identifies the most frequent awardees through its top suppliers facet.
```

## Capabilities

### Supplier Tracking
Your agent can pull a complete history of contracts won by any specific company.

### High-Value Filtering
You can isolate the largest city contracts by setting a minimum euro threshold.

### Trend Analysis
The AI can calculate year-over-year changes in tender volumes.

### Category Auditing
Your agent can group and count spending by specific purchase categories.

### Direct Lookup
You can retrieve exact contract details using a unique tender number.

## Use Cases

### Competitive Intelligence
Check a competitor's history of wins in the Paris market.

### Budget Monitoring
Compare the total volume of service tenders against construction tenders.

### Contract Verification
Confirm the exact amount and supplier for a specific tender number.

### Market Research
Find out which companies are most active in specific city sectors.

## Benefits

- Access 19,000 rows of data without manual scraping.
- Filter by exact euro amounts and notification years.
- Get instant totals for specific purchase categories.
- Identify top-tier suppliers through automated facets.

## How It Works

Connect your client to Vinkius to start querying Paris procurement data immediately.

1. Connect your MCP-compatible client to Vinkius.
2. Ask your agent a question about Paris tenders or suppliers.
3. The agent selects the correct tool from the MCP.
4. The tool pulls live data from the Paris open-data platform.
5. Your agent presents the filtered results or totals to you.

## Frequently Asked Questions

**What years of data are included?**
The dataset covers tender notifications from 2013 through 2023.

**How do I filter by a specific year?**
You can provide a 4-digit year to the tools. The MCP automatically converts this into a date window for the query.

**Can I see the exact amount of a contract?**
Yes, the tools provide the negotiated amount range using the montant_min and montant_max values in euros.

**What kind of market types are available?**
The data is categorized into SERVICES, TRAVAUX (works), and FOURNITURE (supplies).

**Do I need to manage my own API keys for Paris Open Data?**
No, Vinkius hosts the MCP and manages the connection to the data source for you.

**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 do I filter tenders by year?**
Pass a 4-digit year (e.g. "2023"). The annee_de_notification column is date-typed, so the tool builds a quoted ISO year window (>="2023-01-01T00:00:00" AND <="2023-12-31T23:59:59") instead of a text equality, which the platform would reject with a 400.

**What is the difference between montant_min and montant_max?**
A tender's negotiated amount is a range: montant_min and montant_max in euros. big_tenders and the min_amount filter test montant_max — so min_amount 1e6 returns the tenders whose upper bound reaches a million euros.

**Which budgeting perimeters are included?**
perimetre_financier marks the budgeting perimeter, e.g. "M57 Ville" (City of Paris), "M49 Assainissement" or "M57 Département" — the register covers both city and department markets. Use the perimetre filter for an exact match.
