~ knotless Search/
↑↓ move↵ open⇧↵ all results

chadtmiller.com/hud

A remote MCP server that shows atproto records as interactive UI inside MCP Apps hosts

0
0
86 lines · 2.4 KB Raw History
{
	"lexicon": 1,
	"id": "place.hud.callTool",
	"description": "Call one of HUD's tools.",
	"defs": {
		"main": {
			"type": "procedure",
			"description": "Call one of HUD's tools as the person, as an MCP client's tools/call does: what a tile draws. The canvas tools are an agent's, not called here. Requires auth: the workspace's web session (its cookie, with X-HUD: 1 and the server's own Origin on a procedure) or a HUD access token as Bearer.",
			"input": {
				"encoding": "application/json",
				"schema": {
					"type": "object",
					"required": [
						"name"
					],
					"properties": {
						"name": {
							"type": "string",
							"maxLength": 64,
							"description": "The tool, by its MCP name."
						},
						"arguments": {
							"type": "unknown",
							"description": "Its arguments, an object."
						},
						"kit": {
							"type": "ref",
							"ref": "#kit",
							"description": "The renderer drawing the result's tree, an app's built on HUD: the tree is fitted to its version, what it can't draw left out or drawn as it can. Called by Bearer without it, the oldest kit's; by the workspace's page, as current as HUD."
						}
					}
				}
			},
			"output": {
				"encoding": "application/json",
				"schema": {
					"type": "object",
					"required": [
						"result"
					],
					"properties": {
						"result": {
							"type": "unknown",
							"description": "The tool's MCP CallToolResult: content, structuredContent, isError and _meta. A tool's error is its result's, isError true."
						}
					}
				}
			},
			"errors": [
				{
					"name": "InvalidRequest",
					"description": "No such tool, a canvas tool, or input not what the method takes."
				},
				{
					"name": "AuthRequired",
					"description": "No live session, or its sign-in at the person's PDS ended: sign in again."
				}
			]
		},
		"kit": {
			"type": "object",
			"description": "A kit, HUD's renderer on a platform, as it says itself, as an MCP client's place.hud/kit capability does.",
			"required": [
				"platform",
				"version"
			],
			"properties": {
				"platform": {
					"type": "string",
					"maxLength": 32,
					"knownValues": [
						"ios",
						"android",
						"web"
					],
					"description": "The platform it draws on."
				},
				"version": {
					"type": "string",
					"maxLength": 64,
					"description": "Its version, the HUD SDK version it was built from, as 0.3.0."
				}
			}
		}
	}
}