ESSOT MCP Server
The ESSOT MCP Server is the bridge between your local development environment and the Engineering SSOT Platform (ESSOT). It exposes local workspace orchestration capabilities to your AI-powered development workflow.
🚀 About the Engineering SSOT Platform (ESSOT)
The Engineering SSOT Platform (ESSOT) is a modern governance and planning workspace designed for AI-driven software engineering. ESSOT automatically maintains a Single Source of Truth (SSOT), empowering AI Coding Agents (such as Antigravity, Claude Desktop, Cursor, or Windsurf) to natively interact with your ESSOT project.
How it Connects to ESSOT
This MCP server operates in a dual-mode architecture:
- Stdio MCP Interface: Seamlessly exposes AI tools to your local IDE Agent, allowing it to pull architecture guidelines, parse SSOT requirements, and automatically synchronize your code drift.
- Enterprise Outbound Worker Tunnel: Automatically establishes an encrypted outbound WebSocket connection over standard TLS (Port 443) to the ESSOT Web App. This allows the cloud-based ESSOT platform to securely dispatch tasks to your local workspace.
🛠️ Available Tools
When connected to your IDE, the AI agent gains access to the following tools:
initialize_local_ssot: Connects to the ESSOT Web App to scaffold your localssot/directory using the project's Software Requirements Document (SRD).generate_implementation_plan: Acts as a Staff Architect. Analyzes local SSOT context and outputs an exhaustive, step-by-step implementation plan (with embedded security architecture).generate_task_plan: Decompiles the implementation plan into highly specific executable tasks for local agents (including integrated security guardrails).generate_test_plan: Creates comprehensive testing strategies (STQE, RTM) mapped to feature requirements.synchronize_ssot: Pushes local documentation and architectural updates back to the ESSOT Web App's Knowledge Graph to resolve drift.
📦 Installation & Quickstart
No manual repository downloads or cloning required. Once published to PyPI, your AI IDE can run essot-mcp-server on demand using uvx (or pipx).
1-Step Setup (Recommended)
Add essot-mcp-server directly to your IDE's MCP configuration:
{
"mcpServers": {
"essot-mcp-server": {
"command": "uvx",
"args": [
"essot-mcp-server"
],
"env": {
"ESSOT_API_KEY": "essot_your_api_key_here"
}
}
}
}
Note: If your ESSOT instance is self-hosted or uses a custom domain, optionally set
"ESSOT_API_URL": "https://your-domain.com". By default, it connects tohttps://essot.space.
Alternative Runners
Using pipx:
{
"mcpServers": {
"essot-mcp-server": {
"command": "pipx",
"args": [
"run",
"essot-mcp-server"
],
"env": {
"ESSOT_API_KEY": "essot_your_api_key_here"
}
}
}
}
Traditional pip installation:
pip install essot-mcp-server
{
"mcpServers": {
"essot-mcp-server": {
"command": "essot-mcp-server",
"env": {
"ESSOT_API_KEY": "essot_your_api_key_here"
}
}
}
}
Supported IDEs & Configuration Locations
- Claude Desktop:
%APPDATA%\Claude\claude_desktop_config.json(Windows) or~/Library/Application Support/Claude/claude_desktop_config.json(macOS). - Antigravity CLI / IDE:
~/.gemini/config/mcp_config.json. - Cursor: Settings > Features > MCP.
- VSCode:
.vscode/mcp_config.json.
🌐 Permanent Secure Outbound Worker Tunnel (Native IDE Bridge)
When connecting to the cloud-hosted ESSOT Web App (https://essot.space):
-
Enterprise Security & Zero Open Ports: The MCP server uses an outbound-only WebSocket architecture over standard encrypted TLS (Port 443). Corporate firewalls and NAT permit outbound HTTPS/WSS traffic freely. Once authenticated, the persistent tunnel lets the cloud dispatch tasks to your local workspace.
-
Native IDE Setup (1 Step): Generate your
ESSOT_API_KEYfrom User Settings ⚙️ in the ESSOT Web App, and configure it directly in your IDE's MCP config:{ "mcpServers": { "essot-mcp-server": { "command": "uvx", "args": [ "essot-mcp-server" ], "env": { "ESSOT_API_KEY": "essot_your_api_key_here" } } } }
When your IDE opens, the server starts automatically and logs:
🟢 Outbound WebSocket tunnel established with ESSOT Cloud. Permanent tunnel active.
Now, clicking Scaffold Local SSOT or Generate Plan in the Web App, or running Forge verification tests, immediately dispatches tasks to your local workspace without any terminal commands.
🔧 Architecture Requirements
- Python:
3.10or higher - Package Manager: uv by Astral
- Inbound Ports: Zero incoming ports required. Remote cloud dispatch operates 100% via outbound encrypted WebSocket (TLS Port 443).
🤝 Contributing
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
Metadata
Release files for essot-mcp-server 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| essot_mcp_server-0.2.1.tar.gz | 152.2 kB | Without provenance | Details for essot_mcp_server-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| essot_mcp_server-0.2.1-py3-none-any.whl | Python 3 | none | any | Details for essot_mcp_server-0.2.1-py3-none-any.whl |
Total release size: 171.7 kB
Release files / essot_mcp_server-0.2.1.tar.gz
| Download URL | essot_mcp_server-0.2.1.tar.gz |
|---|---|
| Size | 152.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7e0aef2ee8e4588fddc05d9a03d61e92498c066cd34c353d7b4a519bed39b484
|
|
BLAKE2b-256 checksum How to use checksums |
012fd6987c3a626efc7f4941be7eca8b8398377401be11a81beb6057f8ace8b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Release files / essot_mcp_server-0.2.1-py3-none-any.whl
| Download URL | essot_mcp_server-0.2.1-py3-none-any.whl |
|---|---|
| Size | 19.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5765e429246adadeb03b7b7805e10c1e414de47e174e9c47638edb5b01a992f4
|
|
BLAKE2b-256 checksum How to use checksums |
8e27a860037a1e8b993f8383b4f12486c1f1883e09a5521c6b92f352fd87b6ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for essot-mcp-server 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.