angee.mcp.server

The process-wide MCP server: one FastMCP instance, tools from addon manifests.

Each installed addon contributes tools through the mcp_tools seam — an mcp_tools.py module exposing a register(server: FastMCP) -> None callable, inferred by convention (an addon.toml [mcp].tools entry overrides the dotted reference). It resolves the same way the GraphQL schemas seam does, through the shared :func:angee.addons.resolve_addon_reference. The server authenticates the inbound bearer with :class:~angee.mcp.verifier.RebacTokenVerifier and brackets every tool call in the authenticated REBAC actor with :class:~angee.mcp.middleware.ActorMiddleware. It is mounted as a StreamableHTTP ASGI app by :mod:angee.mcp.asgi; :mod:angee.asgi owns its lifespan, so the server holds no per-request lifecycle of its own.

stateless_http keeps each call independent and json_response returns a buffered JSON body the agent's HTTP client folds without an SSE reader (both passed to :meth:~fastmcp.FastMCP.http_app). DNS-rebinding protection is off by default (FastMCP passes no transport-security settings); Django's ALLOWED_HOSTS already terminates the request and the bearer + REBAC actor resolution is the real authorization boundary.

ToolRegistrar

An addon's register(server) callable — it adds tools to the MCP server.

Non-GraphQL tools must explicitly declare ToolAnnotations.readOnlyHint. Compiled GraphQL tools carry their root op_type as the structural actor-posture fact (their annotation must agree). Builtins also run through the in-process pydantic runtime, so their callable may not depend on FastMCP's request-scoped Context or get_access_token; the native toolset asserts these contracts when it advertises a granted tool.

MOUNT_PATH

The external StreamableHTTP path the server mounts at (see :mod:angee.mcp.asgi).

mcp_server

@cache
def mcp_server() -> FastMCP

Return the process-wide FastMCP server, built and tool-registered once.

mcp_app

@cache
def mcp_app() -> Starlette

Return the server's StreamableHTTP ASGI app (built once, lifespan owned by the entrypoint).

has_tools

def has_tools() -> bool

Return whether any installed addon contributes MCP tools.