{
  "name": "Shared Forest",
  "description": "Shared Forest is a free, shared illustrated forest that grows from its traffic. Every page load adds growth energy, and every visitor, human or AI agent, can plant one tree per day. The skills below are served over MCP (Streamable HTTP) at https://sharedforest.com/mcp. There is no A2A JSON-RPC endpoint.",
  "version": "1.0.0",
  "documentationUrl": "https://sharedforest.com/llms-full.txt",
  "iconUrl": "https://sharedforest.com/icon-512.png",
  "provider": {
    "organization": "Arne Kellmann",
    "url": "https://sharedforest.com/impressum"
  },
  "repository": "https://github.com/ArneFfm/shared-forest-agents",
  "supportedInterfaces": [
    {
      "url": "https://sharedforest.com/mcp",
      "protocolBinding": "MCP+HTTP",
      "protocolVersion": "2025-06-18"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "oauth2": {
      "type": "oauth2",
      "description": "OAuth 2.1 with PKCE S256. See https://sharedforest.com/auth.md.",
      "oauth2MetadataUrl": "https://sharedforest.com/.well-known/oauth-authorization-server",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://sharedforest.com/oauth/authorize",
          "tokenUrl": "https://sharedforest.com/oauth/token",
          "refreshUrl": "https://sharedforest.com/oauth/token",
          "scopes": {
            "forest:read": "Read the forest, prices and designs. Always granted; the same data is public.",
            "sponsor:write": "Start tree sponsorships in your name, within the spending limit. You still confirm and pay each order yourself.",
            "account:read": "Read your orders and your sponsored trees."
          }
        }
      }
    }
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "skills": [
    {
      "id": "get_forest_stats",
      "name": "Forest statistics",
      "description": "Read-only. Counts of trees, groves, total and unique visitors, and traffic by class (humans, agents, bots, trees planted today).",
      "tags": [
        "forest"
      ]
    },
    {
      "id": "get_forest",
      "name": "Forest summary",
      "description": "Read-only. Bounded summary of the live forest: counts per tree type, growth stage and origin, grove levels, and the newest trees (default 20, max 100).",
      "tags": [
        "forest"
      ]
    },
    {
      "id": "list_trees",
      "name": "List trees",
      "description": "Read-only. One page of trees with cursor pagination, the same data as GET /api/forest?limit=. Pass nextCursor as cursor until it is null.",
      "tags": [
        "forest"
      ]
    },
    {
      "id": "plant_tree",
      "name": "Plant a tree",
      "description": "Plant one tree in the Shared Forest for the caller. One tree per visitor per day; repeats only add growth energy. The visit counts as agent traffic. Ask the user before you call it.",
      "tags": [
        "forest"
      ]
    },
    {
      "id": "explain_shared_forest",
      "name": "Explain Shared Forest",
      "description": "Read-only. Returns the full agent guide as Markdown: growth rules, API, tools and limits.",
      "tags": [
        "forest"
      ]
    },
    {
      "id": "get_price_quote",
      "name": "Quote a tree sponsorship",
      "description": "Read-only. Price for sponsoring N trees for 12 months: unit price, total in euro cents (VAT included) and discount. Call it before you tell the user a price.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ]
    },
    {
      "id": "design_tree",
      "name": "Design a sponsored tree",
      "description": "Turns a short wish (for example 'a silver birch with lanterns') into a custom tree design. Returns design_id and the tree genome. Max 3 designs per caller per day. Show the result to the user before you order.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ]
    },
    {
      "id": "get_design",
      "name": "Read a tree design",
      "description": "Read-only. Returns one design by design_id: genome, genomeHash and expiresAt.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ]
    },
    {
      "id": "find_spots",
      "name": "Find free spots",
      "description": "Read-only. Suggests free positions for N sponsored trees, optionally near a point. Pass the spots to start_sponsorship, or omit spots there and the server picks them.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ]
    },
    {
      "id": "start_sponsorship",
      "name": "Start a tree sponsorship",
      "description": "Needs OAuth scope sponsor:write (a Shared Forest account). Creates an unpaid order for the signed-in user and holds the spots. It charges nothing. The total must fit the spending limit the user set when connecting. The order expires after 30 minutes unless the user confirms. Returns confirm_url: give it to your user. The user logs in, accepts the terms and pays on that page. Ask the user before you call it and confirm name and total.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ],
      "security": [
        {
          "oauth2": [
            "sponsor:write"
          ]
        }
      ]
    },
    {
      "id": "get_order",
      "name": "Read a sponsorship order",
      "description": "Read-only. Needs OAuth scope account:read or sponsor:write. Status of one of the user's orders (open, paid, fulfilled, expired, refunded, disputed, cancelled, refund_pending) and its tree ids once fulfilled. Poll every 10 seconds or more after the user pays.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ],
      "security": [
        {
          "oauth2": [
            "account:read"
          ]
        },
        {
          "oauth2": [
            "sponsor:write"
          ]
        }
      ]
    },
    {
      "id": "my_orders",
      "name": "My sponsorship orders",
      "description": "Read-only. Needs OAuth scope account:read. The signed-in user's sponsorship orders, newest first, with status, total and tree ids.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ],
      "security": [
        {
          "oauth2": [
            "account:read"
          ]
        }
      ]
    },
    {
      "id": "my_trees",
      "name": "My sponsored trees",
      "description": "Read-only. Needs OAuth scope account:read. The trees of the signed-in user's fulfilled orders, with a link to each tree in the forest.",
      "tags": [
        "forest",
        "sponsorship",
        "commerce"
      ],
      "security": [
        {
          "oauth2": [
            "account:read"
          ]
        }
      ]
    }
  ]
}