Shared Forest is an MCP server published by io.github.ArneFfm, hosted at sharedforest.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 13 tools, including get_forest_stats, get_forest, list_trees, plant_tree, explain_shared_forest.
Plant or sponsor trees in a shared forest that grows from its traffic. Sponsoring uses OAuth.
6 connections through 5 shared values. Tap any node.
Read-only. Counts of trees, groves, total and unique visitors, and traffic by class (humans, agents, bots, trees planted today).
| Parameter | Type | Description |
|---|---|---|
| fields | array | Return only these counters. Omit for all counters. |
{
"name": "get_forest_stats",
"title": "Forest statistics",
"description": "Read-only. Counts of trees, groves, total and unique visitors, and traffic by class (humans, agents, bots, trees planted today).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"fields": {
"type": "array",
"items": {
"enum": [
"trees",
"groves",
"visitors",
"uniqueVisitors",
"humans",
"agents",
"bots",
"plantedToday"
],
"type": "string"
},
"description": "Return only these counters. Omit for all counters.",
"uniqueItems": true
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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).
| Parameter | Type | Description |
|---|---|---|
| bbox | array | Bounding box [minX, minY, maxX, maxY] in world coordinates. Only trees inside it are returned. |
| limit | integer | Number of newest trees to return. |
{
"name": "get_forest",
"title": "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).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"bbox": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"description": "Bounding box [minX, minY, maxX, maxY] in world coordinates. Only trees inside it are returned."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of newest trees to return."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| bbox | array | Bounding box [minX, minY, maxX, maxY] in world coordinates. Only trees inside it are returned. |
| limit * | integer | Trees per page, for example 100. |
| cursor | string | Opaque cursor from nextCursor of the previous page. |
{
"name": "list_trees",
"title": "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.",
"inputSchema": {
"type": "object",
"required": [
"limit"
],
"properties": {
"bbox": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4,
"minItems": 4,
"description": "Bounding box [minX, minY, maxX, maxY] in world coordinates. Only trees inside it are returned."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Trees per page, for example 100."
},
"cursor": {
"type": "string",
"description": "Opaque cursor from nextCursor of the previous page."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| idempotency_key | string | Optional retry key, for example a UUID. A retry with the same key within 24 hours returns the first visitId and plants nothing new. |
{
"name": "plant_tree",
"title": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"idempotency_key": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Optional retry key, for example a UUID. A retry with the same key within 24 hours returns the first visitId and plants nothing new."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Read-only. Returns the full agent guide as Markdown: growth rules, API, tools and limits.
| Parameter | Type | Description |
|---|---|---|
| section | string | Return only the section whose heading contains this text, for example 'Limits' or 'MCP tools'. Omit for the whole guide. |
{
"name": "explain_shared_forest",
"title": "Explain Shared Forest",
"description": "Read-only. Returns the full agent guide as Markdown: growth rules, API, tools and limits.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"section": {
"type": "string",
"description": "Return only the section whose heading contains this text, for example 'Limits' or 'MCP tools'. Omit for the whole guide."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read-only. Final price for sponsoring N trees for 12 months: unit price, total in euro cents and discount. Call it before you tell the user a price.
| Parameter | Type | Description |
|---|---|---|
| quantity * | integer | Number of trees, 1-100. Larger orders get a lower unit price. |
{
"name": "get_price_quote",
"title": "Quote a tree sponsorship",
"description": "Read-only. Final price for sponsoring N trees for 12 months: unit price, total in euro cents and discount. Call it before you tell the user a price.",
"inputSchema": {
"type": "object",
"required": [
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Number of trees, 1-100. Larger orders get a lower unit price."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Turns a short wish (for example 'a silver birch with lanterns') into a premium tree design. An AI paints the tree after the call (about 30 s); the first painting becomes the tree. Returns design_id and the tree genome. Max 3 design attempts per caller per day (including rejected or interrupted generation). Show the result to the user before you order.
| Parameter | Type | Description |
|---|---|---|
| wish * | string | What the tree should look like, 1-200 characters. No brands, logos or text. |
{
"name": "design_tree",
"title": "Design a sponsored tree",
"description": "Turns a short wish (for example 'a silver birch with lanterns') into a premium tree design. An AI paints the tree after the call (about 30 s); the first painting becomes the tree. Returns design_id and the tree genome. Max 3 design attempts per caller per day (including rejected or interrupted generation). Show the result to the user before you order.",
"inputSchema": {
"type": "object",
"required": [
"wish"
],
"properties": {
"wish": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "What the tree should look like, 1-200 characters. No brands, logos or text."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Read-only. Returns one design by design_id: genome, genomeHash and expiresAt.
| Parameter | Type | Description |
|---|---|---|
| design_id * | string | Design id from design_tree, for example dsn_abc123. |
{
"name": "get_design",
"title": "Read a tree design",
"description": "Read-only. Returns one design by design_id: genome, genomeHash and expiresAt.",
"inputSchema": {
"type": "object",
"required": [
"design_id"
],
"properties": {
"design_id": {
"type": "string",
"pattern": "^dsn_[A-Za-z0-9_-]{4,64}$",
"description": "Design id from design_tree, for example dsn_abc123."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| near_x | number | Optional x coordinate (0-8192) to search near. Needs near_y. |
| near_y | number | Optional y coordinate (0-8192) to search near. Needs near_x. |
| quantity * | integer | Number of trees, 1-100. Larger orders get a lower unit price. |
{
"name": "find_spots",
"title": "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.",
"inputSchema": {
"type": "object",
"required": [
"quantity"
],
"properties": {
"near_x": {
"type": "number",
"maximum": 8192,
"minimum": 0,
"description": "Optional x coordinate (0-8192) to search near. Needs near_y."
},
"near_y": {
"type": "number",
"maximum": 8192,
"minimum": 0,
"description": "Optional y coordinate (0-8192) to search near. Needs near_x."
},
"quantity": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Number of trees, 1-100. Larger orders get a lower unit price."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| link | string | Optional https link. It goes live after manual review. |
| string | Optional email for the confirmation and the invoice. Default: the email of the signed-in account. | |
| spots | array | Optional positions from find_spots, one per tree. Omit and the server picks free spots. |
| quantity * | integer | Number of trees, 1-100. Larger orders get a lower unit price. |
| link_text | string | Optional public label for the link. Requires link; approved with it. |
| design_ids * | array | One design_id for all trees, or one per tree. |
| display_name * | string | Name shown on the trees, 1-32 characters, labelled Sponsored. |
| idempotency_key * | string | Retry key, for example a UUID. A retry with the same key returns the same order. |
| short_description | string | Optional short public description. Requires link; approved with it. |
{
"name": "start_sponsorship",
"title": "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.",
"inputSchema": {
"type": "object",
"required": [
"quantity",
"design_ids",
"display_name",
"idempotency_key"
],
"properties": {
"link": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"maxLength": 2048,
"description": "Optional https link. It goes live after manual review."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 254,
"description": "Optional email for the confirmation and the invoice. Default: the email of the signed-in account."
},
"spots": {
"type": "array",
"items": {
"type": "object",
"required": [
"x",
"y"
],
"properties": {
"x": {
"type": "number",
"maximum": 8192,
"minimum": 0
},
"y": {
"type": "number",
"maximum": 8192,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1,
"description": "Optional positions from find_spots, one per tree. Omit and the server picks free spots."
},
"quantity": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Number of trees, 1-100. Larger orders get a lower unit price."
},
"link_text": {
"type": "string",
"maxLength": 50,
"description": "Optional public label for the link. Requires link; approved with it."
},
"design_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^dsn_[A-Za-z0-9_-]{4,64}$",
"description": "Design id."
},
"maxItems": 100,
"minItems": 1,
"description": "One design_id for all trees, or one per tree."
},
"display_name": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "Name shown on the trees, 1-32 characters, labelled Sponsored."
},
"idempotency_key": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Retry key, for example a UUID. A retry with the same key returns the same order."
},
"short_description": {
"type": "string",
"maxLength": 160,
"description": "Optional short public description. Requires link; approved with it."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | Order id from start_sponsorship, for example ord_abc123. |
{
"name": "get_order",
"title": "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.",
"inputSchema": {
"type": "object",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9_-]{4,64}$",
"description": "Order id from start_sponsorship, for example ord_abc123."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Read-only. Needs OAuth scope account:read. The signed-in user's sponsorship orders, newest first, with status, total and tree ids.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of orders, 1-50. |
{
"name": "my_orders",
"title": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Number of orders, 1-50."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of trees, 1-500. |
{
"name": "my_trees",
"title": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"default": 100,
"maximum": 500,
"minimum": 1,
"description": "Number of trees, 1-500."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. Use get_forest_stats, get_forest or list_trees to read the forest. Call plant_tree only when the user asks to plant a tree. To sponsor trees for the user (paid, 12 months, a name and an optional link on each tree): call get_price_quote, design_tree, find_spots, then start_sponsorship, and give the returned confirm_url to the user. The user confirms and pays there; you cannot pay for the user. Then poll get_order. start_sponsorship, get_order, my_orders and my_trees need a Shared Forest account: connect this server with OAuth (the user logs in and sets a spending limit). All other tools work without authentication. Documentation questions: use the docs server at /mcp/docs.
Names, descriptions and schemas were written by the server and are shown as data.