Home / Servers / Linode API / post_node_balancer_node

Create a node

An MCP tool from the Linode API server, hosted on mcp.hjlabs.in.

Create a node Creates a backend node that can receive traffic for the NodeBalancer configuration. Requests are routed to backend nodes on the specified port based on their status. The configurable fields for the… [POST /v4/nodebalancers/{nodeBalancerId}/configs/{configId}/nodes]

Name on the gateway: linode_api__post_node_balancer_node · may change things.

Parameters

NameTypeDescription
nodeBalancerId requiredintegerThe ID of the NodeBalancer.
configId requiredintegerThe ID of the NodeBalancer config to access.
address requiredstringBackend nodes can be Linodes and Linodes within a VPC. The following IP types…
config_idinteger__Read-only__ The NodeBalancer Config ID that this Node belongs to.
idinteger__Read-only__ This node's unique ID.
label requiredstringThe label for this node. This is for display purposes only.
modenone__Read-only__ The mode this NodeBalancer should use when sending traffic to…
nodebalancer_idinteger__Read-only__ The NodeBalancer ID that this Node belongs to.
statusunknown | UP | DOWN__Read-only__ The current status of this node, based on the configured checks…
subnet_idintegerRequired for VPC backend nodes only. The VPC's subnet. To display information…
weightintegerUsed when picking a backend to serve a request and is not pinned to a single…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "linode_api__post_node_balancer_node",
  "arguments": {
    "nodeBalancerId": 0,
    "configId": 0,
    "address": "…",
    "label": "…"
  }
}

Or connect the Linode API server directly, which lists 439 tools including this one:

Run in your terminal
claude mcp add --transport http hj-linode-api https://mcp.hjlabs.in/mcp/linode-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the create a node tool with nodeBalancerId set to ….

More from Linode API