# eduardokrausme/moodle-local_mcp architecture

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

- Interactive diagram: https://gitdiagram.com/eduardokrausme/moodle-local_mcp
- Repository: https://github.com/eduardokrausme/moodle-local_mcp

## Overview

Moodle MCP connects AI clients to Moodle through an MCP server, exposing permission-aware READ tools and preview/confirmation-gated WRITE tools. OAuth authorization and token resolution establish the connected identity; tool registries dispatch requests into Moodle data and administrative operations. The plugin also supports provider extensions, assignment and quiz workflows, diagnostics, audit, and site configuration. Several subsystem implementations are unsampled, so their nodes use exact directory paths and only documented or indexed relationships are shown; dashed edges indicate documented but unverified dispatch.

Main entry points: [`classes/protocol/mcp_server.php`](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/protocol/mcp_server.php) (MCP server), [`classes/write/tool`](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/write/tool) (Core WRITE tools), [`classes/read/tool`](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/read/tool) (Core READ tools), [`server.php`](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/server.php) (MCP endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["Connection and protocol"]
  node_server_entry["MCP endpoint<br/>[server.php]"]
  node_mcp_server["MCP server<br/>[mcp_server.php]"]
  node_http["HTTP transport<br/>[http.php]"]
  node_oauth_authorize["OAuth authorization<br/>[authorize.php]"]
  node_authorization["Authorization service"]
  node_oauth_token["Token endpoint<br/>[token.php]"]
  node_token_service["Token service<br/>[token_service.php]"]
  node_connection_service["Connections"]
  node_metadata["OAuth metadata<br/>[metadata.php]"]
end

subgraph group_governance["Security and governance"]
  node_identity["Authenticated identity"]
  node_token_resolver["Token resolver<br/>[token_resolver.php]"]
  node_scope["Scope checks<br/>[scope.php]"]
  node_capability["Capability guard"]
  node_confirmation["Write confirmation"]
  node_access["User access<br/>[user_access.php]"]
  node_untrusted["Untrusted content"]
  node_sequence["Workflow sequence<br/>[sequence.php]"]
end

subgraph group_tools["Moodle tool domains"]
  node_read_registry["READ registry<br/>[registry.php]"]
  node_write_registry["WRITE registry<br/>[registry.php]"]
  node_read_tools["Core READ tools"]
  node_write_tools["Core WRITE tools"]
  node_assignment["Assignment workflows"]
  node_quiz["Quiz workflows"]
  node_course_services["Course operations"]
  node_grade_completion["Grades and completion"]
  node_question_bank["Question banks"]
end

subgraph group_extensions["Extensions and operations"]
  node_audit["Audit summaries<br/>[summary.php]"]
  node_extensions_manager["Provider discovery<br/>[manager.php]"]
  node_diagnostics["Diagnostics<br/>[diagnostics.php]"]
  node_site_config["Site configuration<br/>[site_config.php]"]
end

node_ai(("AI client"))
node_external_providers["Moodle providers"]
node_admin(("Moodle administrator"))
node_moodle["Moodle platform"]

node_ai -->|"sends MCP requests"| node_server_entry
node_server_entry -->|"dispatches to"| node_mcp_server
node_server_entry -->|"loads platform"| node_moodle
node_mcp_server -->|"resolves bearer token"| node_token_resolver
node_mcp_server -->|"loads tools"| node_write_registry
node_mcp_server -.->|"dispatches tools"| node_read_registry
node_mcp_server -.->|"formats responses"| node_http
node_oauth_authorize -->|"validates authorization"| node_authorization
node_authorization -.->|"uses connection data"| node_connection_service
node_oauth_token -.->|"exchanges tokens"| node_token_service
node_mcp_server -->|"uses identity"| node_identity
node_mcp_server -->|"checks scopes"| node_scope
node_mcp_server -->|"checks permissions"| node_capability
node_mcp_server -->|"gates writes"| node_confirmation
node_mcp_server -->|"checks access"| node_access
node_mcp_server -->|"records outcomes"| node_audit
node_mcp_server -->|"logs diagnostics"| node_diagnostics
node_mcp_server -.->|"serves workflow resource"| node_sequence
node_read_registry -.->|"registers tools"| node_read_tools
node_write_registry -.->|"registers tools"| node_write_tools
node_read_tools -.->|"provides assignment reads"| node_assignment
node_write_tools -.->|"provides assignment writes"| node_assignment
node_read_tools -.->|"provides quiz reads"| node_quiz
node_write_tools -.->|"provides quiz writes"| node_quiz
node_write_tools -.->|"supports course changes"| node_course_services
node_read_tools -.->|"reports learning progress"| node_grade_completion
node_write_tools -.->|"supports question changes"| node_question_bank
node_assignment -->|"marks model-facing content"| node_untrusted
node_extensions_manager -.->|"discovers providers"| node_external_providers
node_ai -.->|"authorizes connection"| node_oauth_authorize
node_admin -.->|"reviews configuration"| node_site_config
node_site_config -.->|"exposes approved setting writes"| node_write_tools

click node_server_entry "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/server.php"
click node_mcp_server "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/protocol/mcp_server.php"
click node_http "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/protocol/http.php"
click node_oauth_authorize "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/oauth/authorize.php"
click node_authorization "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/authorization_service.php"
click node_oauth_token "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/oauth/token.php"
click node_token_service "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/token_service.php"
click node_connection_service "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/connection_service.php"
click node_metadata "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/metadata.php"
click node_read_registry "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/read/registry.php"
click node_write_registry "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/write/registry.php"
click node_read_tools "https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/read/tool"
click node_write_tools "https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/write/tool"
click node_assignment "https://github.com/eduardokrausme/moodle-local_mcp/tree/master/tool/assign/classes"
click node_quiz "https://github.com/eduardokrausme/moodle-local_mcp/tree/master/tool/quiz/classes"
click node_course_services "https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/course"
click node_grade_completion "https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/grades"
click node_question_bank "https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/question"
click node_identity "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/authenticated_identity.php"
click node_token_resolver "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/token_resolver.php"
click node_scope "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/scope.php"
click node_capability "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/capability_guard.php"
click node_confirmation "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/confirmation_service.php"
click node_access "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/user_access.php"
click node_untrusted "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/untrusted_content.php"
click node_sequence "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/workflow/sequence.php"
click node_audit "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/audit/summary.php"
click node_extensions_manager "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/extension/manager.php"
click node_diagnostics "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/diagnostics.php"
click node_site_config "https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/config/site_config.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_server_entry,node_mcp_server,node_http,node_oauth_authorize,node_authorization,node_oauth_token,node_token_service,node_connection_service,node_metadata,node_ai toneBlue
class node_identity,node_token_resolver,node_scope,node_capability,node_confirmation,node_access,node_untrusted,node_sequence toneAmber
class node_read_registry,node_write_registry,node_read_tools,node_write_tools,node_assignment,node_quiz,node_course_services,node_grade_completion,node_question_bank toneMint
class node_audit,node_extensions_manager,node_diagnostics,node_site_config toneRose
class node_external_providers,node_admin,node_moodle toneIndigo
```

## Components

### Connection and protocol

- [MCP endpoint](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/server.php): `server.php`
- [MCP server](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/protocol/mcp_server.php): `classes/protocol/mcp_server.php`
- [HTTP transport](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/protocol/http.php): `classes/protocol/http.php`
- [OAuth authorization](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/oauth/authorize.php): `oauth/authorize.php`
- [Authorization service](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/authorization_service.php): `classes/oauth/authorization_service.php`
- [Token endpoint](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/oauth/token.php): `oauth/token.php`
- [Token service](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/token_service.php): `classes/oauth/token_service.php`
- [Connections](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/connection_service.php): `classes/oauth/connection_service.php`
- [OAuth metadata](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/oauth/metadata.php): `classes/oauth/metadata.php`

### Security and governance

- [Authenticated identity](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/authenticated_identity.php): `classes/security/authenticated_identity.php`
- [Token resolver](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/token_resolver.php): `classes/security/token_resolver.php`
- [Scope checks](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/scope.php): `classes/security/scope.php`
- [Capability guard](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/capability_guard.php): `classes/security/capability_guard.php`
- [Write confirmation](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/confirmation_service.php): `classes/security/confirmation_service.php`
- [User access](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/user_access.php): `classes/security/user_access.php`
- [Untrusted content](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/security/untrusted_content.php): `classes/security/untrusted_content.php`
- [Workflow sequence](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/workflow/sequence.php): `classes/workflow/sequence.php`

### Moodle tool domains

- [READ registry](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/read/registry.php): `classes/read/registry.php`
- [WRITE registry](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/write/registry.php): `classes/write/registry.php`
- [Core READ tools](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/read/tool): `classes/read/tool`
- [Core WRITE tools](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/write/tool): `classes/write/tool`
- [Assignment workflows](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/tool/assign/classes): `tool/assign/classes`
- [Quiz workflows](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/tool/quiz/classes): `tool/quiz/classes`
- [Course operations](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/course): `classes/course`
- [Grades and completion](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/grades): `classes/grades`
- [Question banks](https://github.com/eduardokrausme/moodle-local_mcp/tree/master/classes/question): `classes/question`

### Extensions and operations

- [Audit summaries](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/audit/summary.php): `classes/audit/summary.php`
- [Provider discovery](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/extension/manager.php): `classes/extension/manager.php`
- [Diagnostics](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/diagnostics.php): `classes/diagnostics.php`
- [Site configuration](https://github.com/eduardokrausme/moodle-local_mcp/blob/master/classes/config/site_config.php): `classes/config/site_config.php`

### Other components

- **AI client**
- **Moodle providers**
- **Moodle administrator**
- **Moodle platform**

## Connections

- AI client → MCP endpoint: sends MCP requests
- MCP endpoint → MCP server: dispatches to (evidence: `server.php`)
- MCP endpoint → Moodle platform: loads platform (evidence: `server.php`)
- MCP server → Token resolver: resolves bearer token (evidence: `classes/protocol/mcp_server.php`)
- MCP server → WRITE registry: loads tools (evidence: `classes/protocol/mcp_server.php`)
- MCP server → READ registry: dispatches tools
- MCP server → HTTP transport: formats responses
- OAuth authorization → Authorization service: validates authorization (evidence: `oauth/authorize.php`)
- Authorization service → Connections: uses connection data
- Token endpoint → Token service: exchanges tokens
- MCP server → Authenticated identity: uses identity (evidence: `classes/protocol/mcp_server.php`)
- MCP server → Scope checks: checks scopes (evidence: `classes/protocol/mcp_server.php`)
- MCP server → Capability guard: checks permissions (evidence: `classes/protocol/mcp_server.php`)
- MCP server → Write confirmation: gates writes (evidence: `classes/protocol/mcp_server.php`)
- MCP server → User access: checks access (evidence: `classes/protocol/mcp_server.php`)
- MCP server → Audit summaries: records outcomes (evidence: `classes/protocol/mcp_server.php`)
- MCP server → Diagnostics: logs diagnostics (evidence: `classes/protocol/mcp_server.php`)
- MCP server → Workflow sequence: serves workflow resource (evidence: `classes/protocol/mcp_server.php`)
- READ registry → Core READ tools: registers tools
- WRITE registry → Core WRITE tools: registers tools
- Core READ tools → Assignment workflows: provides assignment reads
- Core WRITE tools → Assignment workflows: provides assignment writes
- Core READ tools → Quiz workflows: provides quiz reads
- Core WRITE tools → Quiz workflows: provides quiz writes
- Core WRITE tools → Course operations: supports course changes
- Core READ tools → Grades and completion: reports learning progress
- Core WRITE tools → Question banks: supports question changes
- Assignment workflows → Untrusted content: marks model-facing content (evidence: `tool/assign/classes/service.php`)
- Provider discovery → Moodle providers: discovers providers
- AI client → OAuth authorization: authorizes connection
- Moodle administrator → Site configuration: reviews configuration
- Site configuration → Core WRITE tools: exposes approved setting writes
