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 behavior

This lookup is non-consuming. An authorized call uses zero API units and does not change the calculation quota. Tier, validation, and rate-limit checks still apply.

Related tools

generate_chart