Skip to Content
aka.localhost

AI agents

Let coding agents find the URL of the app they work on.

aka mcp is a Model Context Protocol server over stdio. A coding agent can use it to look up the URL of the app it is working on instead of guessing a port.

Set it up

For Claude Code:

claude mcp add aka -- aka mcp

For other MCP clients, add it to the client's configuration:

{ "mcpServers": { "aka": { "command": "aka", "args": ["mcp"] } } }

Tools

ToolWhat it does
list_appsthe running apps and aliases, with their URLs
get_urlthe URL of one app
add_aliasroute a name to a port
remove_aliasremove an alias
doctorrun the setup checks

The server does not start dev servers. Agents run aka <name> <command> in a shell.

Docs for agents

These docs are also served as plain text: /llms.txt lists every page, /llms-full.txt has all of them in one file, and each page has a Markdown version (the copy button at the top of the page).

On this page