Metadata-Version: 2.4
Name: hyperspell-mcp
Version: 0.1.0
Summary: Shared MCP tool catalog and backends for the Hyperspell company brain.
Requires-Python: >=3.10
Requires-Dist: httpx<1,>=0.27
Requires-Dist: mcp<2,>=1.28
Requires-Dist: pydantic<3,>=2
Description-Content-Type: text/markdown

# hyperspell-mcp

The single, canonical Model Context Protocol surface for the Hyperspell company brain.

This package owns the **tool catalog** (names, descriptions, annotations, parameter
defaults, compaction) and the **backend seam** that lets the same catalog run over two
transports:

- **Remote** — `register_tools(mcp, InProcessBackend())` mounted as Streamable HTTP at
  `/mcp` on core-api. `InProcessBackend` lives in core-api because it calls the real
  route handlers in-process.
- **Local** — `register_tools(mcp, HttpBackend(...))` run over stdio by the sync daemon,
  plus `register_context_tools(mcp, sync_dir)` for the disk-only `*_context` tools and
  `hyperbrain://` resources.

It deliberately does **not** copy core-api's request models. The tool parameters are
simple primitives; the only shared models are the lightweight response ("lite") models
that results are validated into so compaction is defined exactly once.

See `specs/components/unified-mcp-surface.md` for the full design and the
minimum-maintenance invariants.
