{"service":"HALOWERK agentenwerk","endpoint":"/v1/mcp-normalize","method":"POST","content_type":"application/json","inputSchema":{"type":"object","required":["tools"],"additionalProperties":false,"properties":{"tools":{"type":"array","minItems":1,"maxItems":200,"description":"The MCP tool definitions to normalise.","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"description":"Tool name."},"server":{"type":"string","description":"Which server the tool came from. Used for collision reporting."}}}},"include_examples":{"type":"boolean","default":true,"description":"Build a synthetic example call per tool."},"naming":{"type":"string","enum":["snake_case","preserve"],"default":"snake_case","description":"How to normalise tool names."}}},"requestExample":{"tools":[{"name":"beispiel"}],"include_examples":true,"naming":"snake_case"},"operations":[{"method":"POST","inputSchema":{"type":"object","required":["tools"],"additionalProperties":false,"properties":{"tools":{"type":"array","minItems":1,"maxItems":200,"description":"The MCP tool definitions to normalise.","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","minLength":1,"description":"Tool name."},"server":{"type":"string","description":"Which server the tool came from. Used for collision reporting."}}}},"include_examples":{"type":"boolean","default":true,"description":"Build a synthetic example call per tool."},"naming":{"type":"string","enum":["snake_case","preserve"],"default":"snake_case","description":"How to normalise tool names."}}},"requestExample":{"tools":[{"name":"beispiel"}],"include_examples":true,"naming":"snake_case"}}],"example_request":{"tools":[{"name":"beispiel"}],"include_examples":true,"naming":"snake_case"},"serviceName":"mcp_normalize","tags":["agent","mcp","schema"],"outputSchema":{"type":"object"},"outputExample":{"tools":[{"name":"beispiel","original_name":"beispiel","server":null,"description":null,"description_source_field":null,"schema_source_field":null,"input_schema":{"type":"object","properties":{},"additionalProperties":true},"schema_present":false,"required":[],"fields":[],"field_count":0,"example_call":{"name":"beispiel","arguments":{}}}],"summary":{"total":1,"with_schema":0,"without_schema":1,"with_description":0,"servers":[],"name_collisions":0},"collisions":[],"findings":[{"severity":"warning","tool":"beispiel","server":null,"code":"schema_missing","message":"Kein Schemafeld gefunden (gesucht: inputSchema, input_schema, parameters, schema, arguments). Der Aufruf muss geraten werden."},{"severity":"warning","tool":"beispiel","server":null,"code":"description_missing","message":"Keine Beschreibung. Ein Agent kann nicht entscheiden, wann er das Werkzeug nehmen soll."}],"error_taxonomy":[{"code":"invalid_arguments","when":"Ein Pflichtfeld fehlt oder ein Wert passt nicht zum Schema."},{"code":"not_found","when":"Die angeforderte Sache existiert beim Server nicht."},{"code":"permission_denied","when":"Der Aufrufer darf das Werkzeug nicht benutzen."},{"code":"rate_limited","when":"Zu viele Aufrufe in zu kurzer Zeit."},{"code":"upstream_error","when":"Ein Vorlieferant des Servers war nicht erreichbar."},{"code":"timeout","when":"Die Bearbeitung hat das Zeitbudget ueberschritten."},{"code":"internal_error","when":"Unerwarteter Fehler im Server."}],"naming":"snake_case","schema_fields_accepted":["inputSchema","input_schema","parameters","schema","arguments"],"limits":"example_call zeigt nur die Form. Werte wie \"string\" oder 0 sind Platzhalter und duerfen nicht an einen echten Server gehen."}}