README.md
Access French e-phy catalog data for phytosanitary products via AI.
E-phy MCP Server
A Model Context Protocol (MCP) server built with Next.js that provides AI assistants with information about phytosanitary products from the French e-phy catalog (pesticides, fertilizers, adjuvants, mixtures and blends).
Data source: Open data e-phy (ANSES / data.gouv.fr)
Available Tools
| Tool | Description |
|---|---|
search_products |
Search phytosanitary products by name, active substance, AMM number, or holder |
get_product_by_amm |
Retrieve a product by its AMM (Autorisation de Mise sur le Marché) number |
get_product_details |
Get full details of a product by its internal e-phy ID |
get_product_usages |
List authorized usages (crops/targets) with dosage and safety requirements |
search_active_substances |
Search active substances by name with their approval status |
Getting Started
Development
npm install
npm run dev
The MCP server will be available at http://localhost:3000/mcp.
Using with an MCP client (Claude Desktop, etc.)
Add the following to your MCP client configuration:
{
"mcpServers": {
"ephy": {
"url": "http://localhost:3000/mcp"
}
}
}
Production
npm run build
npm start
Architecture
lib/ephy.ts– Type-safe client for the e-phy REST APIapp/[transport]/route.ts– Next.js App Router route handler that exposes the MCP server over Streamable HTTP (supports both GET/POST)
Tech Stack
- Next.js 16 (App Router)
- `@modelcontextprotocol/sdk` – Official TypeScript MCP SDK
- Zod – Schema validation for tool parameters
Tools (5)
search_productsSearch phytosanitary products by name, active substance, AMM number, or holderget_product_by_ammRetrieve a product by its AMM (Autorisation de Mise sur le Marché) numberget_product_detailsGet full details of a product by its internal e-phy IDget_product_usagesList authorized usages (crops/targets) with dosage and safety requirementssearch_active_substancesSearch active substances by name with their approval statusConfiguration
claude_desktop_config.json
{"mcpServers": {"ephy": {"url": "http://localhost:3000/mcp"}}}Try it
→Search for phytosanitary products containing the active substance 'glyphosate'.
→What are the authorized usages and dosage requirements for the product with AMM number 1234567?
→Check the current approval status of the active substance 'copper sulfate'.
→Find details for the product with ID 98765 and list its safety requirements.