Routerbase

routerbase

routerbase answers three kinds of questions about home routers: what a model's factory login defaults are (gateway, login host, username/password, credential type, reset steps, and the manufacturer source the record cites), whether a model complies with the UK PSTI and EU CRA rules against universal default passwords, and who made the network hardware behind a MAC address. One binary serves a command-line interface and a stdio MCP server.

The data lives in a hosted service. routerbase is a local stdio server that forwards each call as a JSON-RPC tools/call request to the ssid.ai MCP endpoint at https://ssid.ai/mcp/http; that wire shape is a documented reconstruction from the service's public description. Point it elsewhere with SSID_API_BASE (a host or a full endpoint URL).

Read tools are free with no key. Setting SSID_API_KEY raises the rate limits and is sent as a Bearer token when present. submit_correction is different: the upstream gates that write tool behind its Pro tier, so without SSID_API_KEY routerbase refuses with an explanation and sends nothing — a correction is never reported as submitted when it was not.

For lookup_mac, the address classification is worked out locally, for real: the address is parsed and normalised (colon, hyphen, dot, and bare-hex forms are accepted), the multicast and locally-administered bits of the first octet decide between multicast, randomized, and universal, and anything unparseable is invalid. Only the vendor/OUI part comes from the upstream call, and an invalid address is never sent upstream.

Install

npx @reneturcios/routerbase lookup_mac 00:1A:2B:3C:4D:5E

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/routerbase

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

routerbase get_router_defaults --slug <slug>routerbase get_router_defaults --brand <brand> --model <model>routerbase check_router_compliance --slug <slug>routerbase lookup_mac 00:1A:2B:3C:4D:5Erouterbase submit_correction --slug <slug> --field gateway_ip \  --proposed-value 192.168.0.1 --source-url https://example.com/manual
routerbase --version

Successful commands print the result as JSON. Exit codes: 0 on success, 1 when a call fails (including an upstream error or the correction key gate), 2 for usage errors. get_router_defaults needs either --slug or both --brand and --model; anything less is an honest error, not a guess.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

npx -y @reneturcios/routerbase mcp

MCP client configuration:

{  "mcpServers": {    "routerbase": {      "command": "npx",      "args": ["-y", "@reneturcios/routerbase", "mcp"],      "env": {        "SSID_API_KEY": "your key, optional for read tools"      }    }  }}

Tools

Development

npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.