VergeOS MCP Server

Instructions

Implementation Reference

• src/index.js:176-178 (handler)

  Core handler function in VergeOSAPI class that executes the HTTP request to the VergeOS backend API to fetch statistics for the specified node ID.

  async getNodeStats(id) {
    return this.request(`/api/v4/node_stats?node=${id}`);
  }

• src/index.js:460-473 (schema)

  Tool schema definition in the TOOLS array, specifying the input schema requiring a numeric node ID.

  {
    name: "get_node_stats",
    description: "Get statistics for a specific node",
    inputSchema: {
      type: "object",
      properties: {
        id: {
          type: "number",
          description: "Node ID",
        },
      },
      required: ["id"],
    },
  },

• src/index.js:590-592 (handler)

  Dispatch handler in the MCP CallToolRequestSchema request handler that routes the tool call to the api.getNodeStats method.

  case "get_node_stats":
    result = await api.getNodeStats(args.id);
    break;

• src/index.js:526-528 (registration)

  Registration of the ListToolsRequestSchema handler which returns the TOOLS array including the get_node_stats tool definition.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    return { tools: TOOLS };
  });