Home / Servers / Linode API / put_node_balancer_config
Update a config
An MCP tool from the Linode API server, hosted on mcp.hjlabs.in.
Update a config Updates the configuration for a single port on a NodeBalancer. > 🚧 > > You can configure UDP on the same NodeBalancer that also uses TCP, HTTP, or HTTPS, but only when managing it through the API.… [PUT /v4/nodebalancers/{nodeBalancerId}/configs/{configId}]
Name on the gateway: linode_api__put_node_balancer_config · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
nodeBalancerId required | integer | The ID of the NodeBalancer. |
configId required | integer | The ID of the Config to access. |
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're 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 check's response body for it to pass.… |
check_interval | integer | Number of seconds between checks to verify that backends are up and serving… |
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 | Number of seconds to wait for a check attempt before considering it failed.… |
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_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 number of seconds a UDP session can be idle before… |
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__put_node_balancer_config",
"arguments": {
"nodeBalancerId": 0,
"configId": 0
}
}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 update a config tool with nodeBalancerId set to ….