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

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.2
File Size Uploaded Provenance Actions
essot_mcp_server-0.2.2.tar.gz 152.2 kB Without provenance Details for essot_mcp_server-0.2.2.tar.gz

Built distribution (wheel)

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

Total release size: 171.6 kB

Release files / essot_mcp_server-0.2.2.tar.gz

Download URL essot_mcp_server-0.2.2.tar.gz
Size 152.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f2e3eb533f45836ea410523fa4d6ec571e95d1ea1447974e887aa5888f8e6454
BLAKE2b-256 checksum
How to use checksums
879bf2626c251d1f4dc2acb21f6d6ee3a247ba83dc0d35c93fd16429d51212d4
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.2-py3-none-any.whl

Download URL essot_mcp_server-0.2.2-py3-none-any.whl
Size 19.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dc14bccc1fd549e5680f68a1a6f136cd08dccc0ed2f61fa850b105cff60fe9f0
BLAKE2b-256 checksum
How to use checksums
1aeeb97f076cb3022a83ca961d887905b07e4d16f4e373140cbf7f98b6f9587a
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.2

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