Home / Servers / Linode API / post_node_balancer_config
Create a config
An MCP tool from the Linode API server, hosted on mcp.hjlabs.in.
Create a config Creates a NodeBalancer configuration, which allows the NodeBalancer to accept traffic on a new port. You will need to add NodeBalancer nodes to the new configuration before it can actually serve… [POST /v4/nodebalancers/{nodeBalancerId}/configs]
Name on the gateway: linode_api__post_node_balancer_config · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
nodeBalancerId required | integer | The ID of the NodeBalancer. |
algorithm | roundrobin | leastconn | ring_hash | The algorithm this UDP NodeBalancer uses to route traffic to backends. |
check | none | connection | http | http_body | The type of check to perform against backends to ensure they are serving… |
check_attempts | integer | How many times to attempt a check before considering a backend to be down. |
check_body | string | This value must be present in the response body of the check in order for it… |
check_interval | integer | How often, in seconds, to check that backends are up and serving requests.… |
check_passive | boolean | __Read-only__ Must be false for UDP. |
check_path | string | The URL path to check on each backend. If the backend does not respond to this… |
check_timeout | integer | How long, in seconds, to wait for a check attempt before considering it… |
cipher_suite | string | __Read-only__ Not applicable for UDP configs. |
id | integer | __Read-only__ This config's unique ID. |
nodebalancer_id | integer | __Read-only__ The ID for the NodeBalancer this config belongs to. |
nodes required | array | The NodeBalancer nodes that serve this config. Some considerations for Nodes… |
nodes_status | object | __Read-only__ Describes the health of the backends for this port. This data… |
port | integer | This is the port the NodeBalancer listens on for this configuration. Port… |
protocol | udp | The protocol the port is configured to serve, udp in this case. Review our… |
proxy_protocol | string | __Read-only__ Must be none for UDP. |
ssl_cert | string | __Read-only__ Not applicable for UDP configs. |
ssl_commonname | string | __Read-only__ Not applicable for UPD configs. |
ssl_fingerprint | string | __Read-only__ Not applicable for UDP configs. |
ssl_key | string | __Read-only__ Not applicable for UDP configs. |
stickiness | none | session | source_ip | Controls how session stickiness is handled on this port. - If set to none… |
udp_check_port | integer | UDP NodeBalancers use TCP and HTTP active health checks to ensure back-end… |
udp_session_timeout | integer | __Read-only__ The maximum duration in seconds, a UDP session can be idle… |
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:
{
"name": "linode_api__post_node_balancer_config",
"arguments": {
"nodeBalancerId": 0,
"nodes": []
}
}Or connect the Linode API server directly, which lists 439 tools including this one:
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 config tool with nodeBalancerId set to ….