Hosted Mode
Connect to Planu without installing anything locally — just add a URL to your AI tool's config file.
When to use Hosted Mode
Hosted Mode is ideal for quick setup, team onboarding, or when you can't install the binary on your machine. For persistent data and offline access, use Local Mode instead.
Quick Start
Add the config block for your AI tool. The only thing that changes between tools is the file location and key names.
Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"planu": {
"url": "https://planu-mcp-production.up.railway.app/mcp",
"headers": {
"x-planu-license-key": "YOUR-KEY-HERE"
}
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"planu": {
"url": "https://planu-mcp-production.up.railway.app/mcp",
"headers": {
"x-planu-license-key": "YOUR-KEY-HERE"
}
}
}
}VS Code
Add to .vscode/mcp.json:
{
"servers": {
"planu": {
"type": "http",
"url": "https://planu-mcp-production.up.railway.app/mcp",
"headers": {
"x-planu-license-key": "YOUR-KEY-HERE"
}
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"planu": {
"serverUrl": "https://planu-mcp-production.up.railway.app/mcp",
"headers": {
"x-planu-license-key": "YOUR-KEY-HERE"
}
}
}
}Local vs Hosted
| Feature | Local (binary) | Hosted |
|---|---|---|
| Installation | planu install --global | None — just a URL |
| Updates | Automatic via npm | Automatic — always latest |
| Data storage | Local JSON files | Per-session (no persistence) |
| License | Activated per machine | Via HTTP header per request |
| Offline | Yes | No |
| Best for | Full workflow, persistent data | Quick setup, team onboarding |
License Key
The public MCP inventory is maintained in the product manifest and documented in the tools reference. Public pricing and new paid enrollment are unavailable during the donation experiment.
Existing hosted credentials are passed via the x-planu-license-key header on every request.
Replace YOUR-KEY-HERE in the config snippets above with your actual license key. If you don't have one yet, remove the headers block entirely to use the free tier.
Health Check
Verify the hosted server is running:
https://planu-mcp-production.up.railway.app/healthA 200 OK response means the server is up and ready. If you get a timeout or error, check the Planu Discord for status updates.