Platform Components

Orchestrators

The core multi-agent execution engine.
  • Runtime: FastAPI + asyncio
  • Agent isolation: git worktrees per agent
  • LLM routing: LangChain-based, supports 9 providers
  • Port: 8090
Supported providers: Anthropic, OpenAI, Azure OpenAI, Google, Groq, DeepSeek, Ollama, Azure AI Foundry, FlexAI

Manager

Integration OS — connects agents to external tools via OAuth2.
  • Runtime: FastAPI
  • Integrations: Gmail, Slack, GitHub, Notion, Calendar, Linear
  • Auth: OAuth2 per entity_id
  • Port: 8000

MCP Gateway

Model Context Protocol server.
  • Protocol: MCP (Anthropic standard)
  • Clients: Claude Desktop, Cursor, VS Code (Continue)
  • Port: 8093 in local compose for the bridge, with MCP JSON-RPC mounted by the bridge

Platform Foundation Services

SynapseX includes additional foundation services behind the API Gateway:
ComponentPortResponsibility
Tenant Service8019Organizations, plans, limits, members
Event Bus Service8020Durable publish/consume/ack events
Workspace Service8021Workspaces and agent artifacts
Webhook Service8022Subscriptions, signed deliveries, retries
Update Service8023Agent/runtime releases and rollout checks
Model Registry Service8024Model catalog and provider metadata
Observability Service8025Telemetry events and service summaries

Platform Dashboard

Web portal for teams.

CLI

Python CLI with two entry points:
  • synapsex — full name
  • sx — short alias

Docs

Mintlify-based documentation site (this site).
  • Static export → served by nginx on port 80