Skip to main content
Glama

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

Related MCP server: agriculture-mcp-server

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

Available Tools

16 tools
advisor_pendingAdvisor pending queueA
Read-onlyIdempotent

Entries of a farm that still need review or lack mandatory fields, with the list of missing fields.

Inputs: farm_id (required).

advisor_portfolioAdvisor portfolioA
Read-onlyIdempotent

For advisors and owners: every farm they can review, with entries, missing compliance fields, pending, flagged and approved counts and a traffic light.

Inputs: no named parameters.

bank_movementsBank movementsC
Read-onlyIdempotent

Imported bank accounts with their last balance and movements, what each one was matched to and, for the unmatched ones, the best candidates with a score.

Inputs: farm_id, group_id, only_open.

budget_varianceBudget vs actualA
Read-onlyIdempotent

Budget lines (campaign x farm x crop x category) with actual spend, remaining, used percentage and status ok / warning (90%+) / over. Amounts in euro cents.

Inputs: farm_id, campaign, group_id.

campaign_forecastCampaign close forecastA
Read-onlyIdempotent

ESTIMATE of how the campaign closes per crop: expected yield x price minus costs already imputed and the budget still pending, as a low / mid / high range, total and per hectare. Says whether each assumption was saved by the farm, taken from last campaign or is missing. Always present it as an estimate.

Inputs: farm_id (required), campaign.

cash_flowCash-flow forecastB
Read-onlyIdempotent

Expected cash in and out by week or month from open receivables and payables, starting from the last imported bank balance, with overdue amounts apart.

Inputs: farm_id, horizon, group_id, granularity.

check_plant_protection_productCheck a plant protection productA
Read-onlyIdempotent

Free, no API key. Looks up one product by its official registration number in a country's register: authorisation state (authorised / withdrawn / expired), expiry date, formulation, active substances and authorised uses. With crop_eppo it also says whether the product is authorised on that crop. Includes a link to the product page.

Inputs: country (required), registration (required), crop_eppo.

entry_historyEntry historyA
Read-onlyIdempotent

Who created, edited or deleted a notebook entry and when, field by field (audit trail).

Inputs: entry_id (required).

finance_dashboardManager dashboardB
Read-onlyIdempotent

Money of a farm or a whole group for one campaign: month-by-month cost and income, cost by category (phyto, fertiliser, fuel, labour, machinery, seed, insurance, other), cost per hour per worker and per machine, margin per hectare per parcel and per crop, per-farm totals and KPIs of the last three campaigns. Amounts are integer euro cents.

Inputs: crop, farm_id, campaign, group_id.

group_overviewGroup overviewA
Read-onlyIdempotent

Consolidated panel of a group: per farm, entries, cost, income, margin, treated hectares, compliance light (green/amber/red), pending review counts and a breakdown by crop; plus totals.

Inputs: group_id (required).

list_entriesList notebook entriesA
Read-onlyIdempotent

Field notebook entries (labores) of a farm: treatments, fertilising, irrigation, sowing, harvest, expenses… with the compliance fields (Anexo II). Paginated: pass since = the next cursor of the previous page. Deleted entries come back with deleted=true so a mirror can stay in sync.

Inputs: farm_id (required), since.

list_farmsList farmsA
Read-onlyIdempotent

Farms (explotaciones) the API key can see, with the key owner's role in each, the plan and whether the holder data required for official submissions is complete. Call this first to get farm ids.

Inputs: no named parameters.

list_groupsList farm groupsA
Read-onlyIdempotent

Groups (a company or cooperative holding several farms) the key owner belongs to, with their role.

Inputs: no named parameters.

record_entryRecord a notebook entryA

Register a task in the farm's field notebook (needs a key with write scope). The entry is attributed to the key owner and marked as written by API in the audit trail; the server stores when it arrived and rejects future dates. It only adds new entries: it never edits or deletes existing ones. Confirm the farm, parcel, product and date with the user before calling it. Official submission to the administration is never done here: it needs a person's session in the app.

Inputs: title (required), farm_id (required), event_at (required), entry_type (required), +9 more.

search_plant_protection_productsSearch plant protection productsA
Read-onlyIdempotent

Free, no API key. Searches the official register of plant protection products (pesticides, fungicides, herbicides) of a European country by commercial product name and says whether each one is still authorised. Returns up to 15 matches with registration number, holder, status and a link to its page. Search by trade name (e.g. 'Roundup'), not by active substance.

Inputs: q (required), country (required).

treasury_duesReceivables and payablesB
Read-onlyIdempotent

Money to collect (receivable) and to pay (payable) with issue date, due date, paid date, status (open / overdue / paid) and days overdue, plus totals.

Inputs: status, farm_id, group_id, direction.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 16 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes: field notebook operations, product lookups, farm/group listing, compliance review, and several financial views. There is some overlap between group_overview, advisor_portfolio, and finance_dashboard in reporting metrics, but descriptions scope them differently enough for an agent to choose correctly.

    Naming Consistency4/5

    All names use consistent snake_case and are descriptive, which makes the set readable. The main deviation is that some tools use verb_noun (list_farms, record_entry) while others use noun_noun (finance_dashboard, budget_variance), but the pattern is still predictable.

    Tool Count4/5

    16 tools is slightly above the ideal 3-15 range, but the server covers multiple domains: field entries, compliance, groups/advisors, product registers, and finance. Each tool appears to earn its place, so the count is reasonable rather than excessive.

    Completeness4/5

    The surface covers core read and reporting workflows plus entry creation, audit history, compliance review, product lookups, and extensive financial views. Minor gaps exist, such as no update/delete for entries and no active-substance product search, but these appear intentional or workable around.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to the French e-phy catalog for detailed information on pesticides, fertilizers, and other phytosanitary products. It enables users to search for products, retrieve authorized usage specifications, and check the approval status of active substances.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for agriculture and farming data. 8 tools: soil conditions (temperature, moisture), crop weather forecasts, historical climate data (NASA POWER, since 1981), global agriculture statistics (World Bank, 20+ indicators), and food product database (Open Food Facts, 3M+ products). All APIs free, no keys required.
      8
      20 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      EU Crop Intelligence MCP Server — Yield forecasts, weather analysis, and phenology models for 15 countries. AI agent-native, multi-source intelligence (NASA POWER, Eurostat, Open-Meteo).
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access free, open agronomic data for field briefings, spray windows, water balance, pest pressure, and more, using only public data sources without API keys.
      1
      MIT