Regeno Farmwalk

Farmwalk for AI

Connect Claude, ChatGPT, or any AI assistant directly to your farm data using the Model Context Protocol.

https://farmwalk.app/mcp

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external data sources and tools. Instead of copy-pasting farm data into a chat window, MCP gives your AI assistant direct, secure access to Farmwalk's data and interactive maps.

How it works

1

Add the Farmwalk MCP URL to your AI client

Paste the URL into Claude Desktop, Claude Code, or ChatGPT settings.

2

Your browser opens for authentication

Farmwalk uses OAuth 2.1 — you log in with your normal account and approve access.

3

Authorise the connection

Choose which scopes to grant (read-only or read & write).

4

Start asking questions

Your AI assistant can now query your farms, agreements, evidence and more.

No API keys required

MCP uses OAuth 2.1 with PKCE \u2014 your browser handles authentication securely. There are no API keys to copy or manage. You can also use a Personal Access Token from your settings if you prefer manual setup.

What You Can Do

Farmwalk exposes 148 tools covering data queries, the SFI 2026 planner, task management and interactive visualisations \u2014 all scoped to your permissions and your token's read or write scope.

Organisations

List your organisations, view roles and membership details.

Farms

Browse farms, view SBI/CPH numbers, locations and summary stats.

Compliance & Agreements

Check SFI, Countryside Stewardship, Red Tractor and H&S scheme status.

Evidence Tracking

Review evidence links and completion status for each agreement.

Land Parcels & Maps

Query parcels, fields and hedgerows. View interactive Mapbox satellite maps.

Vault & Documents

Search documents, photos, audio and video by name or AI transcription.

Task Management

List, create and update farm tasks with priorities and assignees.

Cross-farm Search

Unified search across farms, agreements, vault files and tasks.

Consultations

Search sessions, read transcripts, review AI summaries and extracted actions.

SFI 2026 Planner

Readiness, the 25% limited-area headroom, what can stack on each parcel, and draft plans you can build and compare.

Regen Score

The farm's score, benchmark position, next recommendation and achievements.

Water, Soil & Nutrients

Water-risk flags, soil results and samples, NVZ loading and storage, management plans.

Weather & Ground

Daily rainfall, rain and ground lenses, and trafficability outlook per parcel.

Records, Diary & Reports

Statutory farm records, quick notes, the farm diary and generated reports.

Livestock & Rotations

Holdings, animal register, movements, and rotational scheme actions by year.

Health & Safety

Incidents, equipment and certificates, risk and COSHH assessments, actions and documents.

Interactive Maps

Parcel and farm maps rendered in-chat with Mapbox satellite imagery.

Compliance Dashboard

Visual dashboard of scheme scores, deadlines and payment summaries.

Installation

Add Farmwalk to your AI assistant in under a minute. Choose your client below.

Claude Desktop

Add the following to your claude_desktop_config.json file. On macOS this is at ~/Library/Application Support/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "farmwalk": {
      "url": "https://farmwalk.app/mcp"
    }
  }
}

Restart Claude Desktop after saving. On first use, your browser will open for authentication.

Available Tools

Farmwalk exposes 144 data tools and 4 interactive app tools to your AI assistant. Tools marked write need a write-scoped token; everything else runs on a read token.

Organisations & farms

Tool	Description
list_organisations	List all organisations you belong to with roles and farm counts
get_organisation	Organisation details, members and farm summary
list_org_members	Members of an organisation with their roles
get_org_member	One member's role and farm access
update_org_member_rolewrite	Change a member's role
remove_org_memberwrite	Remove a member from an organisation
transfer_org_ownershipwrite	Transfer ownership to another member
list_farms	List farms across organisations, filter by name, SBI or CPH; flags other farms sharing an SBI
get_farm	Full farm details including agreement, task, parcel and vault counts
create_farmwrite	Create a farm in an organisation
update_farmwrite	Update farm name, SBI, CPH, address or location
get_farm_contacts	Key contacts recorded for a farm
update_farm_contactswrite	Update a farm's contacts
get_farm_settings	Evidence and vault-email settings for a farm
archive_farmwrite	Archive a farm

Agreements, evidence & compliance

Tool	Description
list_agreements	List scheme agreements with filtering by farm, scheme type or status
get_agreement	Full agreement details including items, payments and inspections
get_compliance_summary	Aggregated compliance scores, item counts and upcoming deadlines
get_agreement_item	One agreement item with its evidence and land assignments
get_agreement_payments	Payment schedule and history for an agreement
create_agreementwrite	Create a scheme agreement
update_agreementwrite	Update an agreement's details or status
update_agreement_itemwrite	Update an agreement item
archive_agreementwrite	Archive an agreement
list_evidence	List evidence links across farms, filter by agreement or status
get_evidence	One evidence link with its file and notes
get_evidence_status	Evidence completion status for a specific agreement
get_compliance_timeline	Upcoming and overdue compliance events
list_evidence_suggestions	AI evidence suggestions awaiting a response
create_evidencewrite	Link a vault file as evidence
update_evidencewrite	Update an evidence link
delete_evidencewrite	Remove an evidence link
respond_to_suggestionwrite	Accept or dismiss an evidence suggestion

Land

Tool	Description
list_parcels	Every land feature with RPA reference, hectares from the mapped geometry, length, and the land use the SFI planner resolved — plus totals by type and land use
get_parcel	One feature in full, with the planner view: hectares per land use, LFA status, designations, heritage assets
get_parcel_geometry	GeoJSON geometry for a feature
get_parcel_facts	The parcel dossier: designations, crop history, terrain, satellite cover, water verdict, flood
list_hedgerows	Hedgerows with length in metres and the farm total the hedgerow actions are paid on
list_hedgerow_surveys	Hedgerow condition surveys
create_parcelwrite	Create a land feature
update_parcelwrite	Update a land feature's name, attributes or notes
archive_parcelwrite	Archive a land feature

SFI 2026 planner

Tool	Description
list_sfi_actions	The SFI 2026 catalog: rates, units, stacking rules, the 25% limited-area flag, eligible land uses
get_sfi_action	One action in full with its supplements and primaries resolved
get_sfi_planner_readiness	Is the farm's land data ready to plan? The same checklist as the planner page
get_sfi_farm_limits	Agricultural area, the 25% allowance and what live agreements already commit, the £100k/yr cap
get_sfi_parcel_options	What can go on a parcel, at what maximum, for how much per year, and why not — from the planner's own engine
list_sfi_plans	Draft and finalised plans with annual value
get_sfi_plan	One plan with its actions, summary rows and cap totals
get_sfi_plan_comparison	Two to four plans side by side
create_sfi_planwrite	Create an empty draft plan
add_sfi_plan_actionwrite	Add an action to a parcel in a draft plan — every rule re-applied server-side
remove_sfi_plan_actionwrite	Remove an action and anything that depended on it
dismiss_sfi_actionwrite	Mark an action not interested on a parcel or plan-wide
restore_sfi_actionwrite	Undo a dismissal
delete_sfi_planwrite	Remove a draft plan (kept for audit)

Water, soil & nutrients

Tool	Description
get_water_summary	Water-risk posture: open flags, watercourse distances, spreading verdicts, storage
list_water_flags	Water-risk flags by status, kind or parcel
get_parcel_water_context	Watercourses, boreholes, slope and abstraction around one parcel
get_water_readiness	Is the farm's water data complete enough to assess?
list_soil_results	Accepted soil lab results with pH and RB209 P/K/Mg indices
list_samples	The physical sample register
list_nvz_calculations	Manure-N loading per year against the 170 kg N/ha limit
get_nvz_storage	Slurry storage capacity against requirement
list_manure_inventory	Manure produced, imported and exported
list_management_plans	Nutrient and IPM management plans on file
get_management_plan	One plan with per-parcel rates

Weather & ground

Tool	Description
get_weather_day_summary	Rainfall and conditions for one day, farm or parcel
get_rain_lens	Recent and forecast rainfall per parcel
get_ground_lens	Soil moisture and workability per parcel
get_trafficability	Trafficability outlook for the days ahead

Records, diary, notes & reports

Tool	Description
list_farm_records	Statutory farm records by type, parcel and date
list_quick_notes	Quick field notes with parcel links
list_diary_entries	The chronological farm diary
list_reports	Generated reports: type, status and dates
get_rotational_overview	Rotational SFI/CS actions per parcel this year against prior years

Evidence capture

Tool	Description
create_evidence_requestwrite	Create a capture link for exactly the items you need — the chat shows the link and a QR code; photos taken on a phone land against the right parcel and action
get_evidence_request	Progress on a capture link: what has arrived, what is approved, what is still missing
list_evidence_requests	Open and closed capture requests for a farm
approve_evidence_uploadwrite	Approve an upload and link it as evidence
reject_evidence_uploadwrite	Reject an upload with a reason
delete_evidence_requestwrite	Remove a capture request nothing has been uploaded to
get_vault_inbox	The farm's vault email address and the subject tags that pre-match an attachment to an action and parcel
create_quick_notewrite	A dated field note with optional parcel and location, linkable as evidence

Reports

Tool	Description
list_report_types	The reports Farmwalk can generate and what each needs
create_reportwrite	Generate a branded report for a farm or agreement
get_report	Report status and, when ready, a short-lived download

Joining and onboarding

Tool	Description
get_onboarding_status	The set-up checklist for a new user: organisation, farm, SBI, land, first agreement — and which tool completes each
create_organisationwrite	Create your organisation; you become its owner
get_rpa_preview	How many parcels, land covers and hedgerows the RPA holds for an SBI, before anything is created
import_agreement_documentwrite	Read a scheme agreement PDF already in the vault and build a draft agreement from it
get_agreement_import	The import's stage and, when ready, the draft in plain terms: items, values, parcels matched
list_agreement_imports	Recent agreement imports for a farm
confirm_agreement_importwrite	Make a reviewed draft the live agreement
invite_memberwrite	Invite a colleague or client to your organisation; returns the link they open
list_invitations	Pending and accepted invitations for an organisation
revoke_invitationwrite	Withdraw an invitation
list_farm_sbis	The farm's SBI and any additional SBIs it holds, with land and agreement counts
add_farm_sbiwrite	Register an additional SBI on a farm, ready for its own land import

Land import

Tool	Description
import_rpa_landwrite	Import the farm's parcels, land covers and hedgerows from the RPA using its SBI
get_land_import_status	Progress of an import, or the farm's current land summary

Livestock

Tool	Description
list_livestock_holdings	Registered CPH holdings
list_livestock_animals	The animal register, by species, holding or tag
list_livestock_movements	Statutory movement records by direction, species and date

Health & safety

Tool	Description
list_hs_incidents	Incidents with RIDDOR and status summary
list_hs_equipment	Equipment with inspection and certificate due dates
list_hs_staff	Staff roles, induction and training status (no contact details)
list_hs_risk_assessments	Risk assessments with review status
list_hs_actions	Required actions with due dates
list_hs_documents	Published H&S documents (metadata only)
list_coshh_assessments	COSHH assessments and controls

Regen Score

Tool	Description
get_farm_score	The farm's current score, confidence and metric breakdown
get_benchmark_positions	Where the farm sits against its anonymised cohorts
get_score_recommendation	The next practice most likely to raise the score
get_achievements	Achievements earned and pending
get_scoring_methodology	The published scoring methodology

Vault, tasks, consultations & search

Tool	Description
list_vault_files	List vault files (documents, photos, audio, video) for a farm
search_vault	Search vault files by name, description or AI transcription
get_vault_file	One vault file with its metadata
get_vault_transcription	The AI transcription of an audio or video file
list_vault_folders	Vault folders for a farm
update_vault_filewrite	Rename, describe or move a vault file
delete_vault_filewrite	Delete a vault file
create_vault_folderwrite	Create a vault folder
list_tasks	List tasks across farms, filter by status, priority or assignee
get_task	One task with its comments and links
list_task_comments	Comments on a task
get_task_links	What a task is linked to
create_taskwrite	Create a task on a farm with title, description and priority
update_taskwrite	Update task status, priority, title, description or assignee
delete_taskwrite	Delete a task
create_task_commentwrite	Comment on a task
link_taskwrite	Link a task to an agreement, parcel or action
unlink_taskwrite	Remove a task link
list_consult_sessions	Search and list consult sessions across farms, filter by status or name
get_consult_session	Full session details including reviewed items, notes and agreements
get_consult_transcript	The full transcript for a session across all recordings
get_consult_summary	AI-generated summary and extended summary for a session
get_consult_actions	Extracted tasks and actions from a session's recordings
get_consult_share_link	A share link for a session
create_consult_sessionwrite	Start a consult session
update_consult_sessionwrite	Update a session's status or notes
search	Unified search across farms, agreements, vault files and tasks
get_analytics_summary	Cross-farm analytics summary

Interactive App Tools

These tools render interactive UI directly in the chat \u2014 satellite maps powered by Mapbox and live compliance dashboards.

show_evidence_uploader

Drop zone and camera rendered in the chat — evidence pre-labelled with the action and parcel, or (purpose: agreement) your agreement PDF, imported as a draft the moment it lands

show_parcel_map

Interactive satellite map for a specific land parcel with boundary overlay

show_farm_map

Farm-wide satellite map with parcels colour-coded by compliance status

show_compliance_dashboard

Visual dashboard with scheme scores, progress and deadlines

Authentication

Farmwalk uses OAuth 2.1 with PKCE for secure, browser-based authentication. Your AI client handles the flow automatically.

OAuth 2.1 Flow (automatic)

AI Client

Browser Login

Approve Scopes

Connected

When you first use an MCP tool, your browser opens the Farmwalk login page. After signing in, you approve the requested scopes and the token is passed back to your AI client automatically. No manual token handling required.

Scopes

Scope	Description	Allows
farmwalk:read	Read-only access	Query farms, agreements, parcels, vault files, tasks
farmwalk:write	Read & write access	Everything in read, plus create/update tasks

Personal Access Token (manual fallback)

If your MCP client doesn't support OAuth, you can use a Personal Access Token (PAT) from your Farmwalk user settings. Generate a token in Settings → Security → Personal Access Tokens and configure your client to send it as a Bearer token.

{
  "mcpServers": {
    "farmwalk": {
      "url": "https://farmwalk.app/mcp",
      "headers": {
        "Authorization": "Bearer pat.your_token_here"
      }
    }
  }
}

OAuth is recommended

OAuth tokens are scoped, automatically refreshed, and can be revoked centrally. Only use PATs when your client does not support browser-based OAuth.