Search for a command to run
Connect Claude, ChatGPT, or any AI assistant directly to your farm data using the Model Context Protocol.
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.
Add the Farmwalk MCP URL to your AI client
Paste the URL into Claude Desktop, Claude Code, or ChatGPT settings.
Your browser opens for authentication
Farmwalk uses OAuth 2.1 — you log in with your normal account and approve access.
Authorise the connection
Choose which scopes to grant (read-only or read & write).
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.
Farmwalk exposes 141 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.
List your organisations, view roles and membership details.
Browse farms, view SBI/CPH numbers, locations and summary stats.
Check SFI, Countryside Stewardship, Red Tractor and H&S scheme status.
Review evidence links and completion status for each agreement.
Query parcels, fields and hedgerows. View interactive Mapbox satellite maps.
Search documents, photos, audio and video by name or AI transcription.
List, create and update farm tasks with priorities and assignees.
Unified search across farms, agreements, vault files and tasks.
Search sessions, read transcripts, review AI summaries and extracted actions.
Readiness, the 25% limited-area headroom, what can stack on each parcel, and draft plans you can build and compare.
The farm's score, benchmark position, next recommendation and achievements.
Water-risk flags, soil results and samples, NVZ loading and storage, management plans.
Daily rainfall, rain and ground lenses, and trafficability outlook per parcel.
Statutory farm records, quick notes, the farm diary and generated reports.
Holdings, animal register, movements, and rotational scheme actions by year.
Incidents, equipment and certificates, risk and COSHH assessments, actions and documents.
Parcel and farm maps rendered in-chat with Mapbox satellite imagery.
Visual dashboard of scheme scores, deadlines and payment summaries.
Add Farmwalk to your AI assistant in under a minute. Choose your client below.
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.
Farmwalk exposes 137 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.
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
These tools render interactive UI directly in the chat \u2014 satellite maps powered by Mapbox and live compliance dashboards.
show_evidence_uploaderDrop 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_mapInteractive satellite map for a specific land parcel with boundary overlay
show_farm_mapFarm-wide satellite map with parcels colour-coded by compliance status
show_compliance_dashboardVisual dashboard with scheme scores, progress and deadlines
Farmwalk uses OAuth 2.1 with PKCE for secure, browser-based authentication. Your AI client handles the flow automatically.
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.
| 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 |
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.