Heimdall MCP Server

@shinzo-labs

Repository

Basic information

About Heimdall MCP Server

Control the tools your MCP-enabled agents can access with minimal overhead.

#heimdall#mcp-servers#service-management

Heimdall MCP Server config

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

{
  "mcpServers": {
    "heimdall": {
      "command": "npx",
      "args": [
        "@shinzolabs/heimdall"
      ]
    }
  }
}

Heimdall MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Heimdall?

Heimdall is a lightweight service to manage local MCP Servers, installed with a single npx command. It moves your existing MCP server configuration to a centralized location and allows you to authorize specific tools for each server, making that configuration accessible to all MCP clients on your device.

How to use Heimdall?

Run the setup script via npx: npx @shinzolabs/heimdall setup <optional: path/to/current/config.json>. This moves your mcpServers config to ~/.heimdall/config.json and inserts a single Heimdall entry in its place. Then configure authorized tools in ~/.heimdall/controls.json and add the Heimdall configuration to each MCP client's config.

Key features of Heimdall

Centralized MCP server configuration in ~/.heimdall/config.json
Per-server authorization of tools via ~/.heimdall/controls.json
Same configuration accessible to all MCP clients on your device
Simple setup with a single npx command
Logs stored at ~/.heimdall/logs for debugging

Use cases of Heimdall

Manage multiple MCP servers across different clients without duplicating configuration
Restrict which tools an MCP client can use on a per-server basis
Quickly onboard new MCP clients by reusing the same Heimdall entry

Frequently asked questions

How does Heimdall modify my existing MCP config?

The setup script moves your `mcpServers` config JSON to `~/.heimdall/config.json` and inserts a single `heimdall` configuration entry in its place at the original path.

What dependencies or runtime does Heimdall require?

Heimdall is a Node.js package installed via npx, so it requires Node.js and npm already available on your system.

Where are Heimdall’s config and logs stored?

Config is at `~/.heimdall/config.json`, controls at `~/.heimdall/controls.json`, and logs at `~/.heimdall/logs`.

Are there known limits on the number of tools?

Some MCP clients, like Cursor, limit the total number of tools across all servers (e.g., 40). The sum of `authorizedTools` in `controls.json` must not exceed that limit.

How does Heimdall handle authentication or transport?

The README does not provide specifics on authentication or transport beyond using the standard MCP client-server command setup (`npx`). It relies on the existing MCP protocol transport.

Comments

More Other MCP servers

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov