# converzap/converzap-mcp architecture

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

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

## Overview

ConverZAP MCP is a hosted remote server that exposes ConverZAP workspace operations to AI clients. The principal workflow is: a client connects and authenticates, invokes an MCP tool, and the hosted server performs the action through the public API, subject to the member’s permissions and rate limits. The graph separates read, operational, and setup capabilities. This repository contains documentation and connection settings, not the server implementation, so component relationships reflect README statements rather than inspected runtime code.

Main entry points: [`README.md`](https://github.com/converzap/converzap-mcp/blob/main/README.md) (Hosted MCP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["Connection"]
  node_server["Hosted MCP server<br/>[README.md]"]
  node_auth["OAuth or API key<br/>[README.md]"]
end

subgraph group_workspace["Workspace tools"]
  node_read_tools["Read tools<br/>[README.md]"]
  node_contact_tools["Contact tools<br/>[README.md]"]
  node_conversation_tools["Conversation tools<br/>[README.md]"]
  node_crm_tools["CRM pipeline<br/>[README.md]"]
end

subgraph group_engagement["Customer engagement"]
  node_campaign_tools["Campaign tools<br/>[README.md]"]
  node_automation_tools["Automation tools<br/>[README.md]"]
end

subgraph group_setup["Account setup"]
  node_agent_tools["AI agent setup<br/>[README.md]"]
  node_briefing_tools["Business briefing<br/>[README.md]"]
  node_pipeline_setup["Pipeline setup<br/>[README.md]"]
  node_template_tools["Template tools<br/>[README.md]"]
  node_setup_links["Connection and plans<br/>[README.md]"]
end

node_client(("AI assistant"))
node_api{{"ConverZAP public API"}}

node_client -->|"connects to"| node_server
node_client -->|"authenticates with"| node_auth
node_server -->|"exposes"| node_read_tools
node_server -->|"exposes"| node_contact_tools
node_server -->|"exposes"| node_conversation_tools
node_server -->|"exposes"| node_crm_tools
node_server -->|"exposes"| node_campaign_tools
node_server -->|"exposes"| node_automation_tools
node_server -->|"exposes"| node_agent_tools
node_server -->|"exposes"| node_briefing_tools
node_server -->|"exposes"| node_pipeline_setup
node_server -->|"exposes"| node_template_tools
node_server -->|"exposes"| node_setup_links
node_read_tools -->|"calls"| node_api
node_contact_tools -->|"calls"| node_api
node_conversation_tools -->|"calls"| node_api
node_crm_tools -->|"calls"| node_api
node_campaign_tools -->|"calls"| node_api
node_automation_tools -->|"calls"| node_api
node_agent_tools -->|"calls"| node_api
node_briefing_tools -->|"calls"| node_api
node_pipeline_setup -->|"calls"| node_api
node_template_tools -->|"calls"| node_api
node_setup_links -->|"calls"| node_api

click node_server "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_auth "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_read_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_contact_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_conversation_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_crm_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_campaign_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_automation_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_agent_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_briefing_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_pipeline_setup "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_template_tools "https://github.com/converzap/converzap-mcp/blob/main/README.md"
click node_setup_links "https://github.com/converzap/converzap-mcp/blob/main/README.md"

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_server,node_auth toneBlue
class node_read_tools,node_contact_tools,node_conversation_tools,node_crm_tools toneAmber
class node_campaign_tools,node_automation_tools,node_api toneMint
class node_agent_tools,node_briefing_tools,node_pipeline_setup,node_template_tools,node_setup_links toneRose
class node_client toneIndigo
```

## Components

### Connection

- [Hosted MCP server](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [OAuth or API key](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`

### Workspace tools

- [Read tools](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [Contact tools](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [Conversation tools](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [CRM pipeline](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`

### Customer engagement

- [Campaign tools](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [Automation tools](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`

### Account setup

- [AI agent setup](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [Business briefing](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [Pipeline setup](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [Template tools](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`
- [Connection and plans](https://github.com/converzap/converzap-mcp/blob/main/README.md): `README.md`

### Other components

- **AI assistant**
- **ConverZAP public API**

## Connections

- AI assistant → Hosted MCP server: connects to (evidence: `README.md`)
- AI assistant → OAuth or API key: authenticates with (evidence: `README.md`)
- Hosted MCP server → Read tools: exposes (evidence: `README.md`)
- Hosted MCP server → Contact tools: exposes (evidence: `README.md`)
- Hosted MCP server → Conversation tools: exposes (evidence: `README.md`)
- Hosted MCP server → CRM pipeline: exposes (evidence: `README.md`)
- Hosted MCP server → Campaign tools: exposes (evidence: `README.md`)
- Hosted MCP server → Automation tools: exposes (evidence: `README.md`)
- Hosted MCP server → AI agent setup: exposes (evidence: `README.md`)
- Hosted MCP server → Business briefing: exposes (evidence: `README.md`)
- Hosted MCP server → Pipeline setup: exposes (evidence: `README.md`)
- Hosted MCP server → Template tools: exposes (evidence: `README.md`)
- Hosted MCP server → Connection and plans: exposes (evidence: `README.md`)
- Read tools → ConverZAP public API: calls (evidence: `README.md`)
- Contact tools → ConverZAP public API: calls (evidence: `README.md`)
- Conversation tools → ConverZAP public API: calls (evidence: `README.md`)
- CRM pipeline → ConverZAP public API: calls (evidence: `README.md`)
- Campaign tools → ConverZAP public API: calls (evidence: `README.md`)
- Automation tools → ConverZAP public API: calls (evidence: `README.md`)
- AI agent setup → ConverZAP public API: calls (evidence: `README.md`)
- Business briefing → ConverZAP public API: calls (evidence: `README.md`)
- Pipeline setup → ConverZAP public API: calls (evidence: `README.md`)
- Template tools → ConverZAP public API: calls (evidence: `README.md`)
- Connection and plans → ConverZAP public API: calls (evidence: `README.md`)
