JanusMCP

Name: JanusMCP
Author: bayway

@bayway

About JanusMCP

Local, open-source multi-account MCP broker — one endpoint, every account. Add credentials once and switch identity without reconnecting, from any LLM client.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "janusmcp": {
      "command": "npx",
      "args": [
        "@bayway/janusmcp",
        "serve",
        "#",
        "npm",
        "(works",
        "inside",
        "MCP/npx",
        "setups)"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is JanusMCP?

JanusMCP is a local broker that sits between any LLM client and real MCP servers, allowing you to add multiple accounts for the same service and switch identity without reconnecting. It’s designed for users who work with multiple companies or identities and need a single endpoint that handles per‑account credentials.

How to use JanusMCP?

Install via npm (npx @bayway/janusmcp serve), Homebrew, Scoop, Docker, or build from source. Configure accounts and secrets in config.json and the OS keychain, then run janusmcp serve for stdio or set JANUS_TRANSPORT=http for HTTP. From any connected LLM client use the control tools janus_list_accounts, janus_use_account, and janus_whoami to switch identities; terminal commands like janusmcp tools and janusmcp call provide code‑execution mode.

Key features of JanusMCP

Multi‑account, one endpoint: N identities, no reconnecting.
Identity scoping: per‑call, per‑session (Mcp‑Session‑Id), or global.
Dual transport: stdio + Streamable HTTP in one process.
Secure vault: OS keychain with encrypted‑file fallback.
OAuth loopback: PKCE login with auto‑refresh, stored as oauth:<name>.
Context‑safe: only the active account’s tools are exposed.

Use cases of JanusMCP

Manage Supabase, GitHub, or Slack accounts for different clients without reconnecting.
Switch between work and personal identities for the same service in any LLM.
Use profiles to flip the entire set of accounts (e.g., Supabase + GitHub) for a client in one command.
Reduce context cost by invoking tools on demand from the terminal (code‑execution mode).
Add accounts from built‑in templates and keep secrets in the OS keychain.

FAQ from JanusMCP

How is JanusMCP different from other MCP gateways?

Other MCP gateways aggregate different servers behind one endpoint. JanusMCP solves the orthogonal problem of managing many identities for the same service without saturating context. It is a credential‑aware broker, not a flat aggregator.

Which LLM clients does JanusMCP work with?

JanusMCP speaks standard MCP (stdio + Streamable HTTP), so it works with any client: Claude Desktop, Claude Code, Cursor, Visual Studio Code, Gemini, ChatGPT, Copilot, and others.