Skip to main content

​
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

ParameterTypeRequiredDefaultDescription
typestringYes—Entity type
namestringYes—Entity name
querystringNonullOptional semantic search query to filter relations by intent or connected entity name
limitintegerNo100Max 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

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