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

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.0
File Size Uploaded Provenance Actions
essot_mcp_server-0.2.0.tar.gz 152.1 kB Without provenance Details for essot_mcp_server-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for essot-mcp-server 0.2.0
File Interpreter ABI Platform Actions
essot_mcp_server-0.2.0-py3-none-any.whl Python 3 none any Details for essot_mcp_server-0.2.0-py3-none-any.whl

Total release size: 171.4 kB

Release files / essot_mcp_server-0.2.0.tar.gz

Download URL essot_mcp_server-0.2.0.tar.gz
Size 152.1 kB
Tags Source
SHA-256 checksum
How to use checksums
fed2bb3fd297910946e385281fd9313e72a93286aec39bcbc3d06223a3028b79
BLAKE2b-256 checksum
How to use checksums
697042880b5de5408e9703380c344b948dc9718591cde653447a84a9f92b33fe
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.0-py3-none-any.whl

Download URL essot_mcp_server-0.2.0-py3-none-any.whl
Size 19.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8a121360e06963b10888803677cd0732173ad8e7580f5758a0dfe6a375025cf1
BLAKE2b-256 checksum
How to use checksums
44c560b251e4209b310cc56d58f462a581b0c0273547d005967033c3de6d2ed3
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.0

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