Agro GPS MCP

MCP server for Agro GPS, the digital field notebook.

• Free, no key: search and check plant protection products (pesticides, fungicides, herbicides) in the official registers of 30 European countries, mirrored by Agro GPS: is it still authorised, which substances, which uses, is it allowed on this crop.
• With your key: your farms, field notebook, group dashboard, advisor queue and farm finances and, with a write key, recording new notebook entries.

Setup

{
  "mcpServers": {
    "agro-gps": {
      "command": "npx",
      "args": ["-y", "agro-gps-mcp"]
    }
  }
}

That is enough for the public tools. For your own farm data, create a key in the app at agrogps.eu/app (Settings → API and webhooks) and add it:

"env": { "AGROGPS_API_KEY": "agk_your_key_here" }

Variable	Required	Default
AGROGPS_API_KEY	only for farm tools	—
AGROGPS_TIMEOUT_MS	no	20000
AGROGPS_API_URL	no	https://api.agrogps.eu/api/v1

Public tools (no key)

Tool	What it does
search_plant_protection_products	Search a country's official register by trade name; authorisation state and a link to each product page
check_plant_protection_product	One product by registration number: state, expiry, substances, authorised uses and, with crop_eppo, whether it is allowed on that crop

Examples: "Is Roundup Ultra Plus still authorised in Spain?", "Can I use product 7400057 on grapevine in France?". Public endpoints are rate limited per IP address.

Farm tools (API key)

The key acts as you: it only sees the farms and groups you belong to, with your role in each. A read key only queries; a write key can also use record_entry. Revoke it from the same screen at any time. Without a key these tools are still listed and answer with instructions to create one.

Tool	What it does	Access
list_farms	Farms the key can see, role, plan and whether holder data is complete	read
list_entries	Notebook entries of a farm with compliance fields, paginated	read
entry_history	Audit trail of one entry, field by field	read
list_groups	Groups (company or cooperative) the key owner belongs to	read
group_overview	Consolidated panel of a group per farm and crop	read
advisor_portfolio	Farms an advisor reviews, with a traffic light	read
advisor_pending	Entries of a farm pending review or missing fields	read
finance_dashboard	Costs, income and margins of a farm or group per campaign	read
budget_variance	Budget vs actual per line	read
campaign_forecast	Estimated campaign close per crop (low / mid / high)	read
treasury_dues	Receivables and payables	read
cash_flow	Cash-flow forecast by week or month	read
bank_movements	Imported bank movements and match candidates	read
record_entry	Adds a new entry to the notebook	write

record_entry only adds entries: nothing in this server edits or deletes existing data. Every entry is attributed to the key owner and marked as written through the API in the audit trail. Official submission to the administration never happens here: it needs a person's session in the app.

Español

Servidor MCP del cuaderno de campo Agro GPS. Sin clave, consulta los registros oficiales de fitosanitarios de 30 países: si un producto sigue autorizado, sus sustancias, sus usos y si vale para un cultivo. Con clave (créala en agrogps.eu/app, Ajustes → API y webhooks), el asistente consulta tus explotaciones, cuaderno, grupos, cola del asesor y cuentas; con write además registra labores nuevas. La clave ve solo tus explotaciones y nunca borra ni edita nada. El envío oficial a la administración no pasa por aquí.

Development

npm ci
npm run lint && npm test && npm run build
node build/index.js

npm run pages regenerates src/data/product-pages.ts (which products have a page on agrogps.eu) from the landing repo checked out at ../landing.

License

MIT