Quickstart

This guide walks you through signing up, creating an API key, connecting a farmer's John Deere account, and making your first MCP call.

1. Create an Account

Sign up at the FieldMCP Dashboard. You'll get a free tier with 60 requests per minute.

2. Create an API Key

1. Go to Dashboard → API Keys
2. Click Create API Key
3. Copy the key — it starts with field_live_ and is shown only once

field_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Store this securely. See API Keys for details on key management.

3. Connect a Farmer

Before you can access a farmer's data, they need to authorize access through John Deere's OAuth flow.

1. Go to Dashboard → Farmers
2. Click Connect Farmer
3. The farmer completes the John Deere authorization flow
4. Once connected, you'll see the farmer listed with their John Deere organization

See OAuth for the full OAuth integration guide.

4. Configure Your MCP Client

Claude Desktop

Add to your Claude Desktop MCP configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "fieldmcp": {
      "url": "https://gateway.fieldmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer field_live_YOUR_API_KEY",
        "X-Farmer-Id": "FARMER_UUID"
      }
    }
  }
}

Claude Code

claude mcp add fieldmcp \
  --transport streamable-http \
  --url "https://gateway.fieldmcp.com/mcp" \
  --header "Authorization: Bearer field_live_YOUR_API_KEY" \
  --header "X-Farmer-Id: FARMER_UUID"

Custom MCP Client

Connect to the gateway using the MCP protocol over streamable HTTP:

• Endpoint: https://gateway.fieldmcp.com/mcp
• Method: POST
• Headers:
  • Authorization: Bearer <your-api-key>
  • X-Farmer-Id: <farmer-uuid>

5. Make Your First Call

Once connected, ask your MCP client to list the farmer's organizations:

List my John Deere organizations

This calls deere_list_resources with resourceType: "organizations" and returns the farmer's John Deere organizations. From there, you can query fields, equipment, and operations.

Next Steps

• API Keys — Key format, rotation, and security
• OAuth — Full John Deere OAuth integration
• Tools Reference — All 11 available tools with schemas and examples