How concierge-hq/concierge works
Concierge is an SDK for MCP servers and AI applications. Its principal workflow is an agent discovering the tools exposed for the current session, invoking a tool, and progressing through allowed workflow stages; applications can also share session state. The SDK supports alternative tool backends, MCP transports, upstream server proxying, widgets, moderation, and operational telemetry. Edges reflect README-documented behavior or visible source references; implementation details for several documented capabilities were not sampled, so those links are shown only where supported.
Main entry points: __init__.py Concierge SDK · base_provider.py Tool providers · search_backend.py Semantic search · code_backend.py Code backend
Components 20
Workflow control
- Concierge SDK
__init__.py - Workflow stages
__init__.py - Stage transitions
__init__.py
Tool serving
- Tool providers
backends/base_provider.py - Semantic search
backends/search_backend.py - Code backend
backends/code_backend.py - Plan backend
backends/plan_backend.py - Vanilla backend
backends/vanilla_backend.py
MCP integration
- MCP adapters
adapters - Upstream proxy
proxy.py - MCP transports
__init__.py - Widget model
core/widget.py
Session runtime
- Session state API
__init__.py - State backends
state - Content moderation
security/moderation.py
Operations
- Telemetry
core/telemetry.py - Structured logging
core/logging.py - Scaffolding CLI
concierge_cli/__init__.py
Other components
- AI agent
- Developer
Connections 19
- AI agent → Concierge SDK: uses MCP
README.md - Concierge SDK → Workflow stages: exposes tools by stage
README.md - Concierge SDK → Stage transitions: enforces paths
README.md - AI agent → Concierge SDK: discovers and invokes
README.md - Concierge SDK → Session state API: offers state access
README.md - Session state API → State backends: reads and writes
__init__.py - Concierge SDK → Tool providers: initializes provider
__init__.py - Tool providers → Semantic search: supports search mode
README.md - Tool providers → Code backend: supports code mode
README.md - Tool providers → Plan backend: supports plan mode
README.md - Tool providers → Vanilla backend: supports plain mode
README.md - Concierge SDK → Content moderation: configures checks
__init__.py - Concierge SDK → MCP adapters: wraps MCP servers
README.md - Concierge SDK → Upstream proxy: supports upstream proxying
- Concierge SDK → MCP transports: serves over transports
README.md - Concierge SDK → Widget model: provides widgets
- Concierge SDK → Telemetry: records runtime metrics
- Concierge SDK → Structured logging: sets request context
- Developer → Scaffolding CLI: scaffolds project
README.md