# antideploy/antideploy-mcp architecture

> Architecture diagram of the GitHub repository antideploy/antideploy-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antideploy/antideploy-mcp
- Repository: https://github.com/antideploy/antideploy-mcp

## Overview

antideploy-mcp is a local MCP server that lets coding agents deploy a project directory and manage its Antideploy application. The principal workflow packages a local directory, uploads it to start an asynchronous deployment, then lets the agent poll status. Separate tools manage write-only environment secrets and retrieve API information. The runtime is concentrated in index.js; README documents platform-side analysis, provisioning, build, release, and operations, but those are external to this repository. The graph reflects the single sampled runtime file; README supplies evidence for platform capabilities and deployment behavior.

Main entry points: [`index.js`](https://github.com/antideploy/antideploy-mcp/blob/main/index.js) (MCP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent_interface["Agent interface"]
  node_mcp_server["MCP server<br/>[index.js]"]
  node_deploy_tool["Deploy tool<br/>[index.js]"]
  node_status_tool["Status tool<br/>[index.js]"]
  node_env_tools["Environment tools<br/>[index.js]"]
  node_api_info_tool["API info tool<br/>[index.js]"]
end

subgraph group_local_packaging["Local packaging"]
  node_directory_walk["Directory scan<br/>[index.js]"]
  node_archive_limits["Archive and limits<br/>[index.js]"]
end

subgraph group_platform_api["Platform API"]
  node_deploy_endpoint["Deploy endpoint"]
  node_status_endpoint["Status endpoint"]
  node_secrets_endpoint["Secrets endpoint"]
  node_api_description["API description"]
  node_platform_analysis["Source analysis"]
  node_provisioning["Provisioning"]
  node_build_release["Build and release"]
  node_operations["Runtime operations"]
end

node_coding_agent(("Coding agent"))
node_antideploy_platform["Antideploy platform"]

node_coding_agent -->|"calls tools"| node_mcp_server
node_mcp_server -->|"registers"| node_deploy_tool
node_mcp_server -->|"registers"| node_status_tool
node_mcp_server -->|"registers"| node_env_tools
node_mcp_server -->|"registers"| node_api_info_tool
node_deploy_tool -->|"scans directory"| node_directory_walk
node_directory_walk -->|"provides files"| node_archive_limits
node_deploy_tool -->|"packs and checks"| node_archive_limits
node_deploy_tool -->|"uploads archive"| node_deploy_endpoint
node_deploy_endpoint -->|"starts deployment"| node_antideploy_platform
node_status_tool -->|"requests status"| node_status_endpoint
node_status_endpoint -->|"reports progress"| node_antideploy_platform
node_env_tools -->|"reads names or writes"| node_secrets_endpoint
node_secrets_endpoint -->|"manages secrets"| node_antideploy_platform
node_api_info_tool -->|"fetches"| node_api_description
node_api_description -->|"describes API"| node_antideploy_platform
node_antideploy_platform -->|"analyzes source"| node_platform_analysis
node_antideploy_platform -->|"provisions resources"| node_provisioning
node_antideploy_platform -->|"builds and releases"| node_build_release
node_antideploy_platform -->|"monitors and rolls back"| node_operations

click node_mcp_server "https://github.com/antideploy/antideploy-mcp/blob/main/index.js"
click node_deploy_tool "https://github.com/antideploy/antideploy-mcp/blob/main/index.js"
click node_status_tool "https://github.com/antideploy/antideploy-mcp/blob/main/index.js"
click node_env_tools "https://github.com/antideploy/antideploy-mcp/blob/main/index.js"
click node_api_info_tool "https://github.com/antideploy/antideploy-mcp/blob/main/index.js"
click node_directory_walk "https://github.com/antideploy/antideploy-mcp/blob/main/index.js"
click node_archive_limits "https://github.com/antideploy/antideploy-mcp/blob/main/index.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mcp_server,node_deploy_tool,node_status_tool,node_env_tools,node_api_info_tool toneBlue
class node_directory_walk,node_archive_limits toneAmber
class node_deploy_endpoint,node_status_endpoint,node_secrets_endpoint,node_api_description,node_platform_analysis,node_provisioning,node_build_release,node_operations toneMint
class node_coding_agent,node_antideploy_platform toneIndigo
```

## Components

### Agent interface

- [MCP server](https://github.com/antideploy/antideploy-mcp/blob/main/index.js): `index.js`
- [Deploy tool](https://github.com/antideploy/antideploy-mcp/blob/main/index.js): `index.js`
- [Status tool](https://github.com/antideploy/antideploy-mcp/blob/main/index.js): `index.js`
- [Environment tools](https://github.com/antideploy/antideploy-mcp/blob/main/index.js): `index.js`
- [API info tool](https://github.com/antideploy/antideploy-mcp/blob/main/index.js): `index.js`

### Local packaging

- [Directory scan](https://github.com/antideploy/antideploy-mcp/blob/main/index.js): `index.js`
- [Archive and limits](https://github.com/antideploy/antideploy-mcp/blob/main/index.js): `index.js`

### Platform API

- **Deploy endpoint**
- **Status endpoint**
- **Secrets endpoint**
- **API description**
- **Source analysis**
- **Provisioning**
- **Build and release**
- **Runtime operations**

### Other components

- **Coding agent**
- **Antideploy platform**

## Connections

- Coding agent → MCP server: calls tools (evidence: `README.md`)
- MCP server → Deploy tool: registers (evidence: `index.js`)
- MCP server → Status tool: registers (evidence: `index.js`)
- MCP server → Environment tools: registers (evidence: `index.js`)
- MCP server → API info tool: registers (evidence: `index.js`)
- Deploy tool → Directory scan: scans directory (evidence: `index.js`)
- Directory scan → Archive and limits: provides files (evidence: `index.js`)
- Deploy tool → Archive and limits: packs and checks (evidence: `index.js`)
- Deploy tool → Deploy endpoint: uploads archive (evidence: `index.js`)
- Deploy endpoint → Antideploy platform: starts deployment (evidence: `README.md`)
- Status tool → Status endpoint: requests status (evidence: `index.js`)
- Status endpoint → Antideploy platform: reports progress (evidence: `README.md`)
- Environment tools → Secrets endpoint: reads names or writes (evidence: `index.js`)
- Secrets endpoint → Antideploy platform: manages secrets (evidence: `README.md`)
- API info tool → API description: fetches (evidence: `index.js`)
- API description → Antideploy platform: describes API
- Antideploy platform → Source analysis: analyzes source (evidence: `README.md`)
- Antideploy platform → Provisioning: provisions resources (evidence: `README.md`)
- Antideploy platform → Build and release: builds and releases (evidence: `README.md`)
- Antideploy platform → Runtime operations: monitors and rolls back (evidence: `README.md`)
