Skip to main content
Glama

entity_lookup

Read-only

Find TCLP content (clauses, glossary terms, guides) associated with a named concept.

Unlike `search`, this performs a deterministic name match against Entity nodes in
the knowledge graph rather than a relevance-ranked semantic search. Use it when
you have a specific term or concept (e.g. "scope 3 emissions", "net zero") and
want to retrieve every clause or glossary entry that explicitly references it.

Args:
    name: The entity or concept name to look up (exact match, case-insensitive).
    limit: Maximum number of results to return (1–50).
    include_full_text: Include each hit's full body text (Markdown). Off by
        default — bodies are large; request only when you need the content,
        and prefer a small `limit` when you do.

Returns:
    JSON with "meta" and "results" where each hit includes the source content
    node and the entity names that matched.
    Each hit's "references" lists the instruments it cites: pass a
    reference's `work_id` to `get_legal_resource` for details. A reference's
    `edge` (governs, references, describes) says how the content relates to
    the instrument; it is not a statement of the instrument's legal effect.
    An empty list means the hit cites no instruments. null with "lrsf" in
    meta.degraded means references could not be loaded: do not conclude
    that the hit cites no instruments.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameYes
limitNo
include_full_textNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
metaYes
resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • addedInput schema / properties / limit / maximum
      Added value: +50
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • addedInput schema / properties / name / maxLength
      Added value: +1000
    • addedInput schema / properties / name / minLength
      Added value: +1
    • removedOutput schema / $defs / _EntityHit / properties / relationships
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "items": {
      -        "$ref": "#/$defs/_Relationship"
      -      },
      -      "type": "array"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "title": "Relationships"
      -}
    • removedOutput schema / $defs / _Relationship
      Removed value: -{
      -  "properties": {
      -    "path_types": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "title": "Path Types",
      -      "type": "array"
      -    },
      -    "target_id": {
      -      "title": "Target Id",
      -      "type": "string"
      -    },
      -    "target_label": {
      -      "title": "Target Label",
      -      "type": "string"
      -    },
      -    "target_name": {
      -      "title": "Target Name",
      -      "type": "string"
      -    },
      -    "target_url": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "title": "Target Url"
      -    }
      -  },
      -  "required": [
      -    "path_types",
      -    "target_id",
      -    "target_label",
      -    "target_name",
      -    "target_url"
      -  ],
      -  "title": "_Relationship",
      -  "type": "object"
      -}
  2. Changed2 schema fields changed
    • addedOutput schema / $defs / _EntityHit / properties / references
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "$ref": "#/$defs/_Reference"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "title": "References"
      +}
    • addedOutput schema / $defs / _Reference
      Added value: +{
      +  "properties": {
      +    "edge": {
      +      "title": "Edge",
      +      "type": "string"
      +    },
      +    "jurisdiction": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "title": "Jurisdiction",
      +      "type": "array"
      +    },
      +    "name": {
      +      "title": "Name",
      +      "type": "string"
      +    },
      +    "nature": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Nature"
      +    },
      +    "staleness": {
      +      "title": "Staleness",
      +      "type": "string"
      +    },
      +    "status": {
      +      "title": "Status",
      +      "type": "string"
      +    },
      +    "work_id": {
      +      "title": "Work Id",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "edge",
      +    "work_id",
      +    "name",
      +    "nature",
      +    "jurisdiction",
      +    "status",
      +    "staleness"
      +  ],
      +  "title": "_Reference",
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "_EntityHit": {
      +      "properties": {
      +        "content_type": {
      +          "title": "Content Type",
      +          "type": "string"
      +        },
      +        "entity_matches": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Entity Matches"
      +        },
      +        "full_text": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Full Text"
      +        },
      +        "id": {
      +          "title": "Id",
      +          "type": "string"
      +        },
      +        "ranks": {
      +          "$ref": "#/$defs/_SearchRanks"
      +        },
      +        "relationships": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "$ref": "#/$defs/_Relationship"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Relationships"
      +        },
      +        "scores": {
      +          "$ref": "#/$defs/_SearchScores"
      +        },
      +        "title": {
      +          "title": "Title",
      +          "type": "string"
      +        },
      +        "url": {
      +          "title": "Url",
      +          "type": "string"
      +        }
      +      },
      +      "title": "_EntityHit",
      +      "type": "object"
      +    },
      +    "_Relationship": {
      +      "properties": {
      +        "path_types": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "title": "Path Types",
      +          "type": "array"
      +        },
      +        "target_id": {
      +          "title": "Target Id",
      +          "type": "string"
      +        },
      +        "target_label": {
      +          "title": "Target Label",
      +          "type": "string"
      +        },
      +        "target_name": {
      +          "title": "Target Name",
      +          "type": "string"
      +        },
      +        "target_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Target Url"
      +        }
      +      },
      +      "required": [
      +        "path_types",
      +        "target_id",
      +        "target_label",
      +        "target_name",
      +        "target_url"
      +      ],
      +      "title": "_Relationship",
      +      "type": "object"
      +    },
      +    "_SearchMeta": {
      +      "properties": {
      +        "degraded": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "title": "Degraded",
      +          "type": "array"
      +        },
      +        "graph_total": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Graph Total"
      +        },
      +        "request_id": {
      +          "title": "Request Id",
      +          "type": "string"
      +        },
      +        "text_total": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Text Total"
      +        },
      +        "took_ms": {
      +          "title": "Took Ms",
      +          "type": "integer"
      +        },
      +        "total_available": {
      +          "title": "Total Available",
      +          "type": "integer"
      +        }
      +      },
      +      "title": "_SearchMeta",
      +      "type": "object"
      +    },
      +    "_SearchRanks": {
      +      "properties": {
      +        "bm25": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Bm25"
      +        },
      +        "combined": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Combined"
      +        },
      +        "graph": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Graph"
      +        }
      +      },
      +      "title": "_SearchRanks",
      +      "type": "object"
      +    },
      +    "_SearchScores": {
      +      "properties": {
      +        "bm25": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Bm25"
      +        },
      +        "graph": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "title": "Graph"
      +        }
      +      },
      +      "title": "_SearchScores",
      +      "type": "object"
      +    }
      +  },
      +  "properties": {
      +    "meta": {
      +      "$ref": "#/$defs/_SearchMeta"
      +    },
      +    "results": {
      +      "items": {
      +        "$ref": "#/$defs/_EntityHit"
      +      },
      +      "title": "Results",
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "meta",
      +    "results"
      +  ],
      +  "title": "EntityLookupResult",
      +  "type": "object"
      +}
  4. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.