MCP (Model Context Protocol)

Connect AI assistants like Claude Desktop, Cursor, or ChatGPT to your plant data via the Model Context Protocol.

Endpoints

GET/api/mcp

Get MCP server info, available scopes, and tool list. No authentication required.

POST/api/mcp(per-tool)

MCP Streamable HTTP endpoint. Accepts JSON-RPC 2.0 requests. Authenticate with your Bearer token.

Available tools

18 tools are available for plant data, interactive collection and detail views, AI identification, care profiles, and environment analysis.

Tool	Description
plants_show_collection	Browse plant photo cards in MCP Apps-compatible clients
plants_show_detail	Show a plant, care guidance, and recent activity
account_profile	Identify the connected account
plants_add	Create a new plant
plants_identify	Identify a plant from an image URL
plants_resolve_care_profile	Get a care profile by species or profile key
plants_set_care_profile	Apply a care profile to a plant
plants_add_from_image	Identify, create plant, and upload photo in one step
environment_analyze_light	Estimate light level from an image
plants_check_light_match	Check light compatibility for a plant
plants_search	Search plants by name, species, or location
plants_list	List plants with care context
plants_get	Get a plant and its recent events
plants_update	Update a plant's fields
events_list	Read paginated history by date and event type
events_add	Add a care event to a plant
plants_overview	Get overview stats and attention list
plants_summary	Get per-plant summary and recent activity

Client setup

Claude Desktop

Uses a stdio bridge via supergateway. Add to your Claude Desktop config:

{
  "mcpServers": {
    "Rootnotes": {
      "command": "npx",
      "args": [
        "-y", "supergateway",
        "--streamableHttp", "https://rootnotes.io/api/mcp",
        "--oauth2Bearer", "tnd_mcp_..."
      ]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "Rootnotes": {
      "url": "https://rootnotes.io/api/mcp",
      "headers": {
        "Authorization": "Bearer tnd_mcp_..."
      }
    }
  }
}

Claude Code

Add via the CLI:

claude mcp add rootnotes \
  --transport http \
  https://rootnotes.io/api/mcp \
  -- --header "Authorization: Bearer tnd_mcp_..."

ChatGPT

Connect https://rootnotes.io/api/mcp using OAuth, with the configured public client ID and no client secret. Sign into the intended Rootnotes account and approve its requested permissions. After server updates, refresh tools or reconnect. Moss-pole watering uses mosspole_watered; event dates accept UTC or an explicit offset such as 2026-10-10T20:30:00+02:00.