MCP-Tool-Aufruf

Der MCP-HTTP-Transport. Ein einziger JSON-RPC-2.0-Endpunkt, der alle MCP-Tools von Metapad bedient (get_metamodel, search_nodes, create_nodes usw.) — setzen Sie „method“ auf die JSON-RPC-Methode („tools/call“, „tools/list“, „initialize“, „ping“) und geben Sie den Tool-Namen samt Argumenten in „params“ an. Es ist derselbe Endpunkt, mit dem sich Claude Desktop, Claude Code und andere MCP-Clients verbinden — nutzen Sie ihn direkt aus Skripten und CI, wenn kein interaktiver OAuth-Login möglich ist. Zu unterscheiden von den REST-API-v1-Endpunkten unter /api/v1/..., die einzelne Ressourcen klassisch als REST bereitstellen.

AuthentifizierungBearer mpt_... or OAuth JWT

Plan-AnforderungPro+

Parameter

Name	Typ	Pflichtfeld	Standard	Beschreibung
`id`	`Number \| String`	—		[MCP-Tool-Aufruf] Vom Client gewählte Anfrage-ID, die in der Antwort zurückgegeben wird. Zahl oder Zeichenkette. Feld im Body. Bei Notifications weglassen (z. B. notifications/initialized).
`params`	`Object`	—		[MCP-Tool-Aufruf] Parameter der Methode. Für „tools/call“ ist dies {"name": "<tool>", "arguments": {...}}, wobei „name“ ein API-Tool auswählt und „arguments“ dessen Eingaben enthält. Für „tools/list“, „initialize“ und „ping“ genügt ein leeres Objekt. Feld im Body.
`model_id`	`String (UUID)`	✓		[MCP-Tool-Aufruf] UUID des Modells, auf dem der Aufruf arbeitet. Pfadparameter — das API-Token muss Zugriff auf dieses Modell haben.
`method`	`String`	✓		[MCP-Tool-Aufruf] Aufzurufende JSON-RPC-Methode. Unterstützt werden: „initialize“, „ping“, „tools/list“, „tools/call“, „resources/list“, „resources/templates/list“, „notifications/initialized“. Die meisten Skripte brauchen nur „tools/call“. Feld im Body.
`jsonrpc`	`String`	✓	"2.0"	[MCP-Tool-Aufruf] Version des JSON-RPC-Protokolls. Muss die Zeichenkette „2.0“ sein. Feld im Body.

Beispielantwort

{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "{\"total_count\": 3, \"returned_count\": 3, \"nodes\": [...]}"}]}}

// Errors use JSON-RPC error envelope:
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32602, "message": "Invalid tool call params: ..."}}

// 401 Unauthorized responses include a WWW-Authenticate header for OAuth discovery (RFC 9728).