angee.knowledge.mcp_tools

Knowledge tools for the MCP server — curated GraphQL operations over the public bucket.

Each tool runs the same actor-scoped GraphQL operation a browser would, so the schema's permission_classes and RebacManager scoping do the authorization — no hand-rolled ORM access or projection. The :mod:angee.mcp.graphql engine derives each tool's input schema, response projection, and operation document from the schema; this module only declares which knowledge operations to expose and how to project them.

ids are the public sqid; agent field and argument names are snake_case (the compiler maps them to the schema's wire names). Reads are outline- and backlink-aware via the nested projection grammar; the body writes return the shared :class:PageBodyPayload (ok/error/error_code + the fresh body_hash for the next CAS edit).

register

def register(server: FastMCP) -> None

Register the knowledge tools (GraphQL-backed) on the MCP server.