MCP Resources Reference

MCP resources are read-only reference data that your AI agent can fetch to better understand Human Design concepts and chart response structures. Unlike tools, resources do not perform calculations — they provide static context that helps the agent interpret tool results.

Resources are read using the JSON-RPC resources/read method at POST https://api.totalhumandesign.com/mcp.

thd://reference/terminology

A structured reference of Human Design terminology in plain language. Covers types, strategies, authorities, centers, channels, and gates — everything an AI agent needs to explain chart data to users.

Example request

resources/readjson

{
"jsonrpc": "2.0",
"id": 1,
"method": "resources/read",
"params": {
  "uri": "thd://reference/terminology"
}
}

Example response

{
"jsonrpc": "2.0",
"id": 1,
"result": {
  "contents": [
    {
      "uri": "thd://reference/terminology",
      "mimeType": "application/json",
      "text": "{\"types\":{\"Generator\":\"Builders of the world. Strategy is to respond. ~70% of population.\",\"Manifestor\":\"Initiators. Strategy is to inform before acting.\",\"Projector\":\"Guides and advisors. Strategy is to wait for the invitation.\",\"Reflector\":\"Mirrors of community. Strategy is to wait a lunar cycle.\",\"Manifesting Generator\":\"Multi-passionate builders. Strategy is to respond, then inform.\"},\"authorities\":{\"Sacral\":\"Gut response — uh-huh (yes) or unh-unh (no).\",\"Emotional\":\"Wait through emotional wave before deciding.\",\"Splenic\":\"Instantaneous intuitive knowing in the moment.\"},\"centers\":{\"Head\":\"Inspiration and mental pressure.\",\"Ajna\":\"Conceptualization and mental processing.\",\"Throat\":\"Communication and manifestation.\",\"G\":\"Identity, direction, and love.\",\"Heart\":\"Willpower and ego.\",\"Sacral\":\"Life force and work energy.\",\"Spleen\":\"Intuition, health, and survival instincts.\",\"Solar Plexus\":\"Emotions and feelings.\",\"Root\":\"Adrenaline and drive.\"}}"
    }
  ]
}
}

Use with tools

Fetch this resource once at the start of a conversation, then use it to interpret results from generate_chart or generate_composite. This avoids repeated lookups and gives the agent the vocabulary to explain chart properties.

thd://reference/chart-fields

A field-by-field breakdown of the V2 chart response structure. Documents every top-level and nested property, its data type, and what it represents. Useful for agents that need to parse or summarize chart data programmatically.

Example request

resources/readjson

{
"jsonrpc": "2.0",
"id": 2,
"method": "resources/read",
"params": {
  "uri": "thd://reference/chart-fields"
}
}

Example response

{
"jsonrpc": "2.0",
"id": 2,
"result": {
  "contents": [
    {
      "uri": "thd://reference/chart-fields",
      "mimeType": "application/json",
      "text": "{\"type\":{\"dataType\":\"string\",\"description\":\"One of: Generator, Manifesting Generator, Projector, Manifestor, Reflector\"},\"strategy\":{\"dataType\":\"string\",\"description\":\"Decision-making strategy based on type\"},\"authority\":{\"dataType\":\"string\",\"description\":\"Inner authority for decision-making\"},\"profile\":{\"dataType\":\"string\",\"description\":\"Profile line combination, e.g. 3/5\"},\"definition\":{\"dataType\":\"string\",\"description\":\"How energy flows between centers: Single, Split, Triple Split, Quadruple Split, None\"},\"centers\":{\"dataType\":\"object\",\"description\":\"Contains defined (array of strings) and open (array of strings) center names\"},\"channels\":{\"dataType\":\"array\",\"description\":\"Each item has gates (string, e.g. 1-8), name (string), circuitry (string)\"},\"personality\":{\"dataType\":\"object\",\"description\":\"Conscious planetary positions. Each planet key maps to {gate, line, color, tone, base, longitude, sign}\"},\"design\":{\"dataType\":\"object\",\"description\":\"Unconscious planetary positions. Same structure as personality\"},\"phs\":{\"dataType\":\"object\",\"description\":\"Primary Health System data: digestion and environment sub-objects\"},\"variable\":{\"dataType\":\"string\",\"description\":\"Variable string, e.g. PLL DRR\"}}"
    }
  ]
}
}

Resources are read-only

Resources cannot be modified or parameterized. They return the same reference data on every read. For dynamic data (charts, transits), use MCP tools.