Unlocalhost MCP server
io.github.info-arnav/unlocalhost·v0.1.1·3 starsDeploy localhost to a private, authenticated link from your AI coding agent.
3 stars25 downloads/wk
Reviews
Write oneNobody has reviewed Unlocalhost yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Unlocalhost tools (7, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
unlocalhost_deploywrite actionDeploy a GitHub repository and get a private URL. IMPORTANT: before calling this, you must yourself create a GitHub repository and push the code using the user's own git credentials, and make sure .env is listed in .gitignore. Pass any .env values through the env argument instead of committing them. STORAGE: the deployed app gets a persistent disk at /app/data and an env var DATABASE_PATH set to /
unlocalhost_listList the apps this user has deployed, with URLs and status.
unlocalhost_loginStart a one-time browser sign-in. Show the user the returned URL and code, then wait — this tool blocks until they approve.
unlocalhost_logsFetch runtime and build logs for an app. Use this to diagnose a failed deploy, then fix the code and deploy again.
unlocalhost_shareGrant email addresses access to a deployed app.
unlocalhost_statusReport which unlocalhost instance this MCP is pointed at and whether it is signed in.
unlocalhost_unsharewrite actionRemove email addresses from an app allowlist. Takes effect immediately.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan11 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 60 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Unlocalhost compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 50% of 1,119 Developer tools servers
- Tools
- 7
- the typical Developer tools server has 7
- Tools that change things
- 29%
- typical: 5%. Fewer write tools means less an agent can break
- GitHub stars
- 3
- more than 75% of 855 Developer tools servers
- Downloads a week
- 25
- more than 9% of 436 Developer tools servers with a package
What its tools let an agent do: 5 read · 2 change
Install Unlocalhost in Claude Code, Cursor or VS Code
Runs npx -y @unlocalhost/unlocalhost on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add unlocalhost -- npx -y @unlocalhost/unlocalhost
What the publisher says
From the Unlocalhost repository's README, as published. We do not edit it. Read it on GitHub
unlocalhost
Turn localhost into a link only the people you name can open.
Sign in is built in, so you write no auth code and touch no servers.
Website · Docs · MIT licensed · Self hostable
The problem
Your coding agent can write the whole application. It cannot host it, because hosting needs a server, a domain, a certificate, and a login system. So people reach for whatever is fastest, and that is where things go wrong: a public URL with no sign in, an API key committed by accident, or auth bolted on at the end by someone who has never written auth.
unlocalhost closes that gap. You say one sentence to the agent you already have open, and you get back a real URL with a guest list in front of it.
you deploy this and let sarah@gmail.com in
agent pushed your code to a private repo
agent building
agent live at sarahs-todo.unlocalhost.tech
agent sarah@gmail.com can sign in and open itHow it works
with GitHub.
- You add unlocalhost to your coding agent as an MCP server and sign in once
never holds write access to anything.
- You tell the agent to deploy, and name who is allowed in.
- Your agent pushes the code using your own git credentials. unlocalhost
find any, then build and run it.
- We clone read only, scan for committed secrets and refuse to continue if we
against the guest list before the request ever reaches your app.
- Visitors sign in with GitHub or Google. Their verified email is checked
What makes it different
Quick start
claude mcp add unlocalhost -- npx -y @unlocalhost/unlocalhostOr in any MCP client config:
{
"mcpServers": {
"unlocalhost": {
"command": "npx",
"args": ["-y", "@unlocalhost/unlocalhost"]
}
}
}Then ask your agent to sign in to unlocalhost, and deploy.
Self hosting
The hosted service runs this exact code. Nothing is held back, there is no phone home, and no license check.
git clone https://github.com/info-arnav/unlocalhost.git
cd unlocalhost/deploy
cp .env.example .env # fill it in
docker compose --env-file .env run --rm migrate
docker compose --env-file .env up -dYou need a domain with wildcard DNS, a DNS provider API token for wildcard TLS, a GitHub App, and a Google OAuth client. The full walkthrough is in docs/server-setup.md.
Architecture
internet :443 → Caddy → auth-gate /verify → activator → Dokku → your appShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Unlocalhost: common questions
- Is Unlocalhost MCP server safe?
- Mostly: it is graded B (78/100). Read the Unlocalhost safety report
- How do I install Unlocalhost?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Unlocalhost need an API key?
- Yes. The registry entry asks for
UNLOCALHOST_TOKEN. - Is Unlocalhost maintained?
- The last commit was 101 days ago (2026-07-26). The latest release is v0.1.1.
- What can I use instead of Unlocalhost?
- Servers from other publishers that do the same job: komnet MCP server, walkerOS Flow MCP server and Omnara MCP server.
- How does Unlocalhost compare with other Developer tools MCP servers?
- safety score 78/100 (higher than 50% of 1,119 Developer tools servers); tools 7 (the typical Developer tools server has 7); tools that change things 29% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Unlocalhost
Same job from other publishers: the closest match first, then the best rated.
- komnetLets AI coding agents coordinate asynchronously through a private git repository. No server.not reviewedGrowingA
walkerOS FlowBuild, validate, simulate, and deploy walkerOS event pipelinesnot reviewedEstablishedB- OmnaraDeploy durable AI agents with Omnara, an open-source managed-agent platform.not reviewedEstablishedA
RepowiseCodebase intelligence for AI coding agents — graph, git history, docs, decisions, code health.not reviewedEstablishedB- Metaplex Agent RegistryDeploy AI agents on-chain on Solana with an EIP-8004 identity. Deploy fee funds $THREE buybacks.not reviewedEstablishedB