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 24 tools covering data queries, task management, and interactive visualisations \u2014 all scoped to your permissions.

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.

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 21 data tools and 3 interactive app tools to your AI assistant.

Data Tools

Tool	Description
list_organisations	List all organisations you belong to with roles and farm counts
list_farms	List farms across organisations, filter by name, SBI or CPH number
get_farm	Get full farm details including agreement, task, parcel and vault counts
list_agreements	List scheme agreements with filtering by farm, scheme type or status
get_agreement	Get full agreement details including items, payments and inspections
get_compliance_summary	Aggregated compliance scores, item counts and upcoming deadlines
list_evidence	List evidence links across farms, filter by agreement or status
get_evidence_status	Evidence completion status for a specific agreement
list_parcels	List land features (parcels, fields, hedgerows) for a farm
get_parcel	Detailed parcel info including geometry and linked scheme items
list_vault_files	List vault files (documents, photos, audio, video) for a farm
search_vault	Search vault files by name, description or AI transcription
list_tasks	List tasks across farms, filter by status, priority or assignee
create_task	Create a new task on a farm with title, description and priority
update_task	Update task status, priority, title, description or assignee
search	Unified search across farms, agreements, vault files and tasks
list_consult_sessions	Search and list consult sessions across farms, filter by status or name
get_consult_session	Get full session details including reviewed items, notes and agreements
get_consult_transcript	Get the full transcript for a session across all recordings
get_consult_summary	Get AI-generated summary and extended summary for a session
get_consult_actions	Get extracted tasks and actions from a session's recordings

Interactive App Tools

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

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.