# uniquekaiser/getmcp-extensions architecture

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

- Interactive diagram: https://gitdiagram.com/uniquekaiser/getmcp-extensions
- Repository: https://github.com/uniquekaiser/getmcp-extensions

## Overview

GetMCP Extensions is a WordPress add-on that extends GetMCP with personal and remote MCP connections, project gateways, OAuth access controls, and marketing-provider connections. The main workflow is an administrator configuring or importing a connection, then users accessing its permitted MCP capabilities; gateway membership delegates access to selected servers. Runtime initialization selects compatible adapters and registers feature modules. The README documents several user-facing capabilities whose exact internal wiring is not shown in the excerpts, so those relationships are shown as documented rather than inferred from module names.

Main entry points: [`includes/class-runtime.php`](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-runtime.php) (Feature runtime), [`compat/includes/core/class-server-manager.php`](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/core/class-server-manager.php) (Server management), [`compat/includes/gateway/class-mcp-gateway.php`](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/gateway/class-mcp-gateway.php) (Project gateways), [`admin/native-connections.js`](https://github.com/uniquekaiser/getmcp-extensions/blob/main/admin/native-connections.js) (Connection administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and safety"]
  node_runtime["Feature runtime<br/>[class-runtime.php]"]
  node_lifecycle["Lifecycle and schema"]
  node_guard["Endpoint safety guard<br/>[endpoint-guard.php]"]
  node_updater["Public updater<br/>[class-updater.php]"]
end

subgraph group_connections["Connections and import"]
  node_server_api["Server REST API"]
  node_server_manager["Server management"]
  node_config_import["Configuration import"]
  node_config_convert["Configuration converter"]
  node_remote_client["Remote MCP client"]
  node_remote_oauth["Upstream OAuth"]
  node_protocol["MCP protocol routing"]
  node_tool_calls["Tool call handler"]
  node_executor["Tool execution"]
end

subgraph group_access["Access and gateways"]
  node_oauth["Native OAuth access"]
  node_oauth_settings["Authentication settings"]
  node_gateway["Project gateways"]
  node_gateway_features["Gateway capabilities"]
end

subgraph group_marketing["Marketing providers"]
  node_marketing["Marketing module"]
  node_marketing_templates["Marketing templates"]
  node_provider_discovery["Provider discovery"]
  node_provider_connections["Personal provider accounts"]
  node_provider_execution["Provider execution"]
end

subgraph group_admin["Administration"]
  node_connection_ui["Connection administration"]
  node_connection_screens["Connection screens"]
  node_oauth_picker["User allowlist picker"]
end

node_admin(("WordPress administrator"))
node_user(("MCP user"))
node_provider(("MCP provider"))
node_updates_service["GitHub releases"]

node_admin -->|"configures connections"| node_connection_ui
node_connection_ui -.->|"uses admin screens"| node_connection_screens
node_admin -->|"imports configurations"| node_config_import
node_config_import -.->|"imports entries"| node_server_api
node_admin -->|"converts configuration"| node_config_convert
node_connection_ui -.->|"manages servers"| node_server_api
node_server_api -->|"manages records"| node_server_manager
node_server_manager -.->|"stores remote definitions"| node_remote_client
node_remote_client -->|"requests MCP capabilities"| node_provider
node_remote_oauth -->|"authenticates upstream"| node_provider
node_user -->|"calls MCP endpoint"| node_protocol
node_protocol -.->|"routes tool calls"| node_tool_calls
node_tool_calls -->|"executes tool"| node_executor
node_oauth_picker -->|"selects allowed users"| node_oauth
node_oauth_settings -->|"prepares auth updates"| node_server_manager
node_user -->|"accesses project gateway"| node_gateway
node_gateway -.->|"serves gateway capabilities"| node_gateway_features
node_gateway -->|"selects member servers"| node_server_manager
node_runtime -->|"boots module"| node_marketing
node_runtime -->|"boots screens"| node_connection_screens
node_runtime -->|"registers lifecycle hooks"| node_lifecycle
node_lifecycle -->|"installs persistent guard"| node_guard
node_runtime -->|"loads guard"| node_guard
node_admin -->|"installs draft templates"| node_marketing_templates
node_admin -->|"discovers providers"| node_provider_discovery
node_user -->|"manages personal accounts"| node_provider_connections
node_provider_connections -.->|"executes provider actions"| node_provider_execution
node_provider_execution -->|"calls provider"| node_provider
node_admin -->|"checks updates"| node_updater
node_updater -->|"validates releases"| node_updates_service

click node_runtime "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-runtime.php"
click node_lifecycle "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-lifecycle.php"
click node_guard "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/endpoint-guard.php"
click node_updater "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-updater.php"
click node_server_api "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/api/class-servers-controller.php"
click node_server_manager "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/core/class-server-manager.php"
click node_connection_ui "https://github.com/uniquekaiser/getmcp-extensions/blob/main/admin/native-connections.js"
click node_connection_screens "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-connection-screens.php"
click node_config_import "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-configuration-import.php"
click node_config_convert "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-configuration-transcoder.php"
click node_remote_client "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/remote/class-mcp-client.php"
click node_remote_oauth "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/remote/class-upstream-oauth.php"
click node_oauth "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/auth/class-first-party-oauth.php"
click node_oauth_settings "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-authentication-settings.php"
click node_oauth_picker "https://github.com/uniquekaiser/getmcp-extensions/blob/main/admin/oauth-user-picker.js"
click node_gateway "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/gateway/class-mcp-gateway.php"
click node_gateway_features "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/gateway/class-feature-handler.php"
click node_protocol "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/protocol/class-json-rpc-router.php"
click node_tool_calls "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/protocol/class-tools-call-handler.php"
click node_executor "https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/execution/class-tool-executor.php"
click node_marketing "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-marketing-module.php"
click node_marketing_templates "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-marketing-templates.php"
click node_provider_discovery "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-provider-discovery.php"
click node_provider_connections "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-provider-connections.php"
click node_provider_execution "https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-provider-execution.php"

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_runtime,node_lifecycle,node_guard,node_updater,node_user toneBlue
class node_server_api,node_server_manager,node_config_import,node_config_convert,node_remote_client,node_remote_oauth,node_protocol,node_tool_calls,node_executor toneAmber
class node_oauth,node_oauth_settings,node_gateway,node_gateway_features toneMint
class node_marketing,node_marketing_templates,node_provider_discovery,node_provider_connections,node_provider_execution toneRose
class node_connection_ui,node_connection_screens,node_oauth_picker,node_admin,node_provider,node_updates_service toneIndigo
```

## Components

### Runtime and safety

- [Feature runtime](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-runtime.php): `includes/class-runtime.php`
- [Lifecycle and schema](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-lifecycle.php): `includes/class-lifecycle.php`
- [Endpoint safety guard](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/endpoint-guard.php): `includes/endpoint-guard.php`
- [Public updater](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-updater.php): `includes/class-updater.php`

### Connections and import

- [Server REST API](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/api/class-servers-controller.php): `compat/includes/api/class-servers-controller.php`
- [Server management](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/core/class-server-manager.php): `compat/includes/core/class-server-manager.php`
- [Configuration import](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-configuration-import.php): `includes/class-configuration-import.php`
- [Configuration converter](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-configuration-transcoder.php): `includes/class-configuration-transcoder.php`
- [Remote MCP client](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/remote/class-mcp-client.php): `compat/includes/remote/class-mcp-client.php`
- [Upstream OAuth](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/remote/class-upstream-oauth.php): `compat/includes/remote/class-upstream-oauth.php`
- [MCP protocol routing](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/protocol/class-json-rpc-router.php): `compat/includes/protocol/class-json-rpc-router.php`
- [Tool call handler](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/protocol/class-tools-call-handler.php): `compat/includes/protocol/class-tools-call-handler.php`
- [Tool execution](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/execution/class-tool-executor.php): `compat/includes/execution/class-tool-executor.php`

### Access and gateways

- [Native OAuth access](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/auth/class-first-party-oauth.php): `compat/includes/auth/class-first-party-oauth.php`
- [Authentication settings](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-authentication-settings.php): `includes/class-authentication-settings.php`
- [Project gateways](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/gateway/class-mcp-gateway.php): `compat/includes/gateway/class-mcp-gateway.php`
- [Gateway capabilities](https://github.com/uniquekaiser/getmcp-extensions/blob/main/compat/includes/gateway/class-feature-handler.php): `compat/includes/gateway/class-feature-handler.php`

### Marketing providers

- [Marketing module](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-marketing-module.php): `includes/class-marketing-module.php`
- [Marketing templates](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-marketing-templates.php): `includes/class-marketing-templates.php`
- [Provider discovery](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-provider-discovery.php): `includes/class-provider-discovery.php`
- [Personal provider accounts](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-provider-connections.php): `includes/class-provider-connections.php`
- [Provider execution](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-provider-execution.php): `includes/class-provider-execution.php`

### Administration

- [Connection administration](https://github.com/uniquekaiser/getmcp-extensions/blob/main/admin/native-connections.js): `admin/native-connections.js`
- [Connection screens](https://github.com/uniquekaiser/getmcp-extensions/blob/main/includes/class-connection-screens.php): `includes/class-connection-screens.php`
- [User allowlist picker](https://github.com/uniquekaiser/getmcp-extensions/blob/main/admin/oauth-user-picker.js): `admin/oauth-user-picker.js`

### Other components

- **WordPress administrator**
- **MCP user**
- **MCP provider**
- **GitHub releases**

## Connections

- WordPress administrator → Connection administration: configures connections (evidence: `README.md`)
- Connection administration → Connection screens: uses admin screens
- WordPress administrator → Configuration import: imports configurations (evidence: `README.md`)
- Configuration import → Server REST API: imports entries
- WordPress administrator → Configuration converter: converts configuration (evidence: `README.md`)
- Connection administration → Server REST API: manages servers
- Server REST API → Server management: manages records (evidence: `compat/includes/api/class-servers-controller.php`)
- Server management → Remote MCP client: stores remote definitions
- Remote MCP client → MCP provider: requests MCP capabilities (evidence: `README.md`)
- Upstream OAuth → MCP provider: authenticates upstream (evidence: `README.md`)
- MCP user → MCP protocol routing: calls MCP endpoint (evidence: `README.md`)
- MCP protocol routing → Tool call handler: routes tool calls
- Tool call handler → Tool execution: executes tool (evidence: `compat/includes/protocol/class-tools-call-handler.php`)
- User allowlist picker → Native OAuth access: selects allowed users (evidence: `README.md`)
- Authentication settings → Server management: prepares auth updates (evidence: `compat/includes/core/class-server-manager.php`)
- MCP user → Project gateways: accesses project gateway (evidence: `README.md`)
- Project gateways → Gateway capabilities: serves gateway capabilities
- Project gateways → Server management: selects member servers
- Feature runtime → Marketing module: boots module (evidence: `includes/class-runtime.php`)
- Feature runtime → Connection screens: boots screens (evidence: `includes/class-runtime.php`)
- Feature runtime → Lifecycle and schema: registers lifecycle hooks (evidence: `getmcp-extensions.php`)
- Lifecycle and schema → Endpoint safety guard: installs persistent guard (evidence: `includes/class-lifecycle.php`)
- Feature runtime → Endpoint safety guard: loads guard (evidence: `getmcp-extensions.php`)
- WordPress administrator → Marketing templates: installs draft templates (evidence: `README.md`)
- WordPress administrator → Provider discovery: discovers providers (evidence: `README.md`)
- MCP user → Personal provider accounts: manages personal accounts (evidence: `README.md`)
- Personal provider accounts → Provider execution: executes provider actions
- Provider execution → MCP provider: calls provider (evidence: `README.md`)
- WordPress administrator → Public updater: checks updates (evidence: `README.md`)
- Public updater → GitHub releases: validates releases (evidence: `includes/class-updater.php`)
