Skip to main content
All documentation
Guides & Strategies 4 min readUpdated September 2026

MCP catalogs and agent hosts

Read complete tool contracts while keeping execution in your host.

Install an optional integration

MCP and Agents extras require Python 3.10 or newer. Base text compression remains available without these SDKs.

terminal

List, plan, and hydrate

Configure a trusted endpoint explicitly. HTTP is allowed only for localhost development; remote endpoints require HTTPS. Stdio sources accept an executable and literal argument list. Plans default to the full catalog.

catalog.py

Freshness and host ownership

The shortest page TTL governs the full snapshot. Private entries are isolated by the caller's cache principal; only explicitly public responses may be shared. Use source.refresh() or source.invalidate() when your host learns a catalog changed. Hydration rejects a plan from a different catalog fingerprint.

Frequently asked questions

Continue reading