# clipham/infor-cloudsuite-mcp architecture

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

- Interactive diagram: https://gitdiagram.com/clipham/infor-cloudsuite-mcp
- Repository: https://github.com/clipham/infor-cloudsuite-mcp

## Overview

Infor CloudSuite MCP Server exposes Landmark business-class data to MCP-compatible AI clients through the ION API Gateway. The main workflow is an AI client request routed by the MCP server to read-only query or GL variance tools, through authenticated HTTP access, then returned as structured results. The server also exposes reference resources and guided finance prompts. Source excerpts show the registration and key calls; some implementation details are unsampled, so the graph avoids inferring their internal wiring.

Main entry points: [`src/infor_mcp/server.py`](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/server.py) (MCP Server), [`src/infor_mcp/client.py`](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/client.py) (ION HTTP Client), [`src/infor_mcp/prompts/workflows.py`](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/prompts/workflows.py) (Workflow Prompts), [`src/infor_mcp/tools/query.py`](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/query.py) (Record Queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp["MCP Interface"]
  node_server["MCP Server<br/>[server.py]"]
  node_prompts["Workflow Prompts<br/>[workflows.py]"]
  node_reference["Reference Resources<br/>[reference.py]"]
end

subgraph group_features["ERP Capabilities"]
  node_query["Record Queries<br/>[query.py]"]
  node_discovery["Class Discovery<br/>[query.py]"]
  node_formops["Form Operations<br/>[query.py]"]
  node_variance["GL Variance<br/>[analysis.py]"]
end

subgraph group_access["ION Access"]
  node_auth["OAuth Manager<br/>[auth.py]"]
  node_http["ION HTTP Client<br/>[client.py]"]
end

subgraph group_external["External Systems"]
  node_ai(("AI Client"))
  node_gateway["ION API Gateway"]
  node_cloudsuite[("Landmark Data")]
end

node_ai -->|"sends MCP requests"| node_server
node_server -->|"registers tools"| node_query
node_server -->|"registers tools"| node_discovery
node_server -->|"registers tools"| node_formops
node_server -->|"registers tools"| node_variance
node_server -->|"registers prompts"| node_prompts
node_server -->|"registers resources"| node_reference
node_server -->|"initializes"| node_auth
node_server -->|"initializes"| node_http
node_query -->|"requests data"| node_http
node_discovery -->|"requests metadata"| node_http
node_formops -->|"requests operations"| node_http
node_variance -->|"queries GL data"| node_http
node_prompts -->|"guides querying"| node_query
node_prompts -->|"guides analysis"| node_variance
node_http -->|"gets tokens"| node_auth
node_auth -->|"authenticates"| node_gateway
node_http -->|"sends API requests"| node_gateway
node_gateway -->|"accesses Landmark"| node_cloudsuite

click node_server "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/server.py"
click node_prompts "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/prompts/workflows.py"
click node_reference "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/resources/reference.py"
click node_query "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/query.py"
click node_discovery "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/query.py"
click node_formops "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/query.py"
click node_variance "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/analysis.py"
click node_auth "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/auth.py"
click node_http "https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/client.py"

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_prompts,node_reference toneBlue
class node_query,node_discovery,node_formops,node_variance toneAmber
class node_auth,node_http toneMint
class node_ai,node_gateway,node_cloudsuite toneRose
```

## Components

### MCP Interface

- [MCP Server](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/server.py): `src/infor_mcp/server.py`
- [Workflow Prompts](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/prompts/workflows.py): `src/infor_mcp/prompts/workflows.py`
- [Reference Resources](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/resources/reference.py): `src/infor_mcp/resources/reference.py`

### ERP Capabilities

- [Record Queries](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/query.py): `src/infor_mcp/tools/query.py`
- [Class Discovery](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/query.py): `src/infor_mcp/tools/query.py`
- [Form Operations](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/query.py): `src/infor_mcp/tools/query.py`
- [GL Variance](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/tools/analysis.py): `src/infor_mcp/tools/analysis.py`

### ION Access

- [OAuth Manager](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/auth.py): `src/infor_mcp/auth.py`
- [ION HTTP Client](https://github.com/clipham/infor-cloudsuite-mcp/blob/master/src/infor_mcp/client.py): `src/infor_mcp/client.py`

### External Systems

- **AI Client**
- **ION API Gateway**
- **Landmark Data**

## Connections

- AI Client → MCP Server: sends MCP requests (evidence: `README.md`)
- MCP Server → Record Queries: registers tools (evidence: `src/infor_mcp/server.py`)
- MCP Server → Class Discovery: registers tools (evidence: `src/infor_mcp/server.py`)
- MCP Server → Form Operations: registers tools (evidence: `src/infor_mcp/server.py`)
- MCP Server → GL Variance: registers tools (evidence: `src/infor_mcp/server.py`)
- MCP Server → Workflow Prompts: registers prompts (evidence: `src/infor_mcp/server.py`)
- MCP Server → Reference Resources: registers resources (evidence: `src/infor_mcp/server.py`)
- MCP Server → OAuth Manager: initializes (evidence: `src/infor_mcp/server.py`)
- MCP Server → ION HTTP Client: initializes (evidence: `src/infor_mcp/server.py`)
- Record Queries → ION HTTP Client: requests data (evidence: `src/infor_mcp/tools/query.py`)
- Class Discovery → ION HTTP Client: requests metadata (evidence: `src/infor_mcp/tools/query.py`)
- Form Operations → ION HTTP Client: requests operations (evidence: `src/infor_mcp/tools/query.py`)
- GL Variance → ION HTTP Client: queries GL data (evidence: `src/infor_mcp/tools/analysis.py`)
- Workflow Prompts → Record Queries: guides querying (evidence: `src/infor_mcp/prompts/workflows.py`)
- Workflow Prompts → GL Variance: guides analysis (evidence: `src/infor_mcp/prompts/workflows.py`)
- ION HTTP Client → OAuth Manager: gets tokens (evidence: `src/infor_mcp/client.py`)
- OAuth Manager → ION API Gateway: authenticates (evidence: `src/infor_mcp/auth.py`)
- ION HTTP Client → ION API Gateway: sends API requests (evidence: `src/infor_mcp/client.py`)
- ION API Gateway → Landmark Data: accesses Landmark (evidence: `README.md`)
