Skip to main content

ESSOT MCP Server

Python Version MCP Transport Framework

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:

  1. 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.
  2. 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 local ssot/ 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).

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 to https://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):

  1. 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.

  2. Native IDE Setup (1 Step): Generate your ESSOT_API_KEY from 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.10 or 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)

Source distribution for essot-mcp-server 0.2.1
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)

Table of built distributions (wheels) for essot-mcp-server 0.2.1
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page