Portal Dashboard Console Overview

The Web Portal console provides a centralized, secure control plane for checking component health, monitoring API traffic, managing client permissions, and tracking downstream connection telemetry.

1. Portal & Gateway Configuration

Configure the gateway binary or container using standard environment variables. Key parameters include:

2. Managing Connections & MCP Tools

Link target REST microservices to the LLM agent using these steps:

• API Connections: Register target base URLs. Assign a Namespace Prefix (e.g. stripe_) to isolate tool names and prevent conflicts across teams.
• MCP Tools: Expose routes (e.g., /v1/invoices/{{id}}). Map path and request parameters using JSON Schema Templates. The gateway translates these definitions into standard MCP schemas dynamically.
• Secrets Binding: A connection stores only a reference (Auth Secret Ref, e.g. prod/stripe/key), never the secret. Pick an Auth Type — none, bearer, basic (user:pass), or custom_headers (JSON header map) — and the gateway resolves the value from the Vault and injects it at call time. The LLM never sees downstream credentials. Rotate the secret in the Vault and every tool using it updates instantly.
• Scoped Client Tokens: Issue per-client bearer tokens restricted to tool-name globs (e.g. lch_*,ustreasury_*) and a role. Tokens are hashed at rest and shown once at creation.

3. Integrating with AI Clients

Connect your AI assistant to the gateway. The deployed gateway speaks two HTTPS MCP transports — Streamable HTTP (recommended; stateless, scales across replicas) via POST /mcp, and the legacy HTTP+SSE via GET /sse + POST /messages. A local stdio mode is also available.

A. Claude Code / remote clients — Streamable HTTP (recommended)

Add a project .mcp.json pointing at the /mcp endpoint:

{
  "mcpServers": {
    "janus-gateway": {
      "type": "http",
      "url": "https://your-gateway-host/mcp",
      "headers": { "Authorization": "Bearer your-issued-bearer-token" }
    }
  }
}

B. Antigravity — Streamable HTTP

Register the server in the Antigravity app's MCP config (its own config file, not the project repo):

{
  "mcpServers": {
    "janus-gateway": {
      "serverUrl": "https://your-gateway-host/sse",
      "headers": { "Authorization": "Bearer your-issued-bearer-token" }
    }
  }
}

C. Claude Desktop (stdio, local binary)

For a local desktop binary, add to claude_desktop_config.json:

{
  "mcpServers": {
    "api-gateway": {
      "command": "/path/to/mcp-gateway",
      "args": ["-stdio"],
      "env": {
        "DATABASE_PATH": "/path/to/mcp-gateway.db",
        "MCP_GATEWAY_TOKEN": "your-issued-bearer-token"
      }
    }
  }
}

D. Antigravity / Gemini SDK (legacy SSE, Python)

Advanced: connect a Python agent to the legacy Server-Sent Events endpoint:

from antigravity_sdk import Agent, ToolRegistry

registry = ToolRegistry.from_mcp_sse(
    url="http://localhost:8899/sse",
    headers={"Authorization": "Bearer your-issued-bearer-token"}
)

agent = Agent(
    name="System Assistant",
    tools=registry.list_tools()
)

4. Administrative CLI Usage (mcp-cli) & Monitoring

Use the compiled mcp-cli binary to manage configurations and run diagnostics remotely:

# Login and save session token
mcp-cli login admin --addr http://localhost:8899

# Run connection diagnostic checks
mcp-cli verify

# Monitor performance stats and raw Prometheus metrics
mcp-cli status
mcp-cli metrics

# Manage secret mappings in the Vault
mcp-cli vault set --key prod/billing/api-key --val "Bearer xoxb-..."
mcp-cli vault list

5. Interactive OpenAPI & Swagger Documentation

The gateway automatically aggregates all dynamic MCP tool routes into a single valid OpenAPI/Swagger schema. This allows external tools, developers, and LLMs to inspect the full available API surface.

Access the live Swagger UI from the Dashboard or by opening `/swagger.html` in your browser. You can copy the schema directly from the modal or download the JSON spec.

6. Running the Demos

Two ready-to-run demos exercise the gateway end-to-end, generating a Cross-Currency Collateral Valuation & Multi-Jurisdiction Rate Audit for LCH member MEM-LCH-002. The agent aggregates LCH collateral, U.S. Treasury rates, the Bank of England Bank Rate, ECB euro FX, and Eurostat inflation — all through the single governed gateway — and consolidates the multi-currency portfolio into a GBP reporting value.

• just demo-claude — runs the demo through Claude Code (Streamable HTTP via .mcp.json).
• just demo-antigravity — runs the demo through Antigravity (agy), driven by the lch-collateral-reporting skill.

# from the repo root (needs the janus-gateway MCP client configured)
just demo-claude
just demo-antigravity

# override the client token used by the demo:
JANUS_GATEWAY_TOKEN=<token> just demo-claude

Full instructions and a sample generated report are in the project README.md and on the documentation site.