dev.mcphost/mcphost is an MCP server published by dev.mcphost, hosted at mcphost.dev. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 18 tools, including signup, host.quickstart, host.help.search, host.help.get, host.errors.
Hosted MCP runtime where your agent publishes its own tools by tool call and keeps working.
Nothing else in the archive shares these values.
Inferred from the host name and headers: what a server runs on, not who runs it.
Explicit signup, for a client that cannot keep a session across calls: create a tenant and receive a bearer key and namespace. Unauthenticated. Most clients never need this -- any other host.*/billing.* call from a fresh connection creates a tenant implicitly and returns its own /u/<secret>/mcp URL in the response's onboarding field. Recommended here: pass handoff: true to receive a short-lived, single-use handoff_token instead of the raw key -- redeem it once with host.redeem to get the key, so a transcript of this call and the redeem call, if it leaks, carries a dead credential. The raw-key path (handoff omitted) stays fully supported.
| Parameter | Type | Description |
|---|---|---|
| name * | string | display name |
| source | string | Optional attribution tag for this signup (1-64 chars matching the pattern), e.g. "plugin", "www", "cli", "hn"; omit for none. Stored as the tenant's signup_source and counted in the signup-source funnel. Attribution only: whether a signup is real or synthetic is decided by the harness header and fle… |
| handoff |
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.
| boolean |
| Recommended: true to receive a handoff_token (redeem via host.redeem) instead of the raw key. Default false (raw key, unchanged). |
{
"name": "signup",
"description": "Explicit signup, for a client that cannot keep a session across calls: create a tenant and receive a bearer key and namespace. Unauthenticated. Most clients never need this -- any other host.*/billing.* call from a fresh connection creates a tenant implicitly and returns its own /u/<secret>/mcp URL in the response's onboarding field. Recommended here: pass handoff: true to receive a short-lived, single-use handoff_token instead of the raw key -- redeem it once with host.redeem to get the key, so a transcript of this call and the redeem call, if it leaks, carries a dead credential. The raw-key path (handoff omitted) stays fully supported.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "display name"
},
"source": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._-]{0,63}$",
"description": "Optional attribution tag for this signup (1-64 chars matching the pattern), e.g. \"plugin\", \"www\", \"cli\", \"hn\"; omit for none. Stored as the tenant's signup_source and counted in the signup-source funnel. Attribution only: whether a signup is real or synthetic is decided by the harness header and fleet IP, never by this value. \"synthorg\" is reserved for the discovery-chain harness."
},
"handoff": {
"type": "boolean",
"description": "Recommended: true to receive a handoff_token (redeem via host.redeem) instead of the raw key. Default false (raw key, unchanged)."
}
},
"additionalProperties": false
}
}Return the shortest ordered sequence of calls to a working tool of `kind`, with your namespace and a filled-in example already substituted in, plus the current limits and a try_before_call table naming the one dry-run tool for each case. Read-only -- this call alone never creates a tenant. Call this before host.tool_publish if you're not sure what a spec should look like. Unauthenticated callers get a worked example with no tenant data; any other host.*/billing.* call creates a tenant on first use, no signup required.
| Parameter | Type | Description |
|---|---|---|
| kind | string | Which registered kind to return a worked example for, e.g. echo, http, python -- or a job-word alias (webhook, event, cron, ...) for its recipe. Omit to see every kind, alias and recipe name. |
| tenant_key | string | 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 conn… |
| retry_after_s | integer | Seconds a rate-limited signup said to wait; an error's next_call carries it back here. Informational, never required. |
{
"name": "host.quickstart",
"description": "Return the shortest ordered sequence of calls to a working tool of `kind`, with your namespace and a filled-in example already substituted in, plus the current limits and a try_before_call table naming the one dry-run tool for each case. Read-only -- this call alone never creates a tenant. Call this before host.tool_publish if you're not sure what a spec should look like. Unauthenticated callers get a worked example with no tenant data; any other host.*/billing.* call creates a tenant on first use, no signup required.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"kind": {
"type": "string",
"description": "Which registered kind to return a worked example for, e.g. echo, http, python -- or a job-word alias (webhook, event, cron, ...) for its recipe. Omit to see every kind, alias and recipe name."
},
"tenant_key": {
"type": "string",
"description": "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."
},
"retry_after_s": {
"type": "integer",
"description": "Seconds a rate-limited signup said to wait; an error's next_call carries it back here. Informational, never required."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"properties": {
"hint": {
"type": [
"string",
"null"
]
},
"kind": {
"type": [
"string",
"null"
]
},
"next": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"call": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"arguments": {
"type": [
"object",
"null"
]
},
"alternative_call": {
"type": [
"string",
"null"
]
},
"alternative_arguments": {
"type": [
"object",
"null"
],
"properties": {
"args": {
"type": [
"object",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"kinds": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"steps": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"call": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"arguments": {
"type": [
"object",
"null"
]
},
"alternative_call": {
"type": [
"string",
"null"
]
},
"alternative_arguments": {
"type": [
"object",
"null"
],
"properties": {
"args": {
"type": [
"object",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
}
}
}
}
}
},
"verbs": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"limits": {
"type": [
"object",
"null"
],
"properties": {
"plan": {
"type": [
"object",
"null"
]
},
"forwarding": {
"type": [
"boolean",
"null"
]
},
"name_pattern": {
"type": [
"string",
"null"
]
},
"max_spec_bytes": {
"type": [
"integer",
"null"
]
},
"output_bytes_max": {
"type": [
"integer",
"null"
]
},
"call_timeout_max_s": {
"type": [
"integer",
"null"
]
},
"max_tools_per_tenant": {
"type": [
"integer",
"null"
]
},
"concurrent_calls_host": {
"type": [
"integer",
"null"
]
},
"call_timeout_default_s": {
"type": [
"integer",
"null"
]
},
"request_body_bytes_max": {
"type": [
"integer",
"null"
]
},
"concurrent_calls_per_tenant": {
"type": [
"integer",
"null"
]
}
}
},
"recipe": {
"type": [
"object",
"string",
"null"
],
"properties": {
"docs": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"steps": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"tool": {
"type": [
"string",
"null"
]
},
"args_example": {
"type": [
"object",
"null"
]
}
}
}
}
}
},
"aliases": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"example": {
"type": [
"object",
"null"
],
"properties": {
"args": {
"type": [
"object",
"null"
]
},
"tool": {
"type": [
"string",
"null"
]
}
}
},
"outcome": {
"type": [
"string",
"null"
]
},
"recipes": {
"type": [
"array",
"object",
"null"
],
"items": {
"type": "string"
}
},
"verdict": {
"type": [
"string",
"null"
]
},
"contract": {
"type": [
"object",
"null"
],
"properties": {
"families": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"source_line": {
"type": [
"boolean",
"null"
]
}
},
"description": "The asked kind's KindContract summary: the error families its failures carry and whether they carry data.source_line."
},
"endpoint": {
"type": [
"string",
"null"
]
},
"triggers": {
"type": [
"string",
"null"
]
},
"namespace": {
"type": [
"string",
"null"
]
},
"doc_anchor": {
"type": [
"string",
"null"
]
},
"next_steps": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
},
"sandbox_api": {
"type": [
"object",
"null"
],
"properties": {
"attrs": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"import": {
"type": [
"string",
"null"
]
},
"modules": {
"type": [
"object",
"null"
],
"properties": {
"mcphost.msg": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"mcphost.docs": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"mcphost.drift": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"mcphost.state": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"mcphost.table": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"mcphost.channel": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"mcphost.lineage": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
}
}
},
"not_a_module": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
}
}
},
"spec_fields": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"alt_endpoint": {
"type": [
"string",
"null"
]
},
"reachability": {
"type": [
"string",
"null"
]
},
"starter_tool": {
"type": [
"object",
"null"
],
"properties": {
"kind": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"spec": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"method": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
},
"test_call": {
"type": [
"object",
"null"
],
"properties": {
"call": {
"type": [
"string",
"null"
]
},
"arguments": {
"type": [
"object",
"null"
]
}
}
},
"publish_call": {
"type": [
"object",
"null"
],
"properties": {
"call": {
"type": [
"string",
"null"
]
},
"arguments": {
"type": [
"object",
"null"
]
}
}
}
}
},
"welcome_back": {
"type": [
"object",
"null"
],
"properties": {
"notes": {
"type": [
"integer",
"null"
]
},
"last_note": {},
"last_seen": {
"type": [
"string",
"null"
]
},
"since_you_left": {
"type": [
"object",
"null"
],
"properties": {
"days": {
"type": [
"integer",
"null"
]
},
"runs": {
"type": [
"integer",
"null"
]
},
"calls": {
"type": [
"integer",
"null"
]
},
"inbox": {
"type": [
"integer",
"null"
]
}
}
}
}
},
"authenticated": {
"type": [
"boolean",
"null"
]
},
"install_links": {
"type": [
"object",
"null"
],
"properties": {
"cursor": {
"type": [
"string",
"null"
]
},
"vscode": {
"type": [
"string",
"null"
]
},
"mcp_url": {
"type": [
"string",
"null"
]
},
"surfaces": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"kind": {
"type": [
"string",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"checked": {
"type": [
"string",
"null"
]
},
"doc_url": {
"type": [
"string",
"null"
]
},
"artefact": {
"type": [
"string",
"null"
]
}
}
}
},
"claude_ai_steps": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"claude_code_command": {
"type": [
"string",
"null"
]
}
}
},
"resolved_from": {
"type": [
"string",
"null"
]
},
"bridge_returns": {
"type": [
"object",
"null"
],
"properties": {
"mcphost.call": {
"type": [
"string",
"null"
]
},
"mcphost.docs.get": {
"type": [
"string",
"null"
]
},
"mcphost.msg.send": {
"type": [
"object",
"null"
],
"properties": {
"seq": {
"type": [
"string",
"null"
]
},
"refused": {
"type": [
"string",
"null"
]
},
"thread_id": {
"type": [
"string",
"null"
]
},
"message_id": {
"type": [
"string",
"null"
]
},
"delivered_to": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.progress": {
"type": [
"string",
"null"
]
},
"mcphost.msg.inbox": {
"type": [
"object",
"null"
],
"properties": {
"messages": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.get": {
"type": [
"string",
"null"
]
},
"mcphost.state.set": {
"type": [
"object",
"null"
],
"properties": {
"key": {
"type": [
"string",
"null"
]
},
"set": {
"type": [
"string",
"null"
]
},
"bytes_delta": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.list": {
"type": [
"object",
"null"
],
"properties": {
"keys": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.drop": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"dropped": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.list": {
"type": [
"object",
"null"
],
"properties": {
"tables": {
"type": [
"string",
"null"
]
},
"bytes_used": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.docs.search": {
"type": [
"object",
"null"
],
"properties": {
"index": {
"type": [
"string",
"null"
]
},
"results": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.query": {
"type": [
"object",
"null"
],
"properties": {
"rows": {
"type": [
"string",
"null"
]
},
"table": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.chart": {
"type": [
"object",
"null"
],
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"schema": {
"type": [
"string",
"null"
]
},
"caption": {
"type": [
"string",
"null"
]
},
"profile": {
"type": [
"string",
"null"
]
},
"row_count": {
"type": [
"string",
"null"
]
},
"vega_lite": {
"type": [
"string",
"null"
]
},
"recommendation": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.query": {
"type": [
"object",
"null"
],
"properties": {
"rows": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.channel.post": {
"type": [
"object",
"null"
],
"properties": {
"seq": {
"type": [
"string",
"null"
]
},
"post_id": {
"type": [
"string",
"null"
]
},
"channel_id": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"from_address": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.channel.read": {
"type": [
"object",
"null"
],
"properties": {
"posts": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.delete": {
"type": [
"object",
"null"
],
"properties": {
"key": {
"type": [
"string",
"null"
]
},
"deleted": {
"type": [
"string",
"null"
]
},
"bytes_delta": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.insert": {
"type": [
"object",
"null"
],
"properties": {
"ids": {
"type": [
"string",
"null"
]
},
"table": {
"type": [
"string",
"null"
]
},
"inserted": {
"type": [
"string",
"null"
]
},
"bytes_delta": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.append": {
"type": [
"object",
"null"
],
"properties": {
"ids": {
"type": [
"string",
"null"
]
},
"table": {
"type": [
"string",
"null"
]
},
"appended": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.create": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"created": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.schema": {
"type": [
"object",
"null"
],
"properties": {
"rows": {
"type": [
"string",
"null"
]
},
"table": {
"type": [
"string",
"null"
]
},
"columns": {
"type": [
"string",
"null"
]
},
"bytes_used": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.drift.reviews": {
"type": [
"object",
"null"
],
"properties": {
"reviews": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.lineage.trace": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"kind": {
"type": [
"string",
"null"
]
},
"uses": {
"type": [
"string",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"orphaned": {
"type": [
"string",
"null"
]
},
"upstream": {
"type": [
"string",
"null"
]
},
"downstream": {
"type": [
"string",
"null"
]
},
"downstream_count": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.table_drop": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"dropped": {
"type": [
"string",
"null"
]
},
"bytes_delta": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.delete_rows": {
"type": [
"object",
"null"
],
"properties": {
"table": {
"type": [
"string",
"null"
]
},
"deleted": {
"type": [
"string",
"null"
]
},
"bytes_delta": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.state.table_create": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"created": {
"type": [
"string",
"null"
]
},
"bytes_delta": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.lineage.blast_radius": {
"type": [
"object",
"null"
],
"properties": {
"impacted": {
"type": [
"string",
"null"
]
},
"truncated": {
"type": [
"string",
"null"
]
}
}
},
"mcphost.table.query(handle=True)": {
"type": [
"object",
"null"
],
"properties": {
"bytes": {
"type": [
"string",
"null"
]
},
"stats": {
"type": [
"string",
"null"
]
},
"table": {
"type": [
"string",
"null"
]
},
"handle": {
"type": [
"string",
"null"
]
},
"sample": {
"type": [
"string",
"null"
]
},
"columns": {
"type": [
"string",
"null"
]
},
"row_count": {
"type": [
"string",
"null"
]
},
"sample_cap": {
"type": [
"string",
"null"
]
},
"derived_from": {
"type": [
"string",
"null"
]
},
"expires_unix": {
"type": [
"string",
"null"
]
}
}
}
}
},
"recipes_nearby": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"install_doc_url": {
"type": [
"string",
"null"
]
},
"try_before_call": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"call": {
"type": [
"string",
"null"
]
},
"case": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"arguments": {
"type": [
"object",
"null"
]
}
}
}
},
"host_steps_allowed": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Search this host's own documentation and tool descriptions. Returns up to k hits (default 3, response under 2 KB), each with a snippet, the nearest runnable example and an anchor. Read-only, anonymous, no tenant data -- call it with the error text or import line you are stuck on before reading any docs file.
| Parameter | Type | Description |
|---|---|---|
| k | integer | How many hits to return (default 3). |
| q * | string | What you are stuck on: a tool name, an error code or message, an import line. |
| kind | string | Only search the page of this registered kind (docs/kinds/<kind>.md). |
| tenant_key | string | 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 conn… |
{
"name": "host.help.search",
"description": "Search this host's own documentation and tool descriptions. Returns up to k hits (default 3, response under 2 KB), each with a snippet, the nearest runnable example and an anchor. Read-only, anonymous, no tenant data -- call it with the error text or import line you are stuck on before reading any docs file.",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"k": {
"type": "integer",
"default": 3,
"maximum": 5,
"minimum": 1,
"description": "How many hits to return (default 3)."
},
"q": {
"type": "string",
"description": "What you are stuck on: a tool name, an error code or message, an import line."
},
"kind": {
"enum": [
"chain",
"echo",
"http",
"jq",
"js",
"python",
"wasm"
],
"type": "string",
"description": "Only search the page of this registered kind (docs/kinds/<kind>.md)."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"hits",
"index_version",
"total"
],
"properties": {
"hint": {
"type": [
"string",
"null"
]
},
"hits": {
"type": "array",
"items": {
"type": "object",
"required": [
"anchor",
"score",
"snippet",
"title"
],
"properties": {
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"anchor": {
"type": "string"
},
"example": {
"type": [
"object",
"null"
],
"required": [
"anchor",
"code",
"lang"
],
"properties": {
"code": {
"type": "string"
},
"lang": {
"type": "string"
},
"anchor": {
"type": "string"
},
"truncated": {
"type": [
"boolean",
"null"
]
}
}
},
"snippet": {
"type": "string"
},
"next_tool": {
"type": [
"string",
"null"
]
}
}
}
},
"total": {
"type": "integer"
},
"index_version": {
"type": "string"
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Return the documentation section an anchor points at: its text (at most 4 KB) and its first fenced example. Pass an anchor exactly as an error, hint or help entry printed it, e.g. a rate_limited error's `anchor`. Read-only, anonymous, no tenant data. An unknown anchor is anchor_not_found with the nearest anchors in did_you_mean.
| Parameter | Type | Description |
|---|---|---|
| anchor * | string | A `<path>#<slug>` anchor, e.g. README.md#call-limits, as printed by an error's `anchor` field or a `host.help.search` hit. `<path>#top` and a bare `<path>` (e.g. docs/kinds/chain.md) both return that document's first section. |
| tenant_key | string | 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 conn… |
{
"name": "host.help.get",
"description": "Return the documentation section an anchor points at: its text (at most 4 KB) and its first fenced example. Pass an anchor exactly as an error, hint or help entry printed it, e.g. a rate_limited error's `anchor`. Read-only, anonymous, no tenant data. An unknown anchor is anchor_not_found with the nearest anchors in did_you_mean.",
"inputSchema": {
"type": "object",
"required": [
"anchor"
],
"properties": {
"anchor": {
"type": "string",
"description": "A `<path>#<slug>` anchor, e.g. README.md#call-limits, as printed by an error's `anchor` field or a `host.help.search` hit. `<path>#top` and a bare `<path>` (e.g. docs/kinds/chain.md) both return that document's first section."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"anchor",
"line",
"path",
"text",
"title"
],
"properties": {
"line": {
"type": "integer"
},
"path": {
"type": "string"
},
"text": {
"type": "string"
},
"title": {
"type": "string"
},
"anchor": {
"type": "string"
},
"example": {
"type": [
"object",
"null"
],
"required": [
"code",
"lang"
],
"properties": {
"code": {
"type": "string"
},
"lang": {
"type": "string"
}
}
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}List every error code this host can return, each with its class (agent_fault | host_refusal | upstream_fault | plan_limit | host_fault), family, remedy, docs anchor, retryable flag and help_url -- the same object GET /errors.json serves. Pass code to get one row; a misspelt code answers tool_not_found with did_you_mean. Read-only, anonymous, no tenant data.
| Parameter | Type | Description |
|---|---|---|
| code | string | An error code, e.g. tool_exception. Omit to list every code. |
| tenant_key | string | 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 conn… |
{
"name": "host.errors",
"description": "List every error code this host can return, each with its class (agent_fault | host_refusal | upstream_fault | plan_limit | host_fault), family, remedy, docs anchor, retryable flag and help_url -- the same object GET /errors.json serves. Pass code to get one row; a misspelt code answers tool_not_found with did_you_mean. Read-only, anonymous, no tenant data.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"code": {
"type": "string",
"description": "An error code, e.g. tool_exception. Omit to list every code."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"properties": {
"code": {
"type": [
"string",
"null"
]
},
"class": {
"type": [
"string",
"null"
]
},
"codes": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"class",
"code",
"docs_anchor",
"family",
"help_url",
"remedy",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"class": {
"type": "string"
},
"family": {
"type": "string"
},
"remedy": {
"type": "string"
},
"help_url": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"docs_anchor": {
"type": "string"
}
}
}
},
"family": {
"type": [
"string",
"null"
]
},
"remedy": {
"type": [
"string",
"null"
]
},
"classes": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"version": {
"type": [
"string",
"null"
]
},
"help_url": {
"type": [
"string",
"null"
]
},
"retryable": {
"type": [
"boolean",
"null"
]
},
"docs_anchor": {
"type": [
"string",
"null"
]
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Exchange a signup(handoff: true) handoff_token for the tenant key it was issued for. Single-use: a second redemption fails with handoff_token_redeemed; past its expiry it fails with handoff_token_expired. Unauthenticated -- the token itself is the proof.
| Parameter | Type | Description |
|---|---|---|
| tenant_key | string | 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 conn… |
| handoff_token * | string | The handoff_token signup(handoff: true) returned. |
{
"name": "host.redeem",
"description": "Exchange a signup(handoff: true) handoff_token for the tenant key it was issued for. Single-use: a second redemption fails with handoff_token_redeemed; past its expiry it fails with handoff_token_expired. Unauthenticated -- the token itself is the proof.",
"inputSchema": {
"type": "object",
"required": [
"handoff_token"
],
"properties": {
"tenant_key": {
"type": "string",
"description": "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."
},
"handoff_token": {
"type": "string",
"description": "The handoff_token signup(handoff: true) returned."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"key",
"next",
"session_bound",
"usage"
],
"properties": {
"key": {
"type": "string"
},
"next": {
"type": "string"
},
"usage": {
"type": "string"
},
"session_bound": {
"type": "boolean"
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}The plan catalog (price and quotas per plan) and whether Stripe billing is configured on this host. Anonymous callers get the same answer as tenants.
| Parameter | Type | Description |
|---|---|---|
| tenant_key | string | 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 conn… |
{
"name": "billing.plans",
"description": "The plan catalog (price and quotas per plan) and whether Stripe billing is configured on this host. Anonymous callers get the same answer as tenants.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"billing_mode",
"plans"
],
"properties": {
"plans": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"tools_max": {
"type": [
"integer",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"secrets_max": {
"type": [
"integer",
"null"
]
},
"calls_per_day": {
"type": [
"integer",
"null"
]
},
"org_members_max": {
"type": [
"integer",
"null"
]
},
"price_usd_month": {
"type": [
"integer",
"null"
]
},
"calls_included_month": {
"type": [
"integer",
"null"
]
},
"overage_usd_per_1000_calls": {
"type": [
"integer",
"null"
]
}
}
}
},
"billing_mode": {
"type": "string"
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Return the calling tenant's identity, including key_age_s and key_rotated_at for auditing credential hygiene.
| Parameter | Type | Description |
|---|---|---|
| tenant_key | string | 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 conn… |
{
"name": "host.whoami",
"description": "Return the calling tenant's identity, including key_age_s and key_rotated_at for auditing credential hygiene.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"contract_sha",
"contract_version"
],
"properties": {
"key": {
"type": [
"object",
"null"
],
"properties": {
"kind": {
"type": [
"string",
"null"
]
},
"depth": {
"type": [
"integer",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"parent": {
"type": [
"string",
"null"
]
},
"scopes": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"can_delegate": {
"type": [
"boolean",
"null"
]
}
}
},
"hint": {
"type": [
"string",
"null"
]
},
"next": {
"type": [
"object",
"null"
],
"properties": {
"why": {
"type": [
"string",
"null"
]
},
"tool": {
"type": [
"string",
"null"
]
}
}
},
"plan": {
"type": [
"string",
"null"
]
},
"admin": {
"type": [
"boolean",
"null"
]
},
"links": {
"type": [
"object",
"null"
],
"properties": {
"help": {
"type": [
"string",
"null"
]
},
"plans": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"support": {
"type": [
"string",
"null"
]
}
}
},
"owner": {
"type": [
"object",
"null"
],
"properties": {
"verified_at": {
"type": [
"integer",
"null"
]
}
}
},
"source": {
"type": [
"string",
"null"
]
},
"tenant": {
"type": [
"string",
"null"
]
},
"clients": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"this": {
"type": [
"boolean",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
},
"client_id": {
"type": [
"string",
"null"
]
},
"last_seen": {
"type": [
"integer",
"null"
]
},
"client_name": {
"type": [
"string",
"null"
]
}
}
}
},
"subject": {
"type": [
"string",
"null"
]
},
"disabled": {
"type": [
"boolean",
"null"
]
},
"join_url": {
"type": [
"string",
"null"
]
},
"resource": {
"type": [
"string",
"null"
]
},
"claim_url": {
"type": [
"string",
"null"
]
},
"client_id": {
"type": [
"string",
"null"
]
},
"key_age_s": {
"type": [
"integer",
"null"
]
},
"namespace": {
"type": [
"string",
"null"
]
},
"activation": {
"type": [
"object",
"null"
],
"properties": {
"first_call_s": {
"type": [
"integer",
"null"
]
},
"next_milestone": {
"type": [
"object",
"null"
]
},
"first_publish_s": {
"type": [
"integer",
"null"
]
},
"first_own_call_s": {
"type": [
"integer",
"null"
]
},
"second_session_s": {
"type": [
"integer",
"null"
]
}
}
},
"created_at": {
"type": [
"string",
"null"
]
},
"invite_url": {
"type": [
"string",
"null"
]
},
"onboarding": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"tenant": {
"type": [
"string",
"null"
]
},
"claim_url": {
"type": [
"string",
"null"
]
},
"invite_url": {
"type": [
"string",
"null"
]
},
"invited_by": {
"type": [
"string",
"null"
]
},
"memory_hint": {
"type": [
"string",
"null"
]
},
"memory_line": {
"type": [
"string",
"null"
]
},
"shared_tools": {
"type": [
"array",
"null"
]
}
}
},
"plan_since": {},
"auth_method": {
"type": [
"string",
"null"
]
},
"client_name": {
"type": [
"string",
"null"
]
},
"contract_sha": {
"type": "string"
},
"display_name": {
"type": [
"string",
"null"
]
},
"metadata_url": {
"type": [
"string",
"null"
]
},
"shared_tools": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"via": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"owner": {
"type": [
"string",
"null"
]
}
}
}
},
"source_class": {
"type": [
"string",
"null"
]
},
"welcome_back": {
"type": [
"object",
"null"
],
"properties": {
"notes": {
"type": [
"integer",
"null"
]
},
"last_note": {
"type": [
"string",
"null"
]
},
"last_seen": {
"type": [
"string",
"null"
]
},
"since_you_left": {
"type": [
"object",
"null"
],
"properties": {
"days": {
"type": [
"integer",
"null"
]
},
"runs": {
"type": [
"integer",
"null"
]
},
"calls": {
"type": [
"integer",
"null"
]
},
"inbox": {
"type": [
"integer",
"null"
]
}
}
}
}
},
"client_version": {
"type": [
"string",
"null"
]
},
"key_rotated_at": {
"type": [
"integer",
"null"
]
},
"owner_verified": {
"type": [
"boolean",
"null"
]
},
"session_tenant": {
"type": [
"string",
"null"
]
},
"naming_rule_url": {
"type": [
"string",
"null"
]
},
"contract_version": {
"type": "string"
},
"admin_schema_version": {
"type": [
"integer",
"null"
]
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Publish a tool of a registered kind (e.g. python, http or echo; the kind argument's enum lists them all) under this tenant's namespace. Call host.quickstart(kind) first for a filled-in example spec and the full publish-to-call sequence. Python's sandbox API: import mcphost (mcphost.table, mcphost.state, mcphost.docs). Name must match ^[a-z][a-z0-9_]{1,40}$; a rejection names the failing field and a corrected example. Try host.tool_test before a real call.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | Which registered kind to publish under: one of this field's `enum` (host.quickstart with no kind lists every kind, alias and recipe). A job-word alias in the enum also resolves here -- webhook-style words for an inbound webhook, cron-style words for a timed run -- both resolve to kind http and the d… |
| name * | string | Local name for the new tool; must match ^[a-z][a-z0-9_]{1,40}$. |
| spec * | object | The kind-specific spec object; see host.quickstart(kind) for a filled-in example. For python's network field: "none" (every plan), "public" (requires the pro plan), "egress" (requires the pro plan) -- a tool's own code reaches this tenant's data with `import mcphost` (mcphost.table, mcphost.state, m… |
| tags | array | Catalog tags: at most 16, each 1-32 chars of a-z, 0-9 and '-', stored lower-case and deduped. |
| force | boolean | Publish a chain whose mapping can never resolve (verdict will_fail) anyway; the response's gates entry then carries forced: true. Default false. |
| scopes | array | OAuth scopes a token must carry (directly, or via mcp) to reach this tool: catalogued names from host.oauth.scopes, or the built-ins read/write. At most 8. Omit (or [] ) to require only mcp -- unaffected by any catalog. |
| dry_run | boolean | return the diff this call would make and commit nothing |
| tenant_key | string | 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 conn… |
| visibility | string | Who may find the tool (default private). unlisted: callable by full name and readable by host.catalog.get, never listed. public: listed in the catalog, and refused (untested_tool_cannot_be_public) unless the current version passes its dry run first. Use host.tool_share for group or url. |
{
"name": "host.tool_publish",
"description": "Publish a tool of a registered kind (e.g. python, http or echo; the kind argument's enum lists them all) under this tenant's namespace. Call host.quickstart(kind) first for a filled-in example spec and the full publish-to-call sequence. Python's sandbox API: import mcphost (mcphost.table, mcphost.state, mcphost.docs). Name must match ^[a-z][a-z0-9_]{1,40}$; a rejection names the failing field and a corrected example. Try host.tool_test before a real call.",
"inputSchema": {
"type": "object",
"allOf": [
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "chain"
}
}
},
"then": {
"properties": {
"spec": {
"type": "object",
"required": [
"steps"
],
"properties": {
"ui": {
"type": "object",
"properties": {
"form": {
"type": "boolean"
},
"submit_label": {
"type": "string",
"maxLength": 40
},
"success_text": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.",
"additionalProperties": false
},
"reads": {
"description": "tables this tool reads, recorded for lineage and blast-radius reports"
},
"steps": {},
"outputs": {
"description": "fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"
},
"description": {
"description": "the tool's description in `tools/list` (every kind)"
}
},
"additionalProperties": false
}
}
}
},
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "echo"
}
}
},
"then": {
"properties": {
"spec": {
"type": "object",
"required": [
"schema"
],
"properties": {
"ui": {
"type": "object",
"properties": {
"form": {
"type": "boolean"
},
"submit_label": {
"type": "string",
"maxLength": 40
},
"success_text": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.",
"additionalProperties": false
},
"reads": {
"description": "tables this tool reads, recorded for lineage and blast-radius reports"
},
"schema": {},
"outputs": {
"description": "fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"
},
"description": {
"description": "the tool's description in `tools/list` (every kind)"
}
},
"additionalProperties": false
}
}
}
},
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "http"
}
}
},
"then": {
"properties": {
"spec": {
"type": "object",
"properties": {
"ui": {
"type": "object",
"properties": {
"form": {
"type": "boolean"
},
"submit_label": {
"type": "string",
"maxLength": 40
},
"success_text": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.",
"additionalProperties": false
},
"url": {},
"body": {},
"query": {},
"reads": {
"description": "tables this tool reads, recorded for lineage and blast-radius reports"
},
"method": {},
"headers": {},
"outputs": {
"description": "fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"
},
"response": {},
"upstream": {},
"timeout_s": {},
"args_schema": {},
"description": {
"description": "the tool's description in `tools/list` (every kind)"
},
"upstream_provider": {}
},
"additionalProperties": false
}
}
}
},
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "jq"
}
}
},
"then": {
"properties": {
"spec": {
"type": "object",
"required": [
"program"
],
"properties": {
"ui": {
"type": "object",
"properties": {
"form": {
"type": "boolean"
},
"submit_label": {
"type": "string",
"maxLength": 40
},
"success_text": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.",
"additionalProperties": false
},
"reads": {
"description": "tables this tool reads, recorded for lineage and blast-radius reports"
},
"outputs": {
"description": "fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"
},
"program": {},
"timeout_s": {},
"args_schema": {},
"description": {
"description": "the tool's description in `tools/list` (every kind)"
},
"max_output_bytes": {}
},
"additionalProperties": false
}
}
}
},
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "js"
}
}
},
"then": {
"properties": {
"spec": {
"type": "object",
"required": [
"source"
],
"properties": {
"ui": {
"type": "object",
"properties": {
"form": {
"type": "boolean"
},
"submit_label": {
"type": "string",
"maxLength": 40
},
"success_text": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.",
"additionalProperties": false
},
"env": {
"description": "a map of name to string value; names must match ^[A-Z][A-Z0-9_]{0,63}$"
},
"reads": {
"description": "tables this tool reads, recorded for lineage and blast-radius reports"
},
"source": {
"description": "a string"
},
"network": {
"description": "\"none\" (every plan), \"public\" (requires the pro plan), \"egress\" (requires the pro plan) -- a tool's own code reaches this tenant's data with `import mcphost` (mcphost.table, mcphost.state, mcphost.docs, mcphost.lineage) even when network is \"none\""
},
"outputs": {
"description": "a list of field names or an object mapping field names to path strings"
},
"secrets": {
"description": "a list of strings"
},
"memory_mb": {
"description": "a positive integer number of megabytes"
},
"timeout_s": {
"description": "a positive integer number of seconds"
},
"args_schema": {
"description": "a JSON Schema object"
},
"description": {
"description": "a string"
}
},
"additionalProperties": false
}
}
}
},
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "python"
}
}
},
"then": {
"properties": {
"spec": {
"type": "object",
"required": [
"source"
],
"properties": {
"ui": {
"type": "object",
"properties": {
"form": {
"type": "boolean"
},
"submit_label": {
"type": "string",
"maxLength": 40
},
"success_text": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.",
"additionalProperties": false
},
"env": {
"description": "a map of name to string value; names must match ^[A-Z][A-Z0-9_]{0,63}$"
},
"reads": {
"description": "tables this tool reads, recorded for lineage and blast-radius reports"
},
"source": {
"description": "a string"
},
"network": {
"description": "\"none\" (every plan), \"public\" (requires the pro plan), \"egress\" (requires the pro plan) -- a tool's own code reaches this tenant's data with `import mcphost` (mcphost.table, mcphost.state, mcphost.docs, mcphost.lineage) even when network is \"none\""
},
"outputs": {
"description": "a list of field names or an object mapping field names to path strings"
},
"secrets": {
"description": "a list of strings"
},
"memory_mb": {
"description": "a positive integer number of megabytes"
},
"timeout_s": {
"description": "a positive integer number of seconds"
},
"args_schema": {
"description": "a JSON Schema object"
},
"description": {
"description": "a string"
},
"requirements": {
"description": "a list of strings"
}
},
"additionalProperties": false
}
}
}
},
{
"if": {
"required": [
"kind"
],
"properties": {
"kind": {
"const": "wasm"
}
}
},
"then": {
"properties": {
"spec": {
"type": "object",
"required": [
"component"
],
"properties": {
"ui": {
"type": "object",
"properties": {
"form": {
"type": "boolean"
},
"submit_label": {
"type": "string",
"maxLength": 40
},
"success_text": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional presentation hints. `form: true` gives a url-shared tool a /f/ page where a person fills in the arguments and the submission lands in your inbox.",
"additionalProperties": false
},
"reads": {
"description": "tables this tool reads, recorded for lineage and blast-radius reports"
},
"outputs": {
"description": "fields a caller can rely on in `result.payload`, optionally with a `$.a.b` path each (every kind)"
},
"component": {},
"memory_mb": {},
"timeout_s": {},
"args_schema": {},
"description": {
"description": "the tool's description in `tools/list` (every kind)"
}
},
"additionalProperties": false
}
}
}
}
],
"required": [
"name",
"kind",
"spec"
],
"properties": {
"kind": {
"enum": [
"chain",
"echo",
"http",
"jq",
"js",
"python",
"wasm",
"event",
"events",
"webhook",
"webhooks",
"inbound",
"trigger",
"inbox",
"cron",
"schedule",
"scheduled",
"doc",
"docs",
"document",
"documents",
"message",
"messages",
"msg",
"database",
"db",
"table",
"tables",
"csv",
"sql",
"schedules",
"uptime",
"probe",
"probes",
"memory",
"memories"
],
"type": "string",
"description": "Which registered kind to publish under: one of this field's `enum` (host.quickstart with no kind lists every kind, alias and recipe). A job-word alias in the enum also resolves here -- webhook-style words for an inbound webhook, cron-style words for a timed run -- both resolve to kind http and the descriptor comes back with resolved_from naming the alias you asked for. Error contract per kind: chain (families: compose, tool_state, chain_spec; source_line: no); echo (families: none; source_line: no); http (families: upstream, http_call; source_line: no); jq (families: tool_code, tool_limit; source_line: no); js (families: tool_code, tool_limit, upstream, compose, tool_state, js_spec; source_line: yes); python (families: tool_code, tool_limit, upstream, compose, tool_state, python_call; source_line: yes); wasm (families: tool_code, tool_limit; source_line: no)."
},
"name": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "Local name for the new tool; must match ^[a-z][a-z0-9_]{1,40}$."
},
"spec": {
"type": "object",
"description": "The kind-specific spec object; see host.quickstart(kind) for a filled-in example. For python's network field: \"none\" (every plan), \"public\" (requires the pro plan), \"egress\" (requires the pro plan) -- a tool's own code reaches this tenant's data with `import mcphost` (mcphost.table, mcphost.state, mcphost.docs, mcphost.lineage) even when network is \"none\"."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Catalog tags: at most 16, each 1-32 chars of a-z, 0-9 and '-', stored lower-case and deduped."
},
"force": {
"type": "boolean",
"description": "Publish a chain whose mapping can never resolve (verdict will_fail) anyway; the response's gates entry then carries forced: true. Default false."
},
"scopes": {
"type": "array",
"items": {
"type": "string"
},
"description": "OAuth scopes a token must carry (directly, or via mcp) to reach this tool: catalogued names from host.oauth.scopes, or the built-ins read/write. At most 8. Omit (or [] ) to require only mcp -- unaffected by any catalog."
},
"dry_run": {
"type": "boolean",
"description": "return the diff this call would make and commit nothing"
},
"tenant_key": {
"type": "string",
"description": "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": {
"enum": [
"private",
"unlisted",
"public"
],
"type": "string",
"description": "Who may find the tool (default private). unlisted: callable by full name and readable by host.catalog.get, never listed. public: listed in the catalog, and refused (untested_tool_cannot_be_public) unless the current version passes its dry run first. Use host.tool_share for group or url."
}
},
"x-deprecated": {
"sunset": "2026-12-31",
"replaced_by": "host.tool.publish"
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"hint": {
"type": [
"string",
"null"
]
},
"kind": {
"type": [
"string",
"null"
]
},
"lock": {
"type": [
"object",
"null"
],
"properties": {
"hashes": {
"type": [
"boolean",
"null"
]
},
"packages": {
"type": [
"integer",
"null"
]
}
}
},
"name": {
"type": [
"string",
"null"
]
},
"next": {
"type": [
"object",
"null"
],
"properties": {
"why": {
"type": [
"string",
"null"
]
},
"tool": {
"type": [
"string",
"null"
]
}
}
},
"gates": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"fix": {
"type": [
"string",
"null"
]
},
"gate": {
"type": [
"string",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"verdict": {
"type": [
"string",
"null"
]
},
"evidence": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
},
"failures": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
}
}
}
},
"steps": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"hint": {
"type": [
"string",
"null"
]
},
"step": {
"type": [
"integer",
"null"
]
},
"tool": {
"type": [
"string",
"null"
]
},
"prev_fields": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"prev_fields_source": {
"type": [
"string",
"null"
]
}
}
}
},
"reason": {
"type": [
"string",
"null"
]
},
"verdict": {
"type": [
"string",
"null"
]
},
"version": {
"type": [
"integer",
"null"
],
"description": "The tool's version after this publish (1 for a first publish)."
},
"evidence": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"path": {
"type": [
"string",
"null"
]
},
"step": {
"type": [
"integer",
"null"
]
},
"available": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"did_you_mean": {
"type": [
"string",
"null"
]
},
"predecessor_keys": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
}
}
}
},
"failures": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"path": {
"type": [
"string",
"null"
]
},
"step": {
"type": [
"integer",
"null"
]
},
"available": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
},
"did_you_mean": {
"type": [
"string",
"null"
]
},
"predecessor_keys": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
}
}
}
}
},
"warnings": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"ceiling",
"ceiling_field",
"code",
"effective",
"field",
"message",
"plan",
"requested"
],
"properties": {
"code": {
"enum": [
"timeout_clamped"
],
"type": "string"
},
"plan": {
"type": "string"
},
"field": {
"type": "string"
},
"ceiling": {
"type": "integer"
},
"message": {
"type": "string"
},
"effective": {
"type": "integer"
},
"requested": {
"type": "integer"
},
"ceiling_field": {
"type": "string"
}
}
}
},
"call_line": {
"type": [
"string",
"null"
],
"description": "A ready-to-paste call for the published tool. Optional: declared so a typed client reserves the field; absent from responses that do not carry one."
},
"tool_lint": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"fix": {
"type": [
"string",
"null"
]
},
"line": {
"type": [
"integer",
"null"
]
},
"rule": {
"type": [
"string",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"source_line": {
"type": [
"string",
"null"
]
}
}
},
"description": "Advisory publish-time lint findings for a python tool ([] when clean); a finding never blocks the publish."
},
"onboarding": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"tenant": {
"type": [
"string",
"null"
]
},
"claim_url": {
"type": [
"string",
"null"
]
},
"memory_hint": {
"type": [
"string",
"null"
]
},
"memory_line": {
"type": [
"string",
"null"
]
}
}
},
"deprecations": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"path": {
"type": [
"string",
"null"
]
},
"since": {
"type": [
"string",
"null"
]
},
"sunset": {
"type": [
"string",
"null"
]
},
"replacement": {
"type": [
"string",
"null"
]
}
}
}
},
"welcome_back": {
"type": [
"object",
"null"
],
"properties": {
"notes": {
"type": [
"integer",
"null"
]
},
"last_note": {},
"last_seen": {
"type": [
"string",
"null"
]
},
"since_you_left": {
"type": [
"object",
"null"
],
"properties": {
"days": {
"type": [
"integer",
"null"
]
},
"runs": {
"type": [
"integer",
"null"
]
},
"calls": {
"type": [
"integer",
"null"
]
},
"inbox": {
"type": [
"integer",
"null"
]
}
}
}
}
},
"resolved_from": {
"type": [
"string",
"null"
]
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Invoke a tool this tenant has already published, by its local name -- the same real, metered call as calling it directly by its namespaced name (<namespace>.<name>), for a session that has no way to see its own namespaced tool name yet. Unlike host.tool_test, this counts toward host.usage and appears in host.tool_logs. Pass async: true for a tool that needs more than the call deadline: returns {run_id, status: "queued"} immediately instead of running inline -- see host.runs.get/wait. Pass version to pin the call to one of host.tool_history's versions instead of whichever is current.
| Parameter | Type | Description |
|---|---|---|
| args | object | Arguments to pass, validated against the tool's own args_schema. |
| name * | string | Local name of the tool to invoke. |
| async | boolean | Run as a job instead of inline: returns {run_id, status} within ~50ms under the plan's job_max_s deadline; default false. |
| budget | object | Lowers this call's budget below the plan default: any subset of max_child_calls, max_est_tokens, max_tool_latency_ms, max_wall_ms. A value above the plan's own ceiling is a validation error naming it; see host.runs.get's progress.budget. |
| dry_run | boolean | Ask instead of call: runs every admission check the real call runs, dispatches nothing, writes no call row, and returns {fits, units, remaining, refusal}; same as host.estimate. Default false. |
| version | integer | Pin the call to this version instead of whichever is current; see host.tool_history. An unknown version is an argument error. |
| tenant_key | string | 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 conn… |
{
"name": "host.tool_call",
"description": "Invoke a tool this tenant has already published, by its local name -- the same real, metered call as calling it directly by its namespaced name (<namespace>.<name>), for a session that has no way to see its own namespaced tool name yet. Unlike host.tool_test, this counts toward host.usage and appears in host.tool_logs. Pass async: true for a tool that needs more than the call deadline: returns {run_id, status: \"queued\"} immediately instead of running inline -- see host.runs.get/wait. Pass version to pin the call to one of host.tool_history's versions instead of whichever is current.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"args": {
"type": "object",
"description": "Arguments to pass, validated against the tool's own args_schema."
},
"name": {
"type": "string",
"description": "Local name of the tool to invoke."
},
"async": {
"type": "boolean",
"description": "Run as a job instead of inline: returns {run_id, status} within ~50ms under the plan's job_max_s deadline; default false."
},
"budget": {
"type": "object",
"properties": {
"max_wall_ms": {
"type": "integer",
"maximum": 60000,
"minimum": 1,
"description": "Free-plan ceiling 60000; pro ceiling 600000. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan."
},
"max_est_tokens": {
"type": "integer",
"maximum": 200000,
"minimum": 1,
"description": "Free-plan ceiling 200000; pro ceiling 2000000. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan."
},
"max_child_calls": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Free-plan ceiling 20; pro ceiling 50. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan."
},
"max_tool_latency_ms": {
"type": "integer",
"maximum": 30000,
"minimum": 1,
"description": "Free-plan ceiling 30000; pro ceiling 120000. Maximum shown is the free floor -- see host.quickstart limits.plan.budget for your plan."
}
},
"description": "Lowers this call's budget below the plan default: any subset of max_child_calls, max_est_tokens, max_tool_latency_ms, max_wall_ms. A value above the plan's own ceiling is a validation error naming it; see host.runs.get's progress.budget."
},
"dry_run": {
"type": "boolean",
"description": "Ask instead of call: runs every admission check the real call runs, dispatches nothing, writes no call row, and returns {fits, units, remaining, refusal}; same as host.estimate. Default false."
},
"version": {
"type": "integer",
"description": "Pin the call to this version instead of whichever is current; see host.tool_history. An unknown version is an argument error."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-deprecated": {
"sunset": "2026-12-31",
"replaced_by": "host.tool.call"
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"properties": {
"data": {},
"state": {},
"result": {},
"call_id": {
"type": [
"string",
"null"
]
},
"dry_run": {},
"verdict": {},
"stale_test": {},
"client_tool": {
"type": [
"string",
"null"
]
},
"forwarded_to": {
"type": [
"string",
"null"
]
},
"tested_version": {}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Dry-run a published tool by name: verdict (pass/will_fail/unverifiable), writes rolled back (dry_run); see host.quickstart.
| Parameter | Type | Description |
|---|---|---|
| args | object | Arguments to pass, same shape as a real call. Omit to run one example generated from the tool's args_schema; the response then carries example_args (what ran) and untyped (keys the schema gave no type for). |
| name * | string | Local name of the already-published tool to dry-run. |
| fixtures | object | Chain tools only: {"<step number or tool name>": <recorded result>}. A fixtured step executes nothing (no upstream call); later mappings resolve against it. host.runs.get(run_id, as_fixtures=true) exports a real run in this shape. |
| tenant_key | string | 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 conn… |
{
"name": "host.tool_test",
"description": "Dry-run a published tool by name: verdict (pass/will_fail/unverifiable), writes rolled back (dry_run); see host.quickstart.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"args": {
"type": "object",
"description": "Arguments to pass, same shape as a real call. Omit to run one example generated from the tool's args_schema; the response then carries example_args (what ran) and untyped (keys the schema gave no type for)."
},
"name": {
"type": "string",
"description": "Local name of the already-published tool to dry-run."
},
"fixtures": {
"type": "object",
"description": "Chain tools only: {\"<step number or tool name>\": <recorded result>}. A fixtured step executes nothing (no upstream call); later mappings resolve against it. host.runs.get(run_id, as_fixtures=true) exports a real run in this shape."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-deprecated": {
"sunset": "2026-12-31",
"replaced_by": "host.tool.test"
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"dry_run"
],
"properties": {
"data": {},
"state": {},
"result": {},
"call_id": {
"type": [
"string",
"null"
]
},
"dry_run": {},
"verdict": {},
"stale_test": {},
"client_tool": {
"type": [
"string",
"null"
]
},
"forwarded_to": {
"type": [
"string",
"null"
]
},
"tested_version": {}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Write one key in this tenant's key-value state namespace; value may be any JSON value. Overrun of the plan's state_bytes_max quota fails with state_quota_exceeded and writes nothing.
| Parameter | Type | Description |
|---|---|---|
| key * | string | Key to write in this tenant's key-value state namespace. |
| value * | ["string","number","integer","boolean","… | Any JSON value to store under key. |
| dry_run | boolean | return the diff this call would make and commit nothing |
| end_user | ["string","null"] | "self" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value. |
| tenant_key | string | 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 conn… |
{
"name": "host.state.set",
"description": "Write one key in this tenant's key-value state namespace; value may be any JSON value. Overrun of the plan's state_bytes_max quota fails with state_quota_exceeded and writes nothing.",
"inputSchema": {
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"description": "Key to write in this tenant's key-value state namespace."
},
"value": {
"type": [
"string",
"number",
"integer",
"boolean",
"array",
"object",
"null"
],
"description": "Any JSON value to store under key."
},
"dry_run": {
"type": "boolean",
"description": "return the diff this call would make and commit nothing"
},
"end_user": {
"type": [
"string",
"null"
],
"description": "\"self\" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"anyOf": [
{
"type": "object",
"required": [
"bytes_delta",
"key",
"set"
]
},
{
"type": "object",
"required": [
"would",
"_meta"
],
"properties": {
"_meta": {
"type": "object",
"required": [
"dry_run"
],
"properties": {
"dry_run": {
"const": true
},
"scratch": {
"type": "boolean"
}
}
},
"would": {
"type": "object",
"additionalProperties": {
"type": "array"
}
},
"confirm": {
"type": "string"
}
}
}
],
"properties": {
"key": {
"type": "string"
},
"set": {
"type": "boolean"
},
"bytes_delta": {
"type": "integer"
},
"impersonated": {
"type": [
"boolean",
"null"
]
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Read one key from this tenant's key-value state namespace. Returns found: false (not an error) if the key was never set.
| Parameter | Type | Description |
|---|---|---|
| key * | string | Key to read from this tenant's key-value state namespace. |
| end_user | ["string","null"] | "self" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value. |
| tenant_key | string | 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 conn… |
{
"name": "host.state.get",
"description": "Read one key from this tenant's key-value state namespace. Returns found: false (not an error) if the key was never set.",
"inputSchema": {
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "Key to read from this tenant's key-value state namespace."
},
"end_user": {
"type": [
"string",
"null"
],
"description": "\"self\" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"found",
"key",
"value"
],
"properties": {
"key": {
"type": "string"
},
"found": {
"type": "boolean"
},
"value": {},
"impersonated": {
"type": [
"boolean",
"null"
]
},
"updated_unix": {
"type": [
"integer",
"null"
]
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}List keys (with their current values) in this tenant's key-value state namespace, optionally filtered by prefix.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max keys to return; default 100. |
| prefix | string | Only list keys starting with this prefix; default: all keys. |
| end_user | ["string","null"] | "self" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value. |
| tenant_key | string | 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 conn… |
{
"name": "host.state.list",
"description": "List keys (with their current values) in this tenant's key-value state namespace, optionally filtered by prefix.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"description": "Max keys to return; default 100."
},
"prefix": {
"type": "string",
"description": "Only list keys starting with this prefix; default: all keys."
},
"end_user": {
"type": [
"string",
"null"
],
"description": "\"self\" for the caller's own verified end-user identity, an explicit subject (only when this call carries no end-user identity of its own), or omit/null for the tenant-wide value."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"keys"
],
"properties": {
"data": {
"type": [
"object",
"null"
],
"required": [
"quota"
],
"properties": {
"quota": {
"type": "object",
"required": [
"state_bytes_max",
"state_ops_per_call_max",
"state_rows_max"
],
"properties": {
"state_rows_max": {
"type": "object",
"required": [
"limit",
"remaining",
"used"
],
"properties": {
"used": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"remaining": {
"type": "integer"
}
}
},
"state_bytes_max": {
"type": "object",
"required": [
"limit",
"remaining",
"used"
],
"properties": {
"used": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"remaining": {
"type": "integer"
}
}
},
"state_ops_per_call_max": {
"type": "object",
"required": [
"limit",
"remaining",
"used"
],
"properties": {
"used": {},
"limit": {
"type": "integer"
},
"remaining": {}
}
}
}
}
}
},
"keys": {
"type": "array",
"items": {
"type": "object",
"required": [],
"properties": {
"key": {
"type": [
"string",
"null"
]
},
"value": {},
"updated_unix": {
"type": [
"integer",
"null"
]
}
}
}
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Share one of this tenant's published tools with everyone (visibility: "public") or with a named group this tenant owns (visibility: "group", group: <name>). 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>.<name>.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Local name of the tool to share. |
| tags | array | Catalog tags merged into the tool's existing ones (same rules as host.tool_publish). |
| group | string | Required when visibility is "group"; must already exist (host.group.create). |
| scopes | array | What the grantee may do: call, read_source, fork. Default ["call"] (["call","read_source"] with expose_spec: true). url shares allow only call. |
| tenant_key | string | 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 conn… |
| visibility * | string | "public" (needs a passing dry run of the current version), "unlisted", "group" or "url". |
| description | string | Catalog-facing blurb; shown by host.catalog.search/get. |
| expose_spec | boolean | Default false. When true, any tenant this tool is shared with may call host.tool_spec_shared to read its (redacted) spec. |
| rate_per_hour_per_caller | integer | Optional cap (1..10000) on calls per hour from any one grantee. |
{
"name": "host.tool_share",
"description": "Share one of this tenant's published tools with everyone (visibility: \"public\") or with a named group this tenant owns (visibility: \"group\", group: <name>). 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>.<name>.",
"inputSchema": {
"type": "object",
"required": [
"name",
"visibility"
],
"properties": {
"name": {
"type": "string",
"description": "Local name of the tool to share."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Catalog tags merged into the tool's existing ones (same rules as host.tool_publish)."
},
"group": {
"type": "string",
"description": "Required when visibility is \"group\"; must already exist (host.group.create)."
},
"scopes": {
"type": "array",
"items": {
"enum": [
"call",
"read_source",
"fork"
],
"type": "string"
},
"minItems": 1,
"description": "What the grantee may do: call, read_source, fork. Default [\"call\"] ([\"call\",\"read_source\"] with expose_spec: true). url shares allow only call."
},
"tenant_key": {
"type": "string",
"description": "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": {
"enum": [
"unlisted",
"group",
"org",
"public",
"url"
],
"type": "string",
"description": "\"public\" (needs a passing dry run of the current version), \"unlisted\", \"group\" or \"url\"."
},
"description": {
"type": "string",
"description": "Catalog-facing blurb; shown by host.catalog.search/get."
},
"expose_spec": {
"type": "boolean",
"description": "Default false. When true, any tenant this tool is shared with may call host.tool_spec_shared to read its (redacted) spec."
},
"rate_per_hour_per_caller": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Optional cap (1..10000) on calls per hour from any one grantee."
}
},
"x-deprecated": {
"sunset": "2026-12-31",
"replaced_by": "host.tool.share"
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"description",
"expose_spec",
"group",
"name",
"visibility"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"next": {
"type": [
"object",
"null"
],
"properties": {
"why": {
"type": [
"string",
"null"
]
},
"tool": {
"type": [
"string",
"null"
]
}
}
},
"group": {
"type": [
"string",
"null"
]
},
"visibility": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"expose_spec": {
"type": "boolean"
},
"welcome_back": {
"type": [
"object",
"null"
],
"properties": {
"notes": {
"type": [
"integer",
"null"
]
},
"last_note": {},
"last_seen": {
"type": [
"string",
"null"
]
},
"since_you_left": {
"type": [
"object",
"null"
],
"properties": {
"days": {
"type": [
"integer",
"null"
]
},
"runs": {
"type": [
"integer",
"null"
]
},
"calls": {
"type": [
"integer",
"null"
]
},
"inbox": {
"type": [
"integer",
"null"
]
}
}
}
}
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Tell the host's humans what you needed: kind, up to 2048 bytes of text, optional context. Works before signup. Returns feedback_id.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | What you are telling the host. |
| text * | string | What you needed or saw; 1 to 2048 bytes after trim. |
| context | object | Optional, at most 1 KB: tool, error_code, free. |
| tenant_key | string | 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 conn… |
{
"name": "host.feedback.send",
"description": "Tell the host's humans what you needed: kind, up to 2048 bytes of text, optional context. Works before signup. Returns feedback_id.",
"inputSchema": {
"type": "object",
"required": [
"kind",
"text"
],
"properties": {
"kind": {
"enum": [
"missing_tool",
"wrong_error",
"docs_gap",
"bug",
"praise"
],
"type": "string",
"description": "What you are telling the host."
},
"text": {
"type": "string",
"minLength": 1,
"description": "What you needed or saw; 1 to 2048 bytes after trim."
},
"context": {
"type": "object",
"description": "Optional, at most 1 KB: tool, error_code, free."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"feedback_id",
"kind"
],
"properties": {
"kind": {
"type": "string"
},
"feedback_id": {
"type": "string"
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}List your own feedback (newest first, status received). Anonymous callers get [].
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max rows, up to 100; default 20. |
| tenant_key | string | 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 conn… |
{
"name": "host.feedback.list",
"description": "List your own feedback (newest first, status received). Anonymous callers get [].",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"description": "Max rows, up to 100; default 20."
},
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"count",
"feedback"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"feedback": {
"type": "array",
"items": {
"type": "object",
"required": [
"context",
"created_unix",
"feedback_id",
"kind",
"last_call_ids",
"status",
"text"
],
"properties": {
"kind": {
"type": "string"
},
"text": {
"type": "string"
},
"status": {
"type": "string"
},
"context": {},
"feedback_id": {
"type": "string"
},
"created_unix": {
"type": "integer"
},
"last_call_ids": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Resume where you left off in one call (at most 4096 bytes): your tools with each one's last call status, unfinished runs, your newest notes, what changed on the host since your last call, and one suggested next_call. truncated names any section that was cut -- call that section's own tool (host.tool.list, host.runs.list, host.note.list, host.changelog) for the rest. Read-only. An unauthenticated caller gets the onboarding block and creates no tenant.
| Parameter | Type | Description |
|---|---|---|
| tenant_key | string | 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 conn… |
{
"name": "host.resume",
"description": "Resume where you left off in one call (at most 4096 bytes): your tools with each one's last call status, unfinished runs, your newest notes, what changed on the host since your last call, and one suggested next_call. truncated names any section that was cut -- call that section's own tool (host.tool.list, host.runs.list, host.note.list, host.changelog) for the rest. Read-only. An unauthenticated caller gets the onboarding block and creates no tenant.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"tenant_key": {
"type": "string",
"description": "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."
}
},
"x-mcphost-validated": true,
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"ErrorEnvelope": {
"type": "object",
"required": [
"code",
"message",
"data"
],
"properties": {
"code": {
"type": "integer"
},
"data": {
"type": "object",
"required": [
"error_code"
],
"properties": {
"retryable": {
"type": "boolean"
},
"error_code": {
"type": "string"
}
}
},
"message": {
"type": "string"
}
}
}
},
"required": [
"next_call"
],
"properties": {
"host": {
"type": [
"object",
"null"
],
"properties": {
"changes": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
},
"version": {
"type": [
"string",
"null"
]
},
"version_at_last_call": {
"type": [
"string",
"null"
]
}
}
},
"notes": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
},
"tools": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
},
"tenant": {
"type": [
"string",
"null"
]
},
"last_seen": {
"type": [
"string",
"null"
]
},
"next_call": {
"type": "object",
"required": [
"tool"
],
"properties": {
"why": {
"type": [
"string",
"null"
]
},
"args": {
"type": [
"object",
"null"
]
},
"tool": {
"type": "string"
}
}
},
"runs_open": {
"type": [
"array",
"null"
],
"items": {
"type": "object"
}
},
"truncated": {
"type": [
"object",
"null"
],
"properties": {
"notes": {
"type": [
"boolean",
"null"
]
},
"tools": {
"type": [
"boolean",
"null"
]
},
"changes": {
"type": [
"boolean",
"null"
]
},
"runs_open": {
"type": [
"boolean",
"null"
]
}
}
},
"onboarding": {
"type": [
"object",
"null"
]
}
},
"x-error-envelope": {
"$ref": "#/$defs/ErrorEnvelope"
}
}
}Call `signup` with a display name to receive a bearer key. Recommended: pass `handoff: true` to signup instead -- you get a short-lived, single-use `handoff_token` in place of the raw key; call `host.redeem` with it once to get the key, so a transcript of the signup/redeem exchange carries a dead credential rather than a live one. If your key may have leaked, `host.key_rotate` issues a new one and kills the old one in the same call. The original raw-key path (signup without `handoff`) stays fully supported -- everything below applies to the key either path gives you. The `host.*` control plane -- including `host.tool_publish` and `host.tool_call` -- is already visible in this tools/list, before you have a key. Pass the key (from signup directly, or from host.redeem) as the `tenant_key` argument on every call after that; no reconnect and no Authorization header is required. A `host.*` call with no `tenant_key` and no Authorization header, on a connection that never ran signup, no longer fails `tenant_key_missing` -- it implicitly signs that connection up as a new tenant instead; a client that sends no `Mcp-Session-Id` finds that tenant's key in the first response's `onboarding.tenant_key` and passes it as `tenant_key` on every later call; a `tenant_key` that doesn't match any tenant still fails `tenant_key_invalid`. Result envelope contract: when a spec declares `outputs` (field names its tool emits, or a map from field name to the exact `$.a.b[0].c`-style path to read it from), each is readable at `result.payload.<field>` for every kind, regardless of how deep the tool's own response nests it -- run `host.tool_test` before publishing to see which declared fields your implementation buries. host.tool_publish's `kind` argument is honored exactly as given -- an inline `source` field only publishes as `python` and `upstream`/`method`+`url` fields only publish as `http` -- so request the kind your task needs and a mismatch returns a `kind_mismatch` error naming the disagreeing spec element instead of silently publishing the other kind. Before you call a tool for the first time, see `host.quickstart`'s `try_before_call` table for which of the four dry-run tools (host.tool_test, host.bridge_test, host.spec_test, host.tool_run) fits your case. This host implements the MCP primitives: tools, resources, prompts, sampling, elicitation (GET /capabilities.json lists every row).
Names, descriptions and schemas were written by the server and are shown as data.