get_entity_relations

Retrieves outgoing and incoming edges (fact connections) for a given entity. Supports optional semantic filtering, which is useful when an entity has many connections and you need to find specific facts.

Parameters

Parameter	Type	Required	Default	Description
`type`	string	Yes	—	Entity type
`name`	string	Yes	—	Entity name
`query`	string	No	`null`	Optional semantic search query to filter relations by intent or connected entity name
`limit`	integer	No	`100`	Max relations to return (1—1000)

Read-only

Yes. This tool only reads from your memory.

Example usage

{
  "type": "person",
  "name": "Alice",
  "query": "employment"
}

This returns only Alice’s work-related connections, filtering out unrelated facts.

{
  "type": "project",
  "name": "my-api",
  "limit": 20
}

Returns up to 20 connections for the “my-api” project.

Use the query parameter to narrow results for highly-connected entities. For example, filtering a person entity with query="employment" returns only work-related facts, while query="preferences" returns their stated preferences.

When to use

Exploring how an entity connects to others in the graph
Finding specific facts about an entity (use the query filter)
Building a comprehensive picture after reading an entity’s dossier with get_entity

Typical workflow

get_entity(type="person", name="Alice")          → read dossier
get_entity_relations(type="person", name="Alice") → explore connections
get_entity(type="organization", name="Acme Corp") → follow a connection