MCP For Claude Marketplace
Headscale (Tailscale Alternative)

Headscale (Tailscale Alternative) MCP Connector for Claude

A+

Manage your private Tailscale network via Headscale — control users, nodes, and pre-auth keys directly from your AI agent.

18 tools Official Updated Oct 1, 2026 Official Vinkius Partner
More Details Connect to Claude

Connect your self-hosted Headscale server to any AI agent and take full control of your private mesh network through natural conversation. Headscale provides an open-source, self-hosted alternative to the Tailscale control server.

What you can do

  • User Management — Create, list, and delete administrative users (namespaces) to organize your network segments
  • Node Control — List all connected machines, fetch detailed metadata for specific nodes, and rename or move them between users
  • Session Security — Force node expirations or delete machines from the network to revoke access instantly
  • Automated Registration — Generate and manage pre-auth keys (reusable or ephemeral) to allow new nodes to join without manual approval
  • Route Management — Inspect and toggle network routes to manage traffic flow across your mesh

How it works

  1. Subscribe to this server
  2. Enter your Headscale API Key and Server URL
  3. Start managing your infrastructure from Claude, Cursor, or any MCP-compatible client

No more SSH-ing into your controller just to check if a node is online or to generate a registration key. Your AI acts as a network administrator.

Who is this for?

  • DevOps Engineers — quickly audit connected nodes and manage namespaces without leaving the terminal or IDE
  • Sysadmins — automate the lifecycle of VPN nodes and pre-authentication keys for team onboarding
  • Privacy-Conscious Teams — maintain full control over your self-hosted Tailscale alternative with an AI-powered interface
vpnmesh-networknetworkingself-hostedidentity-accessinfrastructure

18 tools expose this connector's capabilities to your AI agent.

disable_route

Disable a specific route

create_preauth_key

Create a new pre-auth key

enable_route

Enable a specific route

create_api_key

Create a new API key

create_user

Create a new user in Headscale

delete_node

Remove a node from the Headscale network

expire_api_key

Expire an API key

get_node

Get details for a specific node

list_api_keys

List all API keys

list_nodes

List all nodes (machines) connected to Headscale

list_preauth_keys

List pre-auth keys

list_routes

List all subnet routes and exit nodes

list_users

List all users in Headscale

rename_node

Rename a node in Headscale

delete_user

Delete a user from Headscale

expire_node

Force expiration of a node session

expire_preauth_key

Expire a pre-auth key

move_node

Move a node to a different user

See how to talk to your AI agent using Headscale (Tailscale Alternative).

List all nodes currently connected to my Headscale network.

I've retrieved the node list. You have 4 active nodes: 'web-server-01' (IP: 100.64.0.1), 'db-primary' (IP: 100.64.0.2), and two others. All are currently online except for 'backup-node'.

Create a new user named 'external-contractors' and generate a reusable pre-auth key for them.

User 'external-contractors' has been created successfully. I have also generated a reusable pre-auth key: `hs_auth_...`. This key can be used to register multiple machines under this user.

Get full details for node ID 12 and then expire its session.

Inspecting node 12... It's a Linux machine named 'dev-laptop-old'. I have now triggered the `expire_node` action. The machine will be disconnected and will require re-authentication to join the network again.

Yes. Use the `move_node` tool by providing the Node ID and the target User name. The agent will reassign the machine to the new namespace immediately.

Related Connectors

GoRest

GoRest MCP

23 tools Official

Access and manage RESTful data for users, posts, and comments via the GoRest API — perfect for testing, prototyping, and data simulation.

A+ View details →
Nakama

Nakama MCP

31 tools Official

Automate your game backend via Nakama — manage authentication, user profiles, social features, and storage directly from any AI agent.

A+ View details →
Novu

Novu MCP

39 tools Official

Automate multi-channel notifications via Novu — trigger workflows, manage subscribers, and handle preferences directly from any AI agent.

A+ View details →
Lit Protocol (Decentralized Access Control)

Lit Protocol (Decentralized Access Control) MCP

20 tools Official

Manage decentralized access control, Programmable Key Pairs (PKPs), and execute immutable Lit Actions within TEEs directly from your AI agent.

A+ View details →