# ibm-apiconnect/apic-mcp-server architecture

> Architecture diagram of the GitHub repository ibm-apiconnect/apic-mcp-server, 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/ibm-apiconnect/apic-mcp-server
- Repository: https://github.com/ibm-apiconnect/apic-mcp-server

## Overview

This repository distributes prebuilt MCP servers that expose IBM API Connect capabilities to MCP clients, plus a standalone OpenAPI operation-selection utility and setup skills. The documented workflow is client configuration, server connection to an API Connect instance, and tool use for management, analytics, governance, or GenAI tasks. The README describes v10 as an all-tools package and v12 as service-based packages. Archive internals are not shown, so package-to-instance links reflect documented configuration and capability, not inspected call paths.

Main entry points: [`apic-v10/apic-v10-mcp-server-0.0.1.tgz`](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/apic-v10/apic-v10-mcp-server-0.0.1.tgz) (v10 Server), [`ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.js`](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.js) (Operation Selector), [`analytics/apic-analytics-mcp-server-0.0.1.tgz`](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/analytics/apic-analytics-mcp-server-0.0.1.tgz) (Analytics Server), [`management/apic-management-mcp-server-0.0.1.tgz`](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/management/apic-management-mcp-server-0.0.1.tgz) (Management Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_distributions["MCP Distributions"]
  node_v10["v10 Server"]
  node_analytics["Analytics Server"]
  node_management["Management Server"]
  node_governance["Governance Server"]
  node_genai["GenAI Spec Server"]
  node_gateway["Gateway On-Prem Server"]
  node_ai_gateway["AI Gateway Management"]
end

subgraph group_capabilities["APIC Capabilities"]
  node_analytics_tasks["Analytics Tools"]
  node_management_tasks["Management Tools"]
  node_governance_tasks["Governance Tools"]
  node_genai_tasks["GenAI Tools"]
end

subgraph group_skills["OpenAPI Skill"]
  node_selector["Operation Selector"]
end

node_client(("MCP Client"))
node_apic[("API Connect")]
node_selector_user(("Skill User"))
node_openapi["OpenAPI File"]
node_selection["Selection JSON"]

node_client -->|"uses"| node_v10
node_client -->|"uses"| node_analytics
node_client -->|"uses"| node_management
node_client -->|"uses"| node_governance
node_client -->|"uses"| node_genai
node_client -->|"uses"| node_gateway
node_v10 -->|"connects to"| node_apic
node_analytics -->|"queries"| node_apic
node_management -->|"manages"| node_apic
node_governance -->|"validates"| node_apic
node_genai -->|"generates for"| node_apic
node_v10 -->|"exposes"| node_analytics_tasks
node_v10 -->|"exposes"| node_management_tasks
node_v10 -->|"exposes"| node_governance_tasks
node_v10 -->|"exposes"| node_genai_tasks
node_selector_user -->|"runs"| node_selector
node_selector -->|"reads"| node_openapi
node_selector -->|"writes"| node_selection

click node_v10 "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/apic-v10/apic-v10-mcp-server-0.0.1.tgz"
click node_analytics "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/analytics/apic-analytics-mcp-server-0.0.1.tgz"
click node_management "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/management/apic-management-mcp-server-0.0.1.tgz"
click node_governance "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/governance/apic-governance-mcp-server-0.0.1.tgz"
click node_genai "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/genai-spec/apic-genai-spec-mcp-server-0.0.1.tgz"
click node_gateway "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/interact-gateway-onprem/interact-gateway-onprem-mcp-server-0.0.1.tgz"
click node_ai_gateway "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/ai-gateway-management/ai-gateway-management-mcp-server-0.0.1.mcpb"
click node_analytics_tasks "https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/analytics"
click node_management_tasks "https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/management"
click node_governance_tasks "https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/governance"
click node_genai_tasks "https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/genai-spec"
click node_selector "https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.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_v10,node_analytics,node_management,node_governance,node_genai,node_gateway,node_ai_gateway,node_client,node_selector_user toneBlue
class node_analytics_tasks,node_management_tasks,node_governance_tasks,node_genai_tasks,node_apic toneAmber
class node_selector,node_openapi toneMint
class node_selection toneIndigo
```

## Components

### MCP Distributions

- [v10 Server](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/apic-v10/apic-v10-mcp-server-0.0.1.tgz): `apic-v10/apic-v10-mcp-server-0.0.1.tgz`
- [Analytics Server](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/analytics/apic-analytics-mcp-server-0.0.1.tgz): `analytics/apic-analytics-mcp-server-0.0.1.tgz`
- [Management Server](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/management/apic-management-mcp-server-0.0.1.tgz): `management/apic-management-mcp-server-0.0.1.tgz`
- [Governance Server](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/governance/apic-governance-mcp-server-0.0.1.tgz): `governance/apic-governance-mcp-server-0.0.1.tgz`
- [GenAI Spec Server](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/genai-spec/apic-genai-spec-mcp-server-0.0.1.tgz): `genai-spec/apic-genai-spec-mcp-server-0.0.1.tgz`
- [Gateway On-Prem Server](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/interact-gateway-onprem/interact-gateway-onprem-mcp-server-0.0.1.tgz): `interact-gateway-onprem/interact-gateway-onprem-mcp-server-0.0.1.tgz`
- [AI Gateway Management](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/ai-gateway-management/ai-gateway-management-mcp-server-0.0.1.mcpb): `ai-gateway-management/ai-gateway-management-mcp-server-0.0.1.mcpb`

### APIC Capabilities

- [Analytics Tools](https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/analytics): `analytics`
- [Management Tools](https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/management): `management`
- [Governance Tools](https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/governance): `governance`
- [GenAI Tools](https://github.com/ibm-apiconnect/apic-mcp-server/tree/main/genai-spec): `genai-spec`

### OpenAPI Skill

- [Operation Selector](https://github.com/ibm-apiconnect/apic-mcp-server/blob/main/ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.js): `ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.js`

### Other components

- **MCP Client**
- **API Connect**
- **Skill User**
- **OpenAPI File**
- **Selection JSON**

## Connections

- MCP Client → v10 Server: uses (evidence: `README.md`)
- MCP Client → Analytics Server: uses (evidence: `README.md`)
- MCP Client → Management Server: uses (evidence: `README.md`)
- MCP Client → Governance Server: uses (evidence: `README.md`)
- MCP Client → GenAI Spec Server: uses (evidence: `README.md`)
- MCP Client → Gateway On-Prem Server: uses
- v10 Server → API Connect: connects to (evidence: `README.md`)
- Analytics Server → API Connect: queries (evidence: `README.md`)
- Management Server → API Connect: manages (evidence: `README.md`)
- Governance Server → API Connect: validates (evidence: `README.md`)
- GenAI Spec Server → API Connect: generates for (evidence: `README.md`)
- v10 Server → Analytics Tools: exposes (evidence: `README.md`)
- v10 Server → Management Tools: exposes (evidence: `README.md`)
- v10 Server → Governance Tools: exposes (evidence: `README.md`)
- v10 Server → GenAI Tools: exposes (evidence: `README.md`)
- Skill User → Operation Selector: runs (evidence: `ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.js`)
- Operation Selector → OpenAPI File: reads (evidence: `ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.js`)
- Operation Selector → Selection JSON: writes (evidence: `ai-gateway-management/skills/apic-openapi-operation-selector/select-operations.js`)
