For Agents
Discover Agrimetrics agri-environmental datasets, query their layers, run spatial queries with shapefiles, and download layer files via 93 catalogue endpoints.
Get started with Agrimetrics Catalog API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"list agrimetrics datasets"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Agrimetrics Catalog API API.
Authenticate against the Agrimetrics catalogue using either an APIM subscription key, a JWT, or one of the API-key schemes
Discover datasets and their associated layers via /datasets/{datasetId} and /datasets/{datasetId}/layers
Execute structured queries against the catalogue via /query for cross-dataset analysis
Upload a shapefile via /shapefile to scope subsequent queries to a custom area of interest
GET STARTED
Use for: I need to list all datasets available on Agrimetrics, Get the layers belonging to a specific Agrimetrics dataset, Find all layers tagged with a specific category, Retrieve the file contents for a chosen Agrimetrics layer
Not supported: Does not handle farm-management workflows, livestock records, or non-spatial agri analytics — use for Agrimetrics catalogue discovery, layer access, and shapefile-scoped queries only.
Jentic publishes the only available OpenAPI specification for Agrimetrics Catalog API, keeping it validated and agent-ready.
Agrimetrics Catalog API exposes the agri-environmental data catalogue published by Agrimetrics, covering datasets, layers, query execution, and shapefile uploads for spatial analysis. The 93 endpoints include dataset discovery, layer metadata, SPARQL-style query execution, and authenticated download of layer files. The base host is api-test.agrimetrics.co.uk for the test environment, with multiple authentication schemes supported: an Azure APIM subscription key (ocp-apim-subscription-key), a JWT bearer token, header- or query-style API keys, and an x-user header.
Download layer file contents via /layers/{layerId}/files for downstream processing
Patterns agents use Agrimetrics Catalog API API for, with concrete tasks.
★ Discover Datasets for an Agri Workflow
Walk the Agrimetrics catalogue programmatically to surface the datasets and layers that match an agri-environmental workflow, such as crop yield modelling or soil-type analysis. Calling /datasets/{datasetId} and /datasets/{datasetId}/layers gives the structural metadata needed to stitch together a downstream geospatial pipeline. The catalogue covers UK agri data published by Agrimetrics.
Call /datasets/{datasetId} for a candidate dataset, then /datasets/{datasetId}/layers to enumerate the layers and pick the ones that match the workflow
Spatial Query With a Custom Boundary
Upload a shapefile defining a farm boundary or a study region via /shapefile, then run /query against the Agrimetrics catalogue to retrieve only the layer values that fall within the boundary. This is the core pattern for scoped agri-environmental analysis: retrieve only the relevant pixels for a specific geographic area rather than downloading whole national layers.
POST a farm boundary shapefile to /shapefile, capture the returned id, and call /query with that boundary id and a chosen layer id
Layer File Download Pipeline
Pull layer file contents via /layers/{layerId}/files into a downstream raster or vector pipeline. The endpoint returns the underlying file references for a chosen layer, which a processing job can then download and feed into GIS tooling. This is useful when the workflow needs the raw layer data rather than catalogue metadata.
Call /layers/{layerId}/files for a chosen layer id, capture the file references, and queue them for download into the GIS pipeline
Agent Integration via Jentic
An AI agent built on Jentic can search for the Agrimetrics catalogue operations by intent and execute them without holding the APIM subscription key in agent context. Jentic's MAXsystem holds the credential and returns scoped access at call time, which matters when an agri-tech workflow combines Agrimetrics with multiple other geospatial providers.
Use Jentic search for 'list agrimetrics datasets', load the dataset endpoint, execute it, and pass the chosen dataset id into a follow-up layers call
93 endpoints — agrimetrics catalog api exposes the agri-environmental data catalogue published by agrimetrics, covering datasets, layers, query execution, and shapefile uploads for spatial analysis.
METHOD
PATH
DESCRIPTION
/authenticate
Authenticate against the catalogue
/status
Catalogue status check
/query
Run a structured catalogue query
/datasets/{datasetId}
Read a dataset by id
/datasets/{datasetId}/layers
List the layers belonging to a dataset
/shapefile
Upload a shapefile to scope subsequent queries
/layers/{layerId}
Read layer metadata by id
/layers/{layerId}/files
Get the file references for a layer
/authenticate
Authenticate against the catalogue
/status
Catalogue status check
/query
Run a structured catalogue query
/datasets/{datasetId}
Read a dataset by id
/datasets/{datasetId}/layers
List the layers belonging to a dataset
Three things that make agents converge on Jentic-routed access.
Credential isolation
Whichever Agrimetrics auth scheme you use (APIM subscription key, JWT, x-user header, or API key) is stored encrypted in the Jentic vault. Agents receive scoped execution tokens at call time and never hold the raw credential.
Intent-based discovery
Agents search by intent such as 'list agrimetrics datasets' or 'run a shapefile spatial query' and Jentic returns the matching operation across the 93 endpoints with its full input schema, so the agent can call the right endpoint without reading the docs.
Time to first call
Direct integration: 2-3 days to wire one of the auth schemes, dataset discovery, and shapefile-scoped queries. Through Jentic: under 2 hours from search to first executed call.
Alternatives and complements available in the Jentic catalogue.
NASA Open APIs
Open NASA earth and space data including imagery and asteroids feeds
Use NASA APIs to enrich Agrimetrics agri data with satellite imagery context
OpenCage Geocoding
Forward and reverse geocoding to resolve addresses around an Agrimetrics boundary
Use OpenCage to translate place names into coordinates before scoping an Agrimetrics query
Geocodio
Bulk address geocoder for joining tabular records to coordinates
Use Geocodio when you need to bulk-geocode farm or field addresses before running spatial Agrimetrics queries
Specific to using Agrimetrics Catalog API API through Jentic.
What authentication does the Agrimetrics Catalog API use?
Multiple schemes are supported: an Azure APIM subscription key in ocp-apim-subscription-key, a JWT bearer token, an apiKeyHeader or apiKeyQuery API key, and an x-user header. Use whichever matches your Agrimetrics account setup. Through Jentic the credential is held in the vault and only a scoped token is granted to the agent at call time.
Can I run spatial queries scoped to a custom boundary?
Yes. POST a shapefile to /shapefile to register a boundary, then call /query referencing that boundary id and the chosen layer id. The catalogue returns only the layer values that fall within the supplied geometry.
What are the rate limits for the Agrimetrics Catalog API?
The OpenAPI spec does not declare explicit rate limits. Treat the API as standard HTTPS and respect any 429 responses; check your Agrimetrics account dashboard for the contractual ceiling for your subscription tier.
How do I list available datasets through Jentic?
Install the Jentic SDK with pip install jentic, search for 'list agrimetrics datasets', load the dataset operation, and execute it. Sign up at https://app.jentic.com/sign-up to get a Jentic agent key.
Is api-test.agrimetrics.co.uk the production host?
No. api-test.agrimetrics.co.uk is the test host published in this spec. For production traffic you may need to repoint to the live Agrimetrics host once your Agrimetrics representative provides credentials, while keeping the same endpoint shapes.
Can I download the underlying layer files?
Yes. GET /layers/{layerId}/files returns the file references for a chosen layer, which a downstream pipeline can then fetch into GIS tooling. Pair with /datasets/{datasetId}/layers to discover which layer ids belong to a dataset.
/shapefile
Upload a shapefile to scope subsequent queries
/layers/{layerId}
Read layer metadata by id
/layers/{layerId}/files
Get the file references for a layer