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 Jun 28, 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.

create_api_key

Create a new API key

create_preauth_key

Create a new pre-auth key

create_user

Create a new user in Headscale

delete_node

Remove a node from the Headscale network

delete_user

Delete a user from Headscale

disable_route

Disable a specific route

enable_route

Enable a specific route

expire_api_key

Expire an API key

expire_node

Force expiration of a node session

expire_preauth_key

Expire a pre-auth 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

move_node

Move a node to a different user

rename_node

Rename a node in Headscale

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

AI

Airtable MCP

7 tools Official

Query databases, manage records, and orchestrate workflows across your connected Airtable bases with full flexibility.

A+ View details →
NI

Ninox MCP

8 tools Official

Build custom business databases and apps with a visual platform that replaces spreadsheets with structured, relational data.

A+ View details →
IN

Instagram (Social Media & Business) MCP

10 tools Official

Manage your Instagram presence via AI — publish photos and reels, analyze insights, and manage comments.

A+ View details →
RA

Rappi API MCP

10 tools Official

Automate LatAm's largest super-app via Rappi — track active deliveries, request support, and manage logistics from your agent.

A+ View details →