ORIONIS API REFERENCE

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

package documentation

Native, stateless MCP server support for Orionis.

Module config Define config for mcp.
Module context Hold only explicit input and native context for one independent call.
Package contracts Replaceable MCP runtime services.
Module dispatcher Provide mcp operations through DispatchResult, McpDispatcher.
Module exceptions Provide mcp operations.
Module invoker A reusable unbound handler plan; payloads never become keyword mappings.
Module manager Own one compiled registry shared by native HTTP, STDIO, DI and the facade.
Module normalization Describe MCP response cache lifetime and visibility options.
Package protocol Wire types and codecs for MCP 2026-07-28.
Module provider Register one manager and load declarations before either runtime starts.
Module reporting Adapt MCP failure observation without invoking protocol presentation.
Module responses Provide mcp operations through mime_format, Progress, McpResponse.
Module routing An importable native HTTP handler, including after route-cache restore.
Package server Declarative MCP servers and their immutable compiled definitions.
Module state Seal state across workers sharing an application key and GCM cipher.
Module streams Provide mcp operations through AsyncClosable, OwnedStream.
Package subscriptions Bounded request-scoped notification delivery.
Package transport Native transport bindings for the MCP dispatcher.

From __init__.py:

Class CacheHint Describe client cache freshness without caching server-side results.
Class Completion At most one hundred completion values.
Class ContentAnnotations Resource/content audience, relevance, and modification hints.
Class Icon An icon reference; the server never fetches its source.
Class InputRequiredResult An MRTR interim result, never a pushed JSON-RPC request.
Class McpExtension Declare negotiated capabilities and extension-owned method/schema hooks.
Class McpRequest Hold only explicit input and native context for one independent call.
Class McpResponse Compose protocol content without knowing the transport or DI container.
Class McpState Seal state across workers sharing an application key and GCM cipher.
Class Prompt Declare string arguments and return user/assistant prompt messages.
Class PromptArgument Declare one string-valued prompt argument.
Class Resource Read a declared URI or RFC 6570 template without implicit file access.
Class Server Define a server independently of any connection or transport.
Class Tool Declare a typed input, optional typed output, and an injectable handle method.
Class ToolAnnotations Describe tool behavior as hints, never as authorization rules.
Class ToolCatalog Hide catalog tools behind bounded search_tools and execute_tools tools.
Function __dir__ List loaded attributes and declared public exports.
Function __getattr__ Resolve and cache a public package export.
Constant _EXPORTS Public export names mapped to their defining modules and attributes.
Constant _METADATA_MODULE Module defining metadata values exported by this package.
Constant _PRIMITIVES_MODULE Module defining the public tool, resource, prompt, and server primitives.
Constant MCP_PROTOCOL_VERSION 2026-07-28.
def __dir__() -> list[str]: (source)

List loaded attributes and declared public exports.

Returns
list[str]Sorted attribute names available on this package.
def __getattr__(name: str) -> object: (source)

Resolve and cache a public package export.

Parameters
name:strPublic attribute requested from this package.
Returns
objectExported object from its defining module.
Raises
AttributeErrorIf the requested attribute is not exported.
_EXPORTS = (source)

Public export names mapped to their defining modules and attributes.

Value
{'MCP_PROTOCOL_VERSION': ('orionis.mcp.protocol.constants',
                          'MCP_PROTOCOL_VERSION'),
 'CacheHint': (_METADATA_MODULE, 'CacheHint'),
 'Completion': ('orionis.mcp.protocol.results', 'Completion'),
 'ContentAnnotations': (_METADATA_MODULE, 'ContentAnnotations'),
 'Icon': (_METADATA_MODULE, 'Icon'),
 'InputRequiredResult': ('orionis.mcp.protocol.results', 'InputRequiredResult'),
...
_METADATA_MODULE: str = (source)

Module defining metadata values exported by this package.

Value
'orionis.mcp.protocol.metadata'
_PRIMITIVES_MODULE: str = (source)

Module defining the public tool, resource, prompt, and server primitives.

Value
'orionis.mcp.server.primitives'
MCP_PROTOCOL_VERSION: str = (source)

2026-07-28.

Value
'2026-07-28'