Hello — canonical payload contracts

Smoke-test MCP service (hello world) and host Server status.

Service id: hello
Docs: https://mcp.glc-rag.hu/guide/hello
Markdown docs: https://mcp.glc-rag.hu/guide/hello.md
MCP resource: docs://hello/payload

POST https://mcp.glc-rag.hu/mcp. Values below are type slots from the live input schema (e.g. <string, required>), not example data. Fill them from the user task.

RPC result wrapper: result.structuredContent is the object in Output schema. result.isError mirrors structuredContent.is_error.

hello_ping

Return a greeting message and server timestamp.

Required arguments: (none)

Request contract

{
  "jsonrpc": "2.0",
  "id": "<integer|string>",
  "method": "tools/call",
  "params": {
    "name": "hello_ping",
    "arguments": {
      "name": "<string, optional>"
    }
  }
}

Input schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional name to greet (default: world)"
    }
  },
  "additionalProperties": false
}

Output schema (structuredContent on success)

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    },
    "ts": {
      "type": "string",
      "description": "ISO-8601 UTC timestamp"
    }
  },
  "additionalProperties": true,
  "required": [
    "message",
    "ts"
  ]
}

Error object

{
  "type": "object",
  "required": [
    "error",
    "is_error"
  ],
  "properties": {
    "error": {
      "type": "string"
    },
    "is_error": {
      "type": "boolean",
      "const": true
    }
  },
  "additionalProperties": true
}

hello_server_status — Server status

Live host Server status: CPU percent, CPU count, load averages, RAM/swap, uptime. Same fields as the Admin/System admin “Server status” panel. No disk or filesystem usage. Free — 0 credits.

Required arguments: (none)

Request contract

{
  "jsonrpc": "2.0",
  "id": "<integer|string>",
  "method": "tools/call",
  "params": {
    "name": "hello_server_status",
    "arguments": {}
  }
}

Input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output schema (structuredContent on success)

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "cpu_percent": {
      "type": "number",
      "description": "Host CPU busy percent"
    },
    "cpu_count": {
      "type": "integer"
    },
    "load_avg": {
      "type": "object",
      "properties": {
        "1": {
          "type": "number"
        },
        "5": {
          "type": "number"
        },
        "15": {
          "type": "number"
        }
      }
    },
    "load_percent": {
      "type": "number",
      "description": "1-minute load vs cpu_count"
    },
    "memory": {
      "type": "object",
      "properties": {
        "ram_total_kib": {
          "type": "integer"
        },
        "ram_used_kib": {
          "type": "integer"
        },
        "ram_available_kib": {
          "type": "integer"
        },
        "ram_percent": {
          "type": "number"
        },
        "swap_total_kib": {
          "type": "integer"
        },
        "swap_used_kib": {
          "type": "integer"
        },
        "swap_percent": {
          "type": "number"
        }
      }
    },
    "uptime_seconds": {
      "type": "integer"
    },
    "sampled_at": {
      "type": "string",
      "description": "UTC sample timestamp (same as Admin Server status)"
    },
    "error": {
      "type": "string"
    }
  },
  "additionalProperties": true,
  "required": [
    "ok"
  ]
}

Error object

{
  "type": "object",
  "required": [
    "error",
    "is_error"
  ],
  "properties": {
    "error": {
      "type": "string"
    },
    "is_error": {
      "type": "boolean",
      "const": true
    }
  },
  "additionalProperties": true
}