Headscale (Tailscale Alternative) MCP Server for Vercel AI SDKGive Vercel AI SDK instant access to 18 tools to Create Api Key, Create Preauth Key, Create User, and more
GDPR Free for SubscribersThe Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Headscale (Tailscale Alternative) through Vinkius and every tool is available as a typed function. ready for React Server Components, API routes, or any Node.js backend.
Ask AI about this MCP Server for Vercel AI SDK
The Headscale (Tailscale Alternative) MCP Server for Vercel AI SDK is a standout in the Cloud Infrastructure category — giving your AI agent 18 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token. get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using Headscale (Tailscale Alternative), list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Headscale (Tailscale Alternative) MCP Server
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.
The Vercel AI SDK gives every Headscale (Tailscale Alternative) tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 18 tools through Vinkius and stream results progressively to React, Svelte, or Vue components. works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
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
The Headscale (Tailscale Alternative) MCP Server exposes 18 tools through the Vinkius. Connect it to Vercel AI SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 18 Headscale (Tailscale Alternative) tools available for Vercel AI SDK
When Vercel AI SDK connects to Headscale (Tailscale Alternative) through Vinkius, your AI agent gets direct access to every tool listed below — spanning vpn, mesh-network, networking, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create api key on Headscale (Tailscale Alternative)
Create a new API key
Create preauth key on Headscale (Tailscale Alternative)
Create a new pre-auth key
Create user on Headscale (Tailscale Alternative)
Create a new user in Headscale
Delete node on Headscale (Tailscale Alternative)
Remove a node from the Headscale network
Delete user on Headscale (Tailscale Alternative)
Delete a user from Headscale
Disable route on Headscale (Tailscale Alternative)
Disable a specific route
Enable route on Headscale (Tailscale Alternative)
Enable a specific route
Expire api key on Headscale (Tailscale Alternative)
Expire an API key
Expire node on Headscale (Tailscale Alternative)
Force expiration of a node session
Expire preauth key on Headscale (Tailscale Alternative)
Expire a pre-auth key
Get node on Headscale (Tailscale Alternative)
Get details for a specific node
List api keys on Headscale (Tailscale Alternative)
List all API keys
List nodes on Headscale (Tailscale Alternative)
List all nodes (machines) connected to Headscale
List preauth keys on Headscale (Tailscale Alternative)
List pre-auth keys
List routes on Headscale (Tailscale Alternative)
List all subnet routes and exit nodes
List users on Headscale (Tailscale Alternative)
List all users in Headscale
Move node on Headscale (Tailscale Alternative)
Move a node to a different user
Rename node on Headscale (Tailscale Alternative)
Rename a node in Headscale
Connect Headscale (Tailscale Alternative) to Vercel AI SDK via MCP
Follow these steps to wire Headscale (Tailscale Alternative) into Vercel AI SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @ai-sdk/mcp ai @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the script
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Vercel AI SDK with the Headscale (Tailscale Alternative) MCP Server
Vercel AI SDK provides unique advantages when paired with Headscale (Tailscale Alternative) through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime. same Headscale (Tailscale Alternative) integration everywhere
Built-in streaming UI primitives let you display Headscale (Tailscale Alternative) tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
Headscale (Tailscale Alternative) + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the Headscale (Tailscale Alternative) MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query Headscale (Tailscale Alternative) in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate Headscale (Tailscale Alternative) tools and return structured JSON responses to any frontend
Chatbots with tool use: embed Headscale (Tailscale Alternative) capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with Headscale (Tailscale Alternative) through natural language queries
Example Prompts for Headscale (Tailscale Alternative) in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK agent to start working with Headscale (Tailscale Alternative) immediately.
"List all nodes currently connected to my Headscale network."
"Create a new user named 'external-contractors' and generate a reusable pre-auth key for them."
"Get full details for node ID 12 and then expire its session."
Troubleshooting Headscale (Tailscale Alternative) MCP Server with Vercel AI SDK
Common issues when connecting Headscale (Tailscale Alternative) to Vercel AI SDK through Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpHeadscale (Tailscale Alternative) + Vercel AI SDK FAQ
Common questions about integrating Headscale (Tailscale Alternative) MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.Explore More MCP Servers
View all →
Rio Grande do Sul (Dados RS)
11 toolsAccess the official Open Data portal of Rio Grande do Sul — query public datasets, government organizations, and thematic groups directly.
ExchangeRate-API
5 toolsGlobal currency exchange platform — get real-time rates and perform conversions via AI.
Resemble AI
16 toolsGenerate high-quality AI voices, manage projects, and transform speech with Resemble AI's powerful voice cloning and synthesis tools.
Payhip
11 toolsSell ebooks, courses, memberships, and digital downloads directly to your audience with zero upfront costs and simple setup.