mcphost

host.tool_share

Share one of this tenant's published tools with everyone (visibility: "public") or with a named group this tenant owns (visibility: "group", group: ). The tool keeps running in this tenant's own sandbox with this tenant's own secrets; a caller reaches it as <this tenant's namespace>..

Input Schema

TableJSON Schema

Name	Required	Description
`name`	Yes	Local name of the tool to share.
`group`	No	Required when visibility is "group"; must already exist (host.group.create).
`tenant_key`	No	The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins.
`visibility`	Yes	"public" or "group".
`description`	No	Catalog-facing blurb; shown by host.catalog.search/get.
`expose_spec`	No	Default false. When true, any tenant this tool is shared with may call host.tool_spec_shared to read its (redacted) spec.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`url`	No
`name`	Yes
`next`	No
`group`	Yes
`visibility`	Yes
`description`	Yes
`expose_spec`	Yes
`welcome_back`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed13 schema fields changedOct 16, 2026
- changedOutput schema / properties / next / properties / tool / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
- changedOutput schema / properties / next / properties / why / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
- changedOutput schema / properties / next / type
```
Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
```
- changedOutput schema / properties / url / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
- removedOutput schema / properties / welcome_back / properties / last_note / type
```
Removed value: -"null"
```
- changedOutput schema / properties / welcome_back / properties / last_seen / type
```
Previous value: -"string"New value: +[
+  "string",
+  "null"
+]
```
- changedOutput schema / properties / welcome_back / properties / notes / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- changedOutput schema / properties / welcome_back / properties / since_you_left / properties / calls / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- changedOutput schema / properties / welcome_back / properties / since_you_left / properties / days / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- changedOutput schema / properties / welcome_back / properties / since_you_left / properties / inbox / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- changedOutput schema / properties / welcome_back / properties / since_you_left / properties / runs / type
```
Previous value: -"integer"New value: +[
+  "integer",
+  "null"
+]
```
- changedOutput schema / properties / welcome_back / properties / since_you_left / type
```
Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
```
- changedOutput schema / properties / welcome_back / type
```
Previous value: -"object"New value: +[
+  "object",
+  "null"
+]
```

Changed1 schema field changedOct 12, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "description": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "expose_spec": {
+      "type": "boolean"
+    },
+    "group": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "name": {
+      "type": "string"
+    },
+    "next": {
+      "properties": {
+        "tool": {
+          "type": "string"
+        },
+        "why": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "url": {
+      "type": "string"
+    },
+    "visibility": {
+      "type": "string"
+    },
+    "welcome_back": {
+      "properties": {
+        "last_note": {
+          "type": "null"
+        },
+        "last_seen": {
+          "type": "string"
+        },
+        "notes": {
+          "type": "integer"
+        },
+        "since_you_left": {
+          "properties": {
+            "calls": {
+              "type": "integer"
+            },
+            "days": {
+              "type": "integer"
+            },
+            "inbox": {
+              "type": "integer"
+            },
+            "runs": {
+              "type": "integer"
+            }
+          },
+          "type": "object"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "required": [
+    "description",
+    "expose_spec",
+    "group",
+    "name",
+    "visibility"
+  ],
+  "type": "object"
+}

Changed1 schema field changedOct 4, 2026

changedInput schema / properties / tenant_key / description

Previous value: -"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. Required only when this connection carries no Authorization: Bearer header and never ran signup -- when both a header and this argument are present, the header wins. Omitting it on such a connection returns tenant_key_missing (-32602)."New value: +"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. On a connection with no Authorization: Bearer header and no prior signup, omitting it implicitly signs that connection up as a brand-new tenant and runs this call as it -- see host.whoami's source field. When both a header and this argument are present, the header wins."

Changed1 schema field changedOct 4, 2026

addedInput schema / x-deprecated

Added value: +{
+  "replaced_by": "host.tool.share",
+  "sunset": "2026-12-31"
+}

Changed1 schema field changedOct 3, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```

Changed1 schema field changedSep 30, 2026

changedInput schema / properties / tenant_key / description

Previous value: -"The key `signup` returned. Required only when this connection carries no Authorization: Bearer header -- when both are present, the header wins. Omitting it on a connection with no header returns tenant_key_missing (-32602)."New value: +"The key `signup` returned. Optional on the connection that ran signup (or host.redeem): that connection is already bound to the tenant it created, so later calls on it need no tenant_key. Required only when this connection carries no Authorization: Bearer header and never ran signup -- when both a header and this argument are present, the header wins. Omitting it on such a connection returns tenant_key_missing (-32602)."

Changed1 schema field changedSep 30, 2026

changedInput schema / properties / tenant_key / description

Previous value: -"The key `signup` returned. Required only when this connection carries no Authorization: Bearer header -- when both are present, the header wins."New value: +"The key `signup` returned. Required only when this connection carries no Authorization: Bearer header -- when both are present, the header wins. Omitting it on a connection with no header returns tenant_key_missing (-32602)."

Changed1 schema field changedSep 28, 2026

addedInput schema / properties / expose_spec

Added value: +{
+  "description": "Default false. When true, any tenant this tool is shared with may call host.tool_spec_shared to read its (redacted) spec.",
+  "type": "boolean"
+}

AddedSep 11, 2026

TDQS

Score is being calculated.

All mcphost tools Inspect

Try in Browser

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

host.tool_share

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources