# ttiama/pad-mcp architecture

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

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

## Overview

pad-mcp is an MCP server that helps agents generate Power Automate Desktop flows using approved team knowledge and bundled action/type catalogs. The main workflow is: a developer selects Classic or Power Fx, searches catalog references and published patterns, then uses the returned Robin guidance to build a flow. Maintainers also create, review, publish, import, and export knowledge, and inspect usage statistics. The graph follows documented capabilities and shown imports/calls; unsampled handlers and storage details are represented only where the README or excerpts support them.

Main entry points: [`src/server.js`](https://github.com/ttiama/pad-mcp/blob/main/src/server.js) (MCP Server), [`src/index.js`](https://github.com/ttiama/pad-mcp/blob/main/src/index.js) (Application Startup), [`src/bootstrap.js`](https://github.com/ttiama/pad-mcp/blob/main/src/bootstrap.js) (Seed Bootstrap), [`src/store.js`](https://github.com/ttiama/pad-mcp/blob/main/src/store.js) (Knowledge Store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["MCP Runtime"]
  node_mcp_server["MCP Server<br/>[server.js]"]
  node_prompts["Development Prompts<br/>[prompts.js]"]
  node_schemas["Tool Schemas<br/>[schema.js]"]
  node_rate_limit["Call Rate Limiter<br/>[rate-limit.js]"]
  node_server_entry["Application Startup<br/>[index.js]"]
end

subgraph group_knowledge["Team Knowledge"]
  node_knowledge_store["Knowledge Store<br/>[store.js]"]
  node_sqlite[("SQLite Database<br/>[store.js]")]
  node_bootstrap["Seed Bootstrap<br/>[bootstrap.js]"]
  node_seed["Initial Knowledge<br/>[seed.json]"]
end

subgraph group_catalogs["PAD References"]
  node_catalog_cache["Catalog Cache<br/>[catalog-cache.js]"]
  node_catalog_index["Catalog Search<br/>[catalog.js]"]
  node_catalog_data["Action and Type Catalogs"]
end

subgraph group_operations["Access and Operations"]
  node_api_keys["Developer API Keys<br/>[api-keys.js]"]
  node_usage_stats["Usage Statistics<br/>[usage.js]"]
end

node_developer(("Developer"))
node_maintainer(("Maintainer"))

node_developer -->|"calls tools"| node_mcp_server
node_maintainer -->|"manages knowledge"| node_mcp_server
node_server_entry -->|"creates"| node_knowledge_store
node_server_entry -->|"runs bootstrap"| node_bootstrap
node_server_entry -->|"starts app"| node_mcp_server
node_server_entry -->|"creates"| node_catalog_cache
node_server_entry -->|"configures"| node_rate_limit
node_bootstrap -->|"seeds and publishes"| node_knowledge_store
node_bootstrap -->|"validates seed"| node_schemas
node_bootstrap -->|"reads seed"| node_seed
node_knowledge_store -->|"reads and writes"| node_sqlite
node_mcp_server -->|"handles knowledge tools"| node_knowledge_store
node_mcp_server -->|"validates tool input"| node_schemas
node_mcp_server -->|"gets catalog"| node_catalog_cache
node_mcp_server -->|"builds guidance"| node_prompts
node_mcp_server -->|"authenticates keys"| node_api_keys
node_mcp_server -->|"records and reports"| node_usage_stats
node_mcp_server -->|"limits calls"| node_rate_limit
node_catalog_cache -->|"builds index"| node_catalog_index
node_catalog_index -->|"searches bundled data"| node_catalog_data
node_usage_stats -->|"records counters"| node_sqlite
node_api_keys -->|"stores key records"| node_sqlite

click node_mcp_server "https://github.com/ttiama/pad-mcp/blob/main/src/server.js"
click node_prompts "https://github.com/ttiama/pad-mcp/blob/main/src/prompts.js"
click node_schemas "https://github.com/ttiama/pad-mcp/blob/main/src/schema.js"
click node_rate_limit "https://github.com/ttiama/pad-mcp/blob/main/src/rate-limit.js"
click node_knowledge_store "https://github.com/ttiama/pad-mcp/blob/main/src/store.js"
click node_sqlite "https://github.com/ttiama/pad-mcp/blob/main/src/store.js"
click node_bootstrap "https://github.com/ttiama/pad-mcp/blob/main/src/bootstrap.js"
click node_seed "https://github.com/ttiama/pad-mcp/blob/main/knowledge/seed.json"
click node_catalog_cache "https://github.com/ttiama/pad-mcp/blob/main/src/catalog-cache.js"
click node_catalog_index "https://github.com/ttiama/pad-mcp/blob/main/src/catalog.js"
click node_catalog_data "https://github.com/ttiama/pad-mcp/tree/main/catalogs"
click node_api_keys "https://github.com/ttiama/pad-mcp/blob/main/src/api-keys.js"
click node_usage_stats "https://github.com/ttiama/pad-mcp/blob/main/src/usage.js"
click node_server_entry "https://github.com/ttiama/pad-mcp/blob/main/src/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_prompts,node_schemas,node_rate_limit,node_server_entry toneBlue
class node_knowledge_store,node_sqlite,node_bootstrap,node_seed toneAmber
class node_catalog_cache,node_catalog_index,node_catalog_data toneMint
class node_api_keys,node_usage_stats toneRose
class node_developer,node_maintainer toneIndigo
```

## Components

### MCP Runtime

- [MCP Server](https://github.com/ttiama/pad-mcp/blob/main/src/server.js): `src/server.js`
- [Development Prompts](https://github.com/ttiama/pad-mcp/blob/main/src/prompts.js): `src/prompts.js`
- [Tool Schemas](https://github.com/ttiama/pad-mcp/blob/main/src/schema.js): `src/schema.js`
- [Call Rate Limiter](https://github.com/ttiama/pad-mcp/blob/main/src/rate-limit.js): `src/rate-limit.js`
- [Application Startup](https://github.com/ttiama/pad-mcp/blob/main/src/index.js): `src/index.js`

### Team Knowledge

- [Knowledge Store](https://github.com/ttiama/pad-mcp/blob/main/src/store.js): `src/store.js`
- [SQLite Database](https://github.com/ttiama/pad-mcp/blob/main/src/store.js): `src/store.js`
- [Seed Bootstrap](https://github.com/ttiama/pad-mcp/blob/main/src/bootstrap.js): `src/bootstrap.js`
- [Initial Knowledge](https://github.com/ttiama/pad-mcp/blob/main/knowledge/seed.json): `knowledge/seed.json`

### PAD References

- [Catalog Cache](https://github.com/ttiama/pad-mcp/blob/main/src/catalog-cache.js): `src/catalog-cache.js`
- [Catalog Search](https://github.com/ttiama/pad-mcp/blob/main/src/catalog.js): `src/catalog.js`
- [Action and Type Catalogs](https://github.com/ttiama/pad-mcp/tree/main/catalogs): `catalogs`

### Access and Operations

- [Developer API Keys](https://github.com/ttiama/pad-mcp/blob/main/src/api-keys.js): `src/api-keys.js`
- [Usage Statistics](https://github.com/ttiama/pad-mcp/blob/main/src/usage.js): `src/usage.js`

### Other components

- **Developer**
- **Maintainer**

## Connections

- Developer → MCP Server: calls tools (evidence: `README.md`)
- Maintainer → MCP Server: manages knowledge (evidence: `README.md`)
- Application Startup → Knowledge Store: creates (evidence: `src/index.js`)
- Application Startup → Seed Bootstrap: runs bootstrap (evidence: `src/index.js`)
- Application Startup → MCP Server: starts app (evidence: `src/index.js`)
- Application Startup → Catalog Cache: creates (evidence: `src/index.js`)
- Application Startup → Call Rate Limiter: configures (evidence: `src/index.js`)
- Seed Bootstrap → Knowledge Store: seeds and publishes (evidence: `src/bootstrap.js`)
- Seed Bootstrap → Tool Schemas: validates seed (evidence: `src/bootstrap.js`)
- Seed Bootstrap → Initial Knowledge: reads seed (evidence: `src/bootstrap.js`)
- Knowledge Store → SQLite Database: reads and writes (evidence: `src/store.js`)
- MCP Server → Knowledge Store: handles knowledge tools (evidence: `src/server.js`)
- MCP Server → Tool Schemas: validates tool input (evidence: `src/server.js`)
- MCP Server → Catalog Cache: gets catalog (evidence: `src/server.js`)
- MCP Server → Development Prompts: builds guidance (evidence: `src/server.js`)
- MCP Server → Developer API Keys: authenticates keys (evidence: `src/server.js`)
- MCP Server → Usage Statistics: records and reports (evidence: `src/server.js`)
- MCP Server → Call Rate Limiter: limits calls (evidence: `src/server.js`)
- Catalog Cache → Catalog Search: builds index (evidence: `src/catalog-cache.js`)
- Catalog Search → Action and Type Catalogs: searches bundled data
- Usage Statistics → SQLite Database: records counters (evidence: `src/usage.js`)
- Developer API Keys → SQLite Database: stores key records (evidence: `src/api-keys.js`)
