内容
# Linode MCP Server
[](https://github.com/takashito/linode-mcp-server)
[](https://www.npmjs.com/package/@takashito/linode-mcp-server)
[](https://www.npmjs.com/package/@takashito/linode-mcp-server)
An MCP (Model Context Protocol) server that connects your AI Assistant or Agent to your Linode cloud infrastructure allowing you to manage your cloud resources through natural conversation. Built with FastMCP framework and supports stdio and HTTP streaming transports!
> **FastMCP v3**: This project uses [FastMCP v3](https://github.com/punkpeye/fastmcp) for typed sessions, cleaner token handling, and improved security. Supports stdio and HTTP streaming (StreamableHTTP) transports.
## What Can You Do With This?
Ask Claude Desktop or VSCode Copilot Agent to help you with tasks like:
- "Show me all my instances in the Frankfurt region"
- "Create a new instance in Osaka"
- "Create a load balancer for my web servers"
- "Set up a managed MySQL database"
etc
This server provides tools for the following Linode service categories:
- 🖥️ **instances** - Linode compute instances
- 💾 **volumes** - Block storage volumes
- 🌐 **networking** - IP addresses, firewalls, VLANs
- ⚖️ **nodebalancers** - Load balancers for distributing traffic
- 🌎 **regions** - Data center locations
- 📊 **placement** - Instance placement policies
- 🔒 **vpcs** - Virtual Private Cloud networks
- 📦 **objectStorage** - S3-compatible object storage
- 🔤 **domains** - DNS management
- 🗄️ **databases** - Managed MySQL/PostgreSQL databases
- ☸️ **kubernetes** - Kubernetes container orchestration (LKE)
- 💿 **images** - Custom disk images for instances
- 📜 **stackScripts** - Deployment automation scripts
- 🏷️ **tags** - Resource organization labels
- 🎫 **support** - Support tickets and requests
- 📊 **longview** - System metrics and monitoring
- 👤 **profile** - User profile and security settings
- 🏢 **account** - Account management, users, billing, IAM, and resource locks
- 📡 **monitor** - Alerts, logs, metrics, and dashboards
## Getting Started
### Quick Start with npx
You'll need a Linode API token to use this server. Create one in your [Linode Cloud Manager profile settings](https://cloud.linode.com/profile/tokens).
```bash
# Start the server with your API token
npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN
```
### Setting Your API Token
You can provide your token in several ways. **Precedence (highest first):**
1. **`Authorization: Bearer <token>` request header** (HTTP transport only) — a token sent by the MCP client on each request. See [Pass Linode API Key via Authorization Header](#pass-linode-api-key-via-authorization-header-) below. This wins over every fallback so multiple users can share one server.
2. **`--token` command-line option:**
```bash
npx @takashito/linode-mcp-server --token YOUR_LINODE_API_TOKEN
```
3. **`LINODE_API_TOKEN` environment variable:**
```bash
export LINODE_API_TOKEN=your_token_here
npx @takashito/linode-mcp-server
```
4. **`.env` file in the current working directory** — the server calls `dotenv.config()` at startup, so a `.env` file in the directory you launch it from is auto-loaded:
```
LINODE_API_TOKEN=your_token_here
```
```bash
npx @takashito/linode-mcp-server
```
> **⚠️ Gotcha for HTTP transport:** a `.env` file or `LINODE_API_TOKEN` env var in the server's launch environment acts as a **fallback** when the client omits the `Authorization` header. If you want to require every client to authenticate with its own header (e.g. multi-user setup), make sure the server process has no `LINODE_API_TOKEN` in env **and** no `.env` in its working directory.
### Connecting to AI Clients
#### Claude Desktop
Open Claude settings > Developer > Edit Config:
```json
{
"mcpServers": {
"linode": {
"command": "npx",
"args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN"]
}
}
}
```
#### VSCode/Cursor/Windsurf
Add to your settings.json:
```json
{
"mcpServers": {
"linode": {
"command": "npx",
"args": ["-y", "@takashito/linode-mcp-server", "--token", "YOUR_LINODE_API_TOKEN", "--categories", "instances,volumes,regions"]
}
}
}
```
## Tools Category Selection
> **💡 Context-budget tips**
>
> Enabling every tool exposes **~416 tool definitions** to the model on every turn. The tool listing (name + description + JSON-Schema for each) is sent as part of the system prompt and is charged as input tokens on **every** request.
>
> **Rough estimate with all categories enabled:** the full tool manifest is ~80–120 k input tokens, depending on the client's JSON-Schema serialization. For small-context clients this alone can exceed the window before the user's prompt is even added.
>
> **Per-category tool count (order-of-magnitude tokens, assuming ~200 tokens per tool):**
> | Category | Tools | ~Tokens |
> |---|---|---|
> | `instances` | 58 | ~11–14 k |
> | `account` | 52 | ~10–12 k |
> | `networking` | 44 | ~8–10 k |
> | `databases` | 34 | ~7–8 k |
> | `monitor` | 32 | ~6–7 k |
> | `images` | 29 | ~5–6 k |
> | `kubernetes` | 29 | ~5–6 k |
> | `objectStorage` | 29 | ~5–6 k |
> | `profile` | 29 | ~5–6 k |
> | `vpcs` | 14 | ~2–3 k |
> | `domains` | 13 | ~2–3 k |
> | `longview` | 11 | ~2 k |
> | `nodebalancers` | 10 | ~2 k |
> | `support` / `placement` / `volumes` | 7 each | ~1–2 k |
> | `stackScripts` | 5 | ~1 k |
> | `tags` | 4 | ~0.5–1 k |
> | `regions` | 2 | ~0.5 k |
>
> **Recommendations:**
> - **Always scope to what you need.** Pass `--categories instances,volumes,regions` rather than enabling all — this is by far the biggest cost lever.
> - **Small-context clients** (GPT-4o/GPT-4o-mini 128 k, Claude Haiku 200 k, most local models ≤32 k): enable 2–4 categories max. All-enabled will either truncate or outright fail.
> - **Large-context clients** (Claude Sonnet/Opus 200 k–1 M, GPT-5, Gemini): all-enabled works, but every unused tool still costs input tokens per turn — be mindful of API cost even if it fits.
> - **Caching matters.** Anthropic/OpenAI prompt caching only rewards identical tool manifests across calls; changing `--categories` between sessions breaks the cache.
> - **Prefer `--list-categories`** to see everything available, then enable only what your current task needs. You can start a second server with a different category set if you need different tooling mid-flight.
> - Token counts above are estimates; your client may serialize JSON Schema differently (zod → JSON Schema can expand). Measure with your own client's token counter if you need exact numbers.
You can selectively enable tools with the `--categories` parameter:
```bash
# Enable only instances and volumes tools
npx @takashito/linode-mcp-server --token YOUR_TOKEN --categories instances,volumes
```
Or in Claude Desktop config:
```json
{
"mcpServers": {
"linode": {
"command": "npx",
"args": [
"-y",
"@takashito/linode-mcp-server",
"--token",
"YOUR_LINODE_API_TOKEN",
"--categories",
"instances,volumes,regions"
]
}
}
}
```
Available categories: instances, volumes, networking, nodebalancers, regions, placement, vpcs, objectStorage, domains, databases, kubernetes, images, stackScripts, tags, support, longview, profile, account, monitor
To see all available categories:
```bash
npx @takashito/linode-mcp-server --list-categories
```
## Transport Options
1. **stdio transport** - Default transport compatible with Claude Desktop
```bash
# Default stdio transport
npx @takashito/linode-mcp-server --token YOUR_TOKEN
```
2. **httpStream transport** - HTTP streaming transport (StreamableHTTP) for web clients
```bash
# Start with HTTP streaming transport on port 8080 /mcp
npx @takashito/linode-mcp-server --token YOUR_TOKEN --transport http --port 8080 --endpoint /mcp
```
You can customize port and host for HTTP streaming transport:
- `--port` : Server port (default: 8080)
- `--endpoint` : Server Path (default: /mcp)
- `--host` : Server host (default: 127.0.0.1)
## Pass Linode API Key via Authorization Header ✅
For HTTP transport, you can run the MCP server **without** the `--token` parameter and have the client supply the token on each request via an `Authorization: Bearer <token>` header. The server forwards that token to the Linode API as-is — no token ever needs to live in the server's argv or environment.
**Why use this mode:**
- **Multi-user / shared server.** Run one server and let multiple clients/users authenticate with their own tokens.
- **Secrets hygiene.** Token stays on the client side; the server process doesn't need it in its command line (visible in `ps`) or environment.
- **Token rotation.** Clients can switch tokens without restarting the server.
```bash
# Start with HTTP streaming transport on port 8080 /mcp at localhost
npx @takashito/linode-mcp-server --transport http
```
Configure your MCP client to add the `Authorization` header. `linode-mcp-server` forwards this API token to the Linode API at the backend:
```json
{
"mcpServers": {
"linode-remote-mcp": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8080/mcp",
"--header",
"Authorization: Bearer ${LINODE_API_TOKEN}"
],
"env": {
"LINODE_API_TOKEN": "..."
}
}
}
}
```
> **Note:** If both `--token` (server-side) and an `Authorization` header (client-side) are provided, the request-level header takes precedence. The `--token` flag is useful as a fallback default in single-user setups.
## Docker
Run the MCP server as a container with httpStream transport.
### Build
```bash
docker build -t takashito/linode-mcp-server .
```
### Run
```bash
# Basic usage (port 8080, all tool categories)
docker run -e LINODE_API_TOKEN=your_token -p 8080:8080 takashito/linode-mcp-server
# Custom port
docker run -e LINODE_API_TOKEN=your_token -e PORT=3000 -p 3000:3000 takashito/linode-mcp-server
# Limit tool categories
docker run -e LINODE_API_TOKEN=your_token -e CATEGORIES=instances,volumes,regions -p 8080:8080 takashito/linode-mcp-server
# Custom endpoint
docker run -e LINODE_API_TOKEN=your_token -e ENDPOINT=/api -p 8080:8080 takashito/linode-mcp-server
```
### Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `LINODE_API_TOKEN` | *(required)* | Linode API token. Can also be passed via Authorization header. |
| `PORT` | `8080` | Server port |
| `ENDPOINT` | `/mcp` | Server endpoint path |
| `CATEGORIES` | *(all)* | Comma-separated list of tool categories to enable |
### Connect with MCP Client
```json
{
"mcpServers": {
"linode": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:8080/mcp",
"--header",
"Authorization: Bearer ${LINODE_API_TOKEN}"
],
"env": {
"LINODE_API_TOKEN": "your_token"
}
}
}
}
```
## Available Tools
This MCP server provides the following tools for interacting with Linode API services:
> **✅ MCP parameter serialization**
> All tool input schemas are wrapped with a universal preprocessor (`mcpInput()`) that auto-coerces string-serialized values back to their expected types (arrays, objects, numbers, booleans). This means MCP clients that stringify nested JSON params (common with Claude Code and other implementations) work correctly without the caller having to pre-parse values.
> **Legend**
> 🧪 *beta* — tool targets a Linode v4beta API endpoint or a feature that may be gated on your account (log streams, delegation, image sharegroups). Behavior/schema may change without notice, and some return 404 if the feature isn't provisioned.
> **⚠️ Beta API endpoints**
> The following tools call the Linode `v4beta` API (not the stable `v4`). They may change without notice, and some are only available on accounts with the corresponding feature provisioned. If you see a 404, your account likely lacks access.
>
> - **LKE tier versions** — `list_kubernetes_tier_versions`, `get_kubernetes_tier_version` (`/v4beta/lke/tiers/{tier}/versions`)
> - **Resource locks** — `list_resource_locks`, `get_resource_lock`, `create_resource_lock`, `delete_resource_lock` (`/v4beta/locks`)
> - **Monitor alerts** — `list_alert_definitions`, `get_alert_definition`, `create_alert_definition`, `update_alert_definition`, `delete_alert_definition`, `list_service_alert_definitions`, `list_notification_channels`, `get_notification_channel`, `create_notification_channel`, `update_notification_channel`, `delete_notification_channel`, `list_channel_alerts` (`/v4beta/monitor/alert-*`)
>
> **Account-gated endpoints** (may 404 even for admins — feature not provisioned for the account):
> - Delegation: `get_delegation_default_roles`, `list_delegation_child_accounts`, `list_delegation_profile_accounts`, `update_delegation_default_roles`, `get_delegation_child_account_users`, `update_delegation_child_account_users`, `get_delegation_profile_account`, `create_delegation_token`
> - Log streams / log destinations: `list_log_streams`, `list_log_destinations`, and related CRUD tools (API path currently undiscoverable)
### 🖥️ Instances
Manage Linode compute instances, including creation, deletion, and power operations.
#### Instance Operations
- `list_instances` - Get a list of all Linode instances
- `get_instance` - Get details for a specific Linode instance
- `create_instance` - Create a new Linode instance
- `update_instance` - Update a Linode instance
- `delete_instance` - Delete a Linode instance
- `reboot_instance` - Reboot a Linode instance
- `boot_instance` - Power on a Linode instance
- `shutdown_instance` - Power off a Linode instance
- `resize_instance` - Resize a Linode instance
- `clone_instance` - Clone a Linode instance to a new Linode
- `rebuild_instance` - Rebuild a Linode instance with a new image
- `rescue_instance` - Boot a Linode instance into rescue mode
- `reset_root_password` - Reset the root password for a Linode instance
- `initiate_migration` - Initiate a DC migration for a Linode instance
- `upgrade_linode` - Upgrade a Linode instance
#### Instance Configuration
- `list_instance_configs` - Get all configuration profiles for a Linode instance
- `get_instance_config` - Get a specific configuration profile for a Linode instance
- `create_instance_config` - Create a new configuration profile for a Linode instance
- `update_instance_config` - Update a configuration profile for a Linode instance
- `delete_instance_config` - Delete a configuration profile for a Linode instance
#### Configuration Profile Interfaces
- `list_config_interfaces` - List all interfaces for a configuration profile
- `get_config_interface` - Get details for a specific configuration profile interface
- `create_config_interface` - Create a new interface for a configuration profile
- `update_config_interface` - Update an interface for a configuration profile
- `delete_config_interface` - Delete an interface from a configuration profile
- `reorder_config_interfaces` - Reorder interfaces for a configuration profile
#### Instance Disks
- `list_instance_disks` - Get all disks for a Linode instance
- `get_instance_disk` - Get a specific disk for a Linode instance
- `create_instance_disk` - Create a new disk for a Linode instance
- `update_instance_disk` - Update a disk for a Linode instance
- `delete_instance_disk` - Delete a disk for a Linode instance
- `resize_instance_disk` - Resize a disk for a Linode instance
- `clone_disk` - Clone a disk to a new disk
- `reset_disk_root_password` - Reset a disk root password
#### Instance Backups
- `list_backups` - Get a list of all backups for a Linode instance
- `get_backup` - Get details for a specific backup
- `create_snapshot` - Create a snapshot for a Linode instance
- `cancel_backups` - Cancel backups for a Linode instance
- `enable_backups` - Enable backups for a Linode instance
- `restore_backup` - Restore a backup to a Linode instance
#### IP Management
- `get_networking_information` - Get networking information for a Linode instance
- `allocate_ipv4_address` - Allocate an IPv4 address for a Linode instance
- `get_ip_address` - Get details for a specific IP address
- `update_ip_address_rdns` - Update reverse DNS for an IP address
- `delete_ipv4_address` - Delete an IPv4 address
#### Firewall Management
- `list_linode_firewalls` - List firewalls for a Linode instance
- `apply_linode_firewalls` - Apply firewalls to a Linode instance
- `update_linode_firewalls` - Update a Linode's assigned firewalls
#### Instance Stats and Transfer
- `get_instance_stats` - Get current statistics for a Linode instance
- `get_instance_stats_by_date` - Get statistics for a Linode instance for a specific month
- `get_network_transfer` - Get network transfer information for a Linode instance
- `get_monthly_network_transfer` - Get monthly network transfer stats for a Linode instance
#### Related Resources
- `list_instance_nodebalancers` - List NodeBalancers attached to a Linode instance
- `list_instance_volumes` - List volumes attached to a Linode instance
#### Kernels and Instance Types
- `list_kernels` - Get a list of all available kernels
- `get_kernel` - Get details for a specific kernel
- `list_instance_types` - Get a list of all available Linode types
- `get_instance_type` - Get details for a specific Linode type
### 💾 Volumes
Manage block storage volumes that can be attached to Linode instances.
- `list_volumes` - Get a list of all volumes
- `get_volume` - Get details for a specific volume
- `create_volume` - Create a new volume
- `delete_volume` - Delete a volume
- `attach_volume` - Attach a volume to a Linode instance
- `detach_volume` - Detach a volume from a Linode instance
- `resize_volume` - Resize a volume
### 🌐 Networking
Manage IP addresses, firewalls, and network infrastructure.
#### IP Address Management
- `get_ip_addresses` - Get all IP addresses
- `get_ip_address` - Get details for a specific IP address
- `update_ip_address` - Update reverse DNS for an IP address
- `allocate_ip` - Allocate a new IP address
- `share_ips` - Share IP addresses between Linodes
#### IPv6 Management
- `get_ipv6_ranges` - Get all IPv6 ranges
- `get_ipv6_range` - Get a specific IPv6 range
- `get_ipv6_pools` - Get all IPv6 pools
- `create_ipv6_range` - Create an IPv6 range
- `delete_ipv6_range` - Delete an IPv6 range
#### IPv4 Operations
- `assign_ipv4_addresses` - Assign IPv4 addresses to Linodes
- `share_ipv4_addresses` - Configure IPv4 sharing
#### IP Assignment
- `assign_ips` - Assign IP addresses to Linodes
#### Firewall Management
- `get_firewalls` - Get all firewalls
- `get_firewall` - Get details for a specific firewall
- `create_firewall` - Create a new firewall
- `update_firewall` - Update a firewall
- `delete_firewall` - Delete a firewall
#### Firewall Rules
- `get_firewall_rules` - Get all rules for a specific firewall
- `update_firewall_rules` - Update rules for a specific firewall
#### Firewall Devices
- `get_firewall_devices` - Get all devices for a specific firewall
- `get_firewall_device` - Get a specific firewall device
- `create_firewall_device` - Create a new device for a specific firewall
- `delete_firewall_device` - Delete a device from a specific firewall
#### Firewall History & Templates
- `list_firewall_history` - List firewall rule versions
- `get_firewall_rule_version` - Get a specific firewall rule version
- `get_firewall_settings` - Get default firewall settings
- `update_firewall_settings` - Update default firewall settings
- `list_firewall_templates` - List firewall templates
- `get_firewall_template` - Get a firewall template
#### VLAN Management
- `get_vlans` - Get all VLANs
- `get_vlan` - Get a specific VLAN
- `delete_vlan` - Delete a VLAN
#### Linode Interfaces
- `list_linode_interfaces` - List Linode interfaces
- `get_linode_interface` - Get a Linode interface
- `create_linode_interface` - Add a Linode interface
- `update_linode_interface` - Update a Linode interface
- `delete_linode_interface` - Delete a Linode interface
- `list_linode_interface_history` - List interface history
- `get_linode_interface_settings` - Get interface settings
- `update_linode_interface_settings` - Update interface settings
- `list_linode_interface_firewalls` - List interface firewalls
- `upgrade_linode_interfaces` - Upgrade to Linode interfaces
#### Network Transfer Prices
- `list_network_transfer_prices` - List network transfer prices
### 🔤 Domains
Manage DNS domains and records hosted by Linode's DNS services.
- `list_domains` - Get a list of all domains
- `get_domain` - Get details for a specific domain
- `create_domain` - Create a new domain
- `update_domain` - Update an existing domain
- `delete_domain` - Delete a domain
- `list_domain_records` - Get a list of all domain records for a domain
- `get_domain_record` - Get details for a specific domain record
- `create_domain_record` - Create a new domain record
- `update_domain_record` - Update a domain record
- `delete_domain_record` - Delete a domain record
- `import_domain_zone` - Import a domain zone from a remote nameserver
- `clone_domain` - Clone an existing domain to a new domain
- `get_zone_file` - Get DNS zone file for a domain
### 🗄️ Databases
Manage Linode Managed Database services for MySQL and PostgreSQL.
#### General Database Operations
- `list_database_engines` - Get a list of all available database engines (MySQL, PostgreSQL versions)
- `get_database_engine` - Get details for a specific database engine version
- `list_database_types` - Get a list of all available database instance types (sizes)
- `get_database_type` - Get details for a specific database instance type
- `list_database_instances` - Get a list of all database instances (both MySQL and PostgreSQL)
#### MySQL Database Operations
- `list_mysql_instances` - Get a list of all MySQL database instances
- `get_mysql_instance` - Get details for a specific MySQL database instance
- `create_mysql_instance` - Create a new MySQL database instance
- `update_mysql_instance` - Update an existing MySQL database instance settings
- `delete_mysql_instance` - Delete a MySQL database instance
- `get_mysql_credentials` - Get admin credentials for a MySQL database instance
- `reset_mysql_credentials` - Reset admin credentials for a MySQL database instance
- `get_mysql_ssl_certificate` - Get the SSL certificate for a MySQL database instance
- `patch_mysql_instance` - Apply the latest software updates to a MySQL database instance
- `suspend_mysql_instance` - Suspend a MySQL database instance (billing continues)
- `resume_mysql_instance` - Resume a suspended MySQL database instance
#### PostgreSQL Database Operations
- `list_postgresql_instances` - Get a list of all PostgreSQL database instances
- `get_postgresql_instance` - Get details for a specific PostgreSQL database instance
- `create_postgresql_instance` - Create a new PostgreSQL database instance
- `update_postgresql_instance` - Update an existing PostgreSQL database instance settings
- `delete_postgresql_instance` - Delete a PostgreSQL database instance
- `get_postgresql_credentials` - Get admin credentials for a PostgreSQL database instance
- `reset_postgresql_credentials` - Reset admin credentials for a PostgreSQL database instance
- `get_postgresql_ssl_certificate` - Get the SSL certificate for a PostgreSQL database instance
- `patch_postgresql_instance` - Apply the latest software updates to a PostgreSQL database instance
- `suspend_postgresql_instance` - Suspend a PostgreSQL database instance (billing continues)
- `resume_postgresql_instance` - Resume a suspended PostgreSQL database instance
#### PostgreSQL Connection Pools
- `list_postgresql_connection_pools` - List connection pools for a PostgreSQL instance
- `get_postgresql_connection_pool` - Get a specific connection pool
- `create_postgresql_connection_pool` - Create a connection pool
- `update_postgresql_connection_pool` - Update a connection pool
- `delete_postgresql_connection_pool` - Delete a connection pool
#### Database Configuration
- `get_mysql_config` - Get MySQL advanced configuration parameters
- `get_postgresql_config` - Get PostgreSQL advanced configuration parameters
### ⚖️ NodeBalancers
Manage Linode's load balancing service to distribute traffic across multiple Linode instances.
- `list_nodebalancers` - Get a list of all NodeBalancers
- `get_nodebalancer` - Get details for a specific NodeBalancer
- `create_nodebalancer` - Create a new NodeBalancer
- `delete_nodebalancer` - Delete a NodeBalancer
- `list_nodebalancer_configs` - Get a list of config nodes for a NodeBalancer
- `create_nodebalancer_config` - Create a new config for a NodeBalancer
- `delete_nodebalancer_config` - Delete a NodeBalancer config
- `list_nodebalancer_nodes` - Get a list of nodes for a NodeBalancer config
- `create_nodebalancer_node` - Create a new node for a NodeBalancer config
- `delete_nodebalancer_node` - Delete a node from a NodeBalancer config
#### NodeBalancer Firewalls
- `list_nodebalancer_firewalls` - List firewalls for a NodeBalancer
- `update_nodebalancer_firewalls` - Update a NodeBalancer's firewalls
### 📦 Object Storage
Manage S3-compatible object storage for storing and retrieving files.
#### Bucket Management
- `list_object_storage_buckets` - Get a list of all Object Storage buckets
- `list_object_storage_buckets_in_region` - List buckets in a specific region
- `get_object_storage_bucket` - Get details for a specific Object Storage bucket
- `create_object_storage_bucket` - Create a new Object Storage bucket
- `delete_object_storage_bucket` - Delete an Object Storage bucket
- `get_object_storage_bucket_access` - Get access configuration for an Object Storage bucket
- `update_object_storage_bucket_access` - Update access configuration for an Object Storage bucket
#### Object Operations
- `list_object_storage_objects` - List objects in an Object Storage bucket
- `upload_object` - Upload a new object to a bucket from various sources (string, file, or URL)
- `download_object` - Download an object from a bucket to your local file system
- `delete_object` - Delete an object from a bucket
- `get_object_acl` - Get object ACL configuration
- `update_object_acl` - Update access control level (ACL) for an object in a bucket
- `generate_object_url` - Generate a pre-signed URL for an object in a bucket
#### Certificate Management
- `get_object_storage_bucket_certificate` - Get SSL/TLS certificate for an Object Storage bucket
- `upload_object_storage_bucket_certificate` - Upload SSL/TLS certificate for an Object Storage bucket
- `delete_object_storage_bucket_certificate` - Delete SSL/TLS certificate for an Object Storage bucket
#### Access Key Management
- `list_object_storage_keys` - Get a list of all Object Storage keys
- `get_object_storage_key` - Get details for a specific Object Storage key
- `create_object_storage_key` - Create a new Object Storage key
- `update_object_storage_key` - Update an Object Storage key
- `delete_object_storage_key` - Delete an Object Storage key
#### Object Storage Quotas
- `list_object_storage_quotas` - List Object Storage quotas
- `get_object_storage_quota` - Get a specific quota
- `get_object_storage_quota_usage` - Get quota usage data
#### Usage and Service Information
- `get_object_storage_transfer` - Get Object Storage transfer statistics
- `list_object_storage_types` - Get a list of all available Object Storage types with pricing
- `cancel_object_storage` - Cancel Object Storage service
### 🔒 VPCs
Manage Virtual Private Cloud networks to isolate and connect Linode resources.
- `list_vpcs` - Get a list of all VPCs
- `get_vpc` - Get details for a specific VPC
- `create_vpc` - Create a new VPC
- `update_vpc` - Update an existing VPC
- `delete_vpc` - Delete a VPC
- `list_vpc_subnets` - List all subnets in a VPC
- `get_vpc_subnet` - Get details for a specific subnet in a VPC
- `create_vpc_subnet` - Create a new subnet in a VPC
- `update_vpc_subnet` - Update an existing subnet in a VPC
- `delete_vpc_subnet` - Delete a subnet in a VPC
- `list_vpc_ips` - List all IP addresses in a VPC
- `list_all_vpc_ips` - List all VPC IP addresses across all VPCs
- `list_nodebalancer_vpcs` - List NodeBalancer VPC configurations
- `get_nodebalancer_vpc` - Get a NodeBalancer VPC configuration
### 📊 Placement Groups
Manage instance placement policies to control how instances are distributed across physical hardware.
- `list_placement_groups` - List all placement groups
- `get_placement_group` - Get details for a specific placement group
- `create_placement_group` - Create a new placement group
- `update_placement_group` - Update an existing placement group
- `delete_placement_group` - Delete a placement group
- `assign_instances` - Assign Linode instances to a placement group
- `unassign_instances` - Unassign Linode instances from a placement group
### 🌎 Regions
Retrieve information about Linode's global data center locations.
- `list_regions` - Get a list of all available regions
- `get_region` - Get details for a specific region
### ☸️ Kubernetes (LKE)
Manage Linode Kubernetes Engine clusters and node pools.
#### Cluster Operations
- `list_kubernetes_clusters` - List all Kubernetes clusters
- `get_kubernetes_cluster` - Get details for a specific Kubernetes cluster
- `create_kubernetes_cluster` - Create a new Kubernetes cluster
- `update_kubernetes_cluster` - Update an existing Kubernetes cluster
- `delete_kubernetes_cluster` - Delete a Kubernetes cluster
- `get_kubernetes_kubeconfig` - Get the kubeconfig for a Kubernetes cluster
- `get_kubernetes_api_endpoints` - Get the API endpoints for a Kubernetes cluster
- `get_kubernetes_dashboard_url` - Get the dashboard URL for a Kubernetes cluster
- `delete_kubernetes_service_token` - Delete the service token for a Kubernetes cluster
- `recycle_kubernetes_cluster` - Recycle all nodes in a Kubernetes cluster
- `regenerate_kubernetes_cluster` - Regenerate a Kubernetes cluster
- `list_kubernetes_versions` - List all available Kubernetes versions
- `get_kubernetes_version` - Get details for a specific Kubernetes version
- `list_kubernetes_types` - List all available Kubernetes types
#### Node Pool Operations
- `list_kubernetes_node_pools` - List all node pools in a Kubernetes cluster
- `get_kubernetes_node_pool` - Get details for a specific node pool
- `create_kubernetes_node_pool` - Create a new node pool for a Kubernetes cluster
- `update_kubernetes_node_pool` - Update an existing node pool
- `delete_kubernetes_node_pool` - Delete a node pool from a Kubernetes cluster
- `recycle_kubernetes_nodes` - Recycle specific nodes in a Kubernetes node pool
#### Node Operations
- `get_kubernetes_node` - Get details for a specific node
- `delete_kubernetes_node` - Delete a node from a Kubernetes cluster
- `recycle_kubernetes_node` - Recycle a node in a Kubernetes cluster
#### Control Plane ACL
- `get_kubernetes_control_plane_acl` - Get control plane ACL configuration
- `update_kubernetes_control_plane_acl` - Update control plane ACL
- `delete_kubernetes_control_plane_acl` - Delete control plane ACL
#### Kubeconfig & Tier Versions
- `delete_kubernetes_kubeconfig` - Delete (revoke) a kubeconfig
- `list_kubernetes_tier_versions` 🧪 *beta* - List Kubernetes versions for a tier
- `get_kubernetes_tier_version` 🧪 *beta* - Get a Kubernetes version for a tier
### 💿 Images
Manage disk images that can be used to create Linode instances.
- `list_images` - Get a list of all available images
- `get_image` - Get details for a specific image
- `create_image` - Create a new image from an existing disk
- `upload_image` - Initialize an image upload
- `update_image` - Update an existing image
- `delete_image` - Delete an image
- `replicate_image` - Replicate an image to other regions
#### Image Sharing (Sharegroups)
- `list_image_sharegroups` 🧪 *beta* - List share groups
- `get_image_sharegroup` 🧪 *beta* - Get a share group
- `create_image_sharegroup` 🧪 *beta* - Create a share group
- `update_image_sharegroup` 🧪 *beta* - Update a share group
- `delete_image_sharegroup` 🧪 *beta* - Delete a share group
- `list_sharegroup_images` 🧪 *beta* - List images in a share group
- `add_sharegroup_images` 🧪 *beta* - Add images to a share group
- `update_sharegroup_image` 🧪 *beta* - Update a shared image
- `remove_sharegroup_image` 🧪 *beta* - Remove an image from a share group
- `list_sharegroup_members` 🧪 *beta* - List members of a share group
- `get_sharegroup_member` 🧪 *beta* - Get a membership token
- `add_sharegroup_members` 🧪 *beta* - Add members to a share group
- `update_sharegroup_member` 🧪 *beta* - Update a membership token
- `remove_sharegroup_member` 🧪 *beta* - Remove a member from a share group
- `list_sharegroup_tokens` 🧪 *beta* - List share group tokens
- `get_sharegroup_token` 🧪 *beta* - Get a token
- `create_sharegroup_token` 🧪 *beta* - Create a token
- `update_sharegroup_token` 🧪 *beta* - Update a token
- `delete_sharegroup_token` 🧪 *beta* - Delete a token
- `get_token_sharegroup` 🧪 *beta* - Get a token's share group
- `list_token_sharegroup_images` 🧪 *beta* - List images by token
- `list_image_sharegroups_by_image` 🧪 *beta* - List share groups for an image
### 📜 StackScripts
Manage reusable scripts that automate the deployment of custom environments on Linode instances.
- `list_stackscripts` - Get a list of all StackScripts
- `get_stackscript` - Get details for a specific StackScript
- `create_stackscript` - Create a new StackScript
- `update_stackscript` - Update an existing StackScript
- `delete_stackscript` - Delete a StackScript
### 🏷️ Tags
Manage labels that help organize and categorize Linode resources.
- `list_tags` - Get a list of all Tags
- `get_tag` - Get details for a specific Tag
- `create_tag` - Create a new Tag
- `delete_tag` - Delete a Tag
### 🎫 Support
Manage support tickets and requests with Linode's support team.
- `list_tickets` - List support tickets for your account
- `get_ticket` - Get details of a specific support ticket
- `create_ticket` - Open a new support ticket
- `close_ticket` - Close a support ticket
- `list_replies` - List replies to a support ticket
- `create_reply` - Reply to a support ticket
- `upload_attachment` - Upload an attachment to a support ticket
### 📊 Longview
Manage Longview monitoring clients for collecting system metrics.
- `list_longview_clients` - Get a list of all Longview clients
- `get_longview_client` - Get details for a specific Longview client
- `create_longview_client` - Create a new Longview client
- `update_longview_client` - Update a Longview client
- `delete_longview_client` - Delete a Longview client
- `list_longview_subscriptions` - Get a list of all Longview subscription plans
- `get_longview_subscription` - Get details for a specific Longview subscription plan
- `get_longview_data` - Get monitoring data from a Longview client
- `get_longview_plan` - Get Longview plan
- `update_longview_plan` - Update Longview plan
- `list_longview_types` - List Longview types
### 👤 Profile
Manage user profile information, SSH keys, API tokens, and security settings.
#### Profile Operations
- `get_profile` - Get your user profile information
- `update_profile` - Update your user profile information
#### SSH Key Operations
- `list_ssh_keys` - List SSH keys associated with your profile
- `get_ssh_key` - Get details for a specific SSH key
- `create_ssh_key` - Add a new SSH key to your profile
- `update_ssh_key` - Update an existing SSH key
- `delete_ssh_key` - Delete an SSH key from your profile
#### API Token Operations
- `list_api_tokens` - List API tokens associated with your profile
- `get_api_token` - Get details for a specific API token
- `create_personal_access_token` - Create a new personal access token
- `update_api_token` - Update an existing API token
- `delete_api_token` - Delete an API token
- `list_api_scopes` - List available API scopes for tokens and OAuth clients
#### Two-Factor Authentication
- `get_two_factor_secret` - Get a two-factor authentication secret and QR code
- `enable_two_factor` - Enable two-factor authentication for your account
- `disable_two_factor` - Disable two-factor authentication for your account
#### Authorized Apps
- `list_authorized_apps` - List OAuth apps authorized to access your account
- `get_authorized_app` - Get details about a specific authorized OAuth app
- `revoke_authorized_app` - Revoke access for an authorized OAuth app
#### Trusted Devices
- `list_trusted_devices` - List devices trusted for two-factor authentication
- `get_trusted_device` - Get details about a specific trusted device
- `revoke_trusted_device` - Revoke trusted status for a device
#### Grants
- `list_grants` - List grants for a restricted user
#### Login History
- `list_logins` - List login history for your account
- `get_login` - Get details about a specific login event
#### Phone Verification
- `delete_phone_number` - Delete the phone number associated with your account
- `send_phone_verification` - Send a verification code to a phone number
- `verify_phone_number` - Verify a phone number with a received code
#### User Preferences
- `get_user_preferences` - Get user interface preferences
- `update_user_preferences` - Update user interface preferences
#### Security Questions
- `get_security_questions` - Get available security questions
- `answer_security_questions` - Answer security questions for account recovery
### 🏢 Account
Manage Linode account information, users, billing, and settings.
#### Account Operations
- `get_account` - Get your account information
- `update_account` - Update your account information
#### Agreements and Services
- `list_agreements` - List legal agreements
- `acknowledge_agreements` - Acknowledge legal agreements
- `list_available_services` - List available services by region
- `get_region_service_availability` - Get service availability for a specific region
#### Account Management
- `cancel_account` - Cancel your account
#### Events
- `list_events` - List account events
- `get_event` - Get a specific event
- `mark_event_as_seen` - Mark an event as seen
#### Billing
- `list_invoices` - List invoices
- `get_invoice` - Get a specific invoice
- `list_invoice_items` - List items for a specific invoice
- `get_account_network_transfer` - Get network transfer information for the entire account
#### Login & Maintenance
- `list_account_logins` - List account logins
- `get_account_login` - Get a specific account login
- `list_maintenances` - List maintenance events
- `list_notifications` - List notifications
#### OAuth Clients
- `list_oauth_clients` - List OAuth clients
- `create_oauth_client` - Create an OAuth client
- `get_oauth_client` - Get an OAuth client
- `update_oauth_client` - Update an OAuth client
- `delete_oauth_client` - Delete an OAuth client
- `reset_oauth_client_secret` - Reset an OAuth client secret
#### Account Settings
- `get_account_settings` - Get account settings
- `update_account_settings` - Update account settings
- `enable_managed_service` - Enable Linode Managed service
#### User Management
- `list_users` - List users
- `create_user` - Create a user
- `get_user` - Get a user
- `update_user` - Update a user
- `delete_user` - Delete a user
- `get_user_grants` - [DEPRECATED] Get a user's grants
- `update_user_grants` - [DEPRECATED] Update a user's grants
#### IAM / Identity Management
- `list_entities` - List entities
- `list_iam_roles` - List available IAM roles
- `get_user_role_permissions` - Get a user's IAM role permissions
- `update_user_role_permissions` - Update a user's IAM role permissions
#### Delegation
- `list_delegation_child_accounts` 🧪 *beta* - List child accounts for delegation
- `get_delegation_child_account_users` 🧪 *beta* - Get delegation for a child account
- `update_delegation_child_account_users` 🧪 *beta* - Update delegation for a child account
- `get_delegation_default_roles` 🧪 *beta* - Get default role assignment for delegates
- `update_delegation_default_roles` 🧪 *beta* - Update default role assignment
- `list_delegation_profile_accounts` 🧪 *beta* - Get your account delegations
- `get_delegation_profile_account` 🧪 *beta* - Get a child account from delegations
- `create_delegation_token` 🧪 *beta* - Create a delegate user token
- `get_user_delegations` - Get a user's account delegations
#### Resource Locks
- `list_resource_locks` 🧪 *beta* - List resource locks
- `get_resource_lock` 🧪 *beta* - Get a resource lock
- `create_resource_lock` 🧪 *beta* - Create a resource lock
- `delete_resource_lock` 🧪 *beta* - Delete a resource lock
#### Maintenance Policies
- `list_maintenance_policies` - List maintenance policies
### 📡 Monitor
Manage monitoring alerts, log streams, metrics dashboards, and service monitoring.
#### Notification Channels
- `list_notification_channels` 🧪 *beta* - List notification channels
- `get_notification_channel` 🧪 *beta* - Get a notification channel
- `create_notification_channel` 🧪 *beta* - Create a notification channel
- `update_notification_channel` 🧪 *beta* - Update a notification channel
- `delete_notification_channel` 🧪 *beta* - Delete a notification channel
- `list_channel_alerts` 🧪 *beta* - List alerts for a channel
#### Alert Definitions
- `list_alert_definitions` 🧪 *beta* - List all alert definitions
- `list_service_alert_definitions` 🧪 *beta* - List alert definitions for a service type
- `get_alert_definition` 🧪 *beta* - Get an alert definition
- `create_alert_definition` 🧪 *beta* - Create an alert definition
- `update_alert_definition` 🧪 *beta* - Update an alert definition
- `delete_alert_definition` 🧪 *beta* - Delete an alert definition
#### Log Streams
- `list_log_streams` 🧪 *beta* - List log streams
- `get_log_stream` 🧪 *beta* - Get a log stream
- `create_log_stream` 🧪 *beta* - Create a log stream
- `update_log_stream` 🧪 *beta* - Update a log stream
- `delete_log_stream` 🧪 *beta* - Delete a log stream
- `get_log_stream_history` 🧪 *beta* - Get log stream history
#### Log Destinations
- `list_log_destinations` 🧪 *beta* - List log destinations
- `get_log_destination` 🧪 *beta* - Get a log destination
- `create_log_destination` 🧪 *beta* - Create a log destination
- `update_log_destination` 🧪 *beta* - Update a log destination
- `delete_log_destination` 🧪 *beta* - Delete a log destination
- `get_log_destination_history` 🧪 *beta* - Get log destination history
#### Dashboards & Metrics
- `list_monitor_dashboards` - List monitor dashboards
- `get_monitor_dashboard` - Get a dashboard
- `list_monitor_services` - List supported service types
- `get_monitor_service` - Get a service type
- `list_service_dashboards` - List dashboards for a service type
- `list_service_metric_definitions` - List metrics for a service type
- `get_service_metrics` - Get metrics for entities
- `create_service_token` - Create a token for a service type
## License
MIT
