Entity Create¶
Create a new entity with optional description, tags, and aliases. Consent-gated for agent-author writes. Optionally anchors an initial reference if source_path + source_kind are supplied.
MCP name: entity_create
Category: entities
:warning: Requires consent
Mutates state (retry policy: manual)
Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
aliases |
list |
No | Alternative names that resolve to this entity. Each alias is globally unique. |
author |
str |
No | 'user' (default) or 'agent'. Agent-author writes are consent-gated. |
canonical_name |
str |
Yes | Display name, e.g. 'Ada Lovelace'. Normalized to lowercase+collapsed-whitespace for uniqueness. |
description |
str |
No | Free-form prose. Where relationship context lives ("Ada Lovelace — the user's former manager."). |
source_kind |
str |
No | One of document, chat, task, agent, manual. |
source_path |
str |
No | Document/session/agent path. With source_kind, anchors an initial reference row. |
tags |
list |
No | Hierarchical tags like 'person', 'person/family', 'place/work'. Multi-valued. |