# infisical/infisical-mcp-server architecture

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

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

## Overview

Infisical MCP Server exposes Infisical operations as MCP tools over stdio: an MCP client connects, discovers enabled tools, and invokes them; the server validates configuration and tool arguments, authenticates, then uses the Infisical SDK or API to perform operations. The README documents secret-value masking and tool allowlisting. The repository is a small single-file runtime, so domain responsibilities share `src/index.ts`; unsampled handler details are represented only where README capabilities support them.

Main entry points: [`src/index.ts`](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts) (Tool Dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["MCP Interface"]
  node_stdio["Stdio Transport<br/>[index.ts]"]
  node_server["MCP Server<br/>[index.ts]"]
  node_tool_catalog["Tool Catalog<br/>[index.ts]"]
  node_tool_dispatch["Tool Dispatch<br/>[index.ts]"]
end

subgraph group_configuration["Configuration and Access"]
  node_environment["Environment Config<br/>[index.ts]"]
  node_authentication["Authentication<br/>[index.ts]"]
  node_masking["Secret Masking<br/>[index.ts]"]
end

subgraph group_secrets["Secret Operations"]
  node_secret_crud["Secret CRUD<br/>[index.ts]"]
  node_secret_listing["Secret Listing<br/>[index.ts]"]
end

subgraph group_management["Project Management"]
  node_project_ops["Project Operations<br/>[index.ts]"]
  node_environment_ops["Environment Operations<br/>[index.ts]"]
  node_folder_ops["Folder Operations<br/>[index.ts]"]
  node_membership_ops["Membership Operations<br/>[index.ts]"]
end

node_client(("MCP Client"))
node_infisical["Infisical API"]

node_client -->|"connects over"| node_stdio
node_stdio -->|"connects transport"| node_server
node_client -->|"discovers tools"| node_server
node_server -->|"lists tools"| node_tool_catalog
node_server -->|"handles calls"| node_tool_dispatch
node_environment -->|"configures credentials"| node_authentication
node_tool_dispatch -.->|"authenticates"| node_authentication
node_tool_dispatch -.->|"dispatches calls"| node_secret_crud
node_tool_dispatch -->|"dispatches calls"| node_secret_listing
node_tool_dispatch -->|"dispatches calls"| node_project_ops
node_tool_dispatch -->|"dispatches calls"| node_environment_ops
node_tool_dispatch -.->|"dispatches calls"| node_folder_ops
node_tool_dispatch -->|"dispatches calls"| node_membership_ops
node_secret_crud -.->|"manages secrets"| node_infisical
node_secret_listing -->|"lists secrets"| node_infisical
node_project_ops -->|"manages projects"| node_infisical
node_environment_ops -->|"creates environments"| node_infisical
node_folder_ops -.->|"creates folders"| node_infisical
node_membership_ops -->|"invites members"| node_infisical
node_secret_crud -.->|"masks responses"| node_masking

click node_stdio "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_server "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_tool_catalog "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_tool_dispatch "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_environment "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_authentication "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_masking "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_secret_crud "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_secret_listing "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_project_ops "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_environment_ops "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_folder_ops "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"
click node_membership_ops "https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts"

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_stdio,node_server,node_tool_catalog,node_tool_dispatch,node_client toneBlue
class node_environment,node_authentication,node_masking toneAmber
class node_secret_crud,node_secret_listing,node_infisical toneMint
class node_project_ops,node_environment_ops,node_folder_ops,node_membership_ops toneRose
```

## Components

### MCP Interface

- [Stdio Transport](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [MCP Server](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Tool Catalog](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Tool Dispatch](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`

### Configuration and Access

- [Environment Config](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Authentication](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Secret Masking](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`

### Secret Operations

- [Secret CRUD](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Secret Listing](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`

### Project Management

- [Project Operations](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Environment Operations](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Folder Operations](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`
- [Membership Operations](https://github.com/infisical/infisical-mcp-server/blob/main/src/index.ts): `src/index.ts`

### Other components

- **MCP Client**
- **Infisical API**

## Connections

- MCP Client → Stdio Transport: connects over (evidence: `README.md`)
- Stdio Transport → MCP Server: connects transport (evidence: `src/index.ts`)
- MCP Client → MCP Server: discovers tools (evidence: `README.md`)
- MCP Server → Tool Catalog: lists tools (evidence: `src/index.ts`)
- MCP Server → Tool Dispatch: handles calls (evidence: `src/index.ts`)
- Environment Config → Authentication: configures credentials (evidence: `README.md`)
- Tool Dispatch → Authentication: authenticates (evidence: `src/index.ts`)
- Tool Dispatch → Secret CRUD: dispatches calls (evidence: `src/index.ts`)
- Tool Dispatch → Secret Listing: dispatches calls (evidence: `src/index.ts`)
- Tool Dispatch → Project Operations: dispatches calls (evidence: `src/index.ts`)
- Tool Dispatch → Environment Operations: dispatches calls (evidence: `src/index.ts`)
- Tool Dispatch → Folder Operations: dispatches calls (evidence: `src/index.ts`)
- Tool Dispatch → Membership Operations: dispatches calls (evidence: `src/index.ts`)
- Secret CRUD → Infisical API: manages secrets
- Secret Listing → Infisical API: lists secrets (evidence: `src/index.ts`)
- Project Operations → Infisical API: manages projects (evidence: `src/index.ts`)
- Environment Operations → Infisical API: creates environments (evidence: `src/index.ts`)
- Folder Operations → Infisical API: creates folders
- Membership Operations → Infisical API: invites members (evidence: `src/index.ts`)
- Secret CRUD → Secret Masking: masks responses (evidence: `src/index.ts`)
