Free MCP tool

get_reference_item

Look up structured Human Design reference data on demand instead of packing an entire knowledge library into the model context.

Developer outcome: Keep prompts smaller while giving an agent precise reference context when it needs it.

Parameters

NameTypeRequiredDescription
kind"gate" | "channel" | "center" | "profile"YesReference collection to query.
idstringYesItem identifier, such as 34, 34-20, Sacral, or 1/3.

Request

Sanitized JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_reference_item",
    "arguments": {
      "kind": "gate",
      "id": "34"
    }
  }
}

Success response shape

  • Canonical identifier and label
  • Structured properties and descriptive context
  • Related reference data where available

The response also includes tier and quota metadata supplied by the API entitlement layer. Exact domain fields vary by tool and requested detail level.

Errors

  • Unsupported reference type
  • Reference item not found
  • Quota exceeded

Quota behavior

A successful call consumes one shared API unit. Failed entitlement checks do not run the tool. Check current usage at my.humandesign.ai.

Related tools

generate_chart