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

15 tools are available for reading and writing plant data, AI identification, care profiles, and environment analysis.

Tool	Description
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_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.app/api/mcp",
        "--oauth2Bearer", "tnd_mcp_..."
      ]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

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

Claude Code

Add via the CLI:

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

ChatGPT

If MCP is available in your ChatGPT plan, add the Streamable HTTP endpoint in the MCP integration settings with your Bearer token as the authorization header.