Human Design

MCP for Human Design

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "dvvolkovv-mcp_human_design": {
      "command": "npm",
      "args": [
        "run",
        "start:mcp"
      ]
    }
  }
}

You can run and use the Human Design MCP Server to compute Human Design charts from birth data. It exposes a programmable interface via MCP so you can calculate a full chart, retrieve definitions for components, and integrate with other systems that support the Model Context Protocol.

How to use

You will interact with the Human Design MCP Server through an MCP client. Start the local MCP server, then send requests to calculate a full Human Design map or to fetch definitions for specific components. The server is designed to be integrated with automation tools and workflow systems. When you request a calculation, you provide birthDate, birthTime, birthLocation, and optional latitude and longitude. The server will return the type, strategy, authority, profile, gates, defined centers, and incarnation cross for the given birth data.

How to install

Prerequisites you need to install and run locally are Node.js version 18.0.0 or newer and npm or yarn for package management. Ensure native build tools are available if you install Swiss Ephemeris bindings.

npm install

# or if you are using yarn
# yarn install

# Build the project before running
npm run build

# Start the MCP server (stdio mode)
npm run start:mcp

# Start the HTTP server for Railway/n8n (if you use the HTTP interface)
npm start

Additional notes and guidance

The server uses Swiss Ephemeris to provide accurate planetary positions. It operates in two modes: an HTTP server on port 3000 by default (or the PORT you specify via environment variables) and a stdio-based MCP server that you start with a dedicated command. When running in stdio mode, the command and its arguments must be exactly as shown. Make sure any native modules are properly built during installation.

Available tools

calculate_human_design

Calculates the full Human Design chart given birthDate, birthTime, birthLocation and optional latitude/longitude.

get_human_design_definition

Retrieves definitions for specified Human Design components such as type, authority, profile, gates, channels, or centers.