create_activity
Create an activity or resource of any type (page, label, url, resource, folder, assign, quiz, forum…) at the end of a section, through Moodle's own form, hidden from students by default. Common fields have their own inputs, access restrictions and completion included; any other setting goes in se...
This record as markdown: /tools/falkenslab-moodle-mcp/create-activity.md
What create_activity does on Moodle
AI agents use create_activity to create or update resources in Moodle, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Moodle environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | — | A URL resource's target |
name | string | — | Required except for labels |
type | string | Yes | Moodle's module name: page, label, url, resource, folder, assign, quiz, forum, book… |
embed | array | — | Absolute local files (images…) to embed in the HTML, which names each by its file name: <img src="shot.png"> |
files | array | — | Absolute local paths: a file resource's file (the first is the main one), a folder's files, a SCORM's package (.zip) |
toolId | integer | — | type lti: the external tool it's made from, as list_external_tools gives it (Moodle 5 makes LTI activities only from a tool) |
content | string | — | A page's content, or a label's text (HTML) |
courseId | integer | Yes | |
settings | object | — | Any other form field by its name in Moodle's activity form, e.g. {"duedate[enabled]": true, "duedate[day]": 12, "grade[modgrade_point]": 10} |
sectionId | integer | Yes | The section's id, as get_course_structure gives it |
completion | object | — | When it counts as complete |
visibility | string | — | "stealth": hidden from the course page but available by link, where the site allows it |
Parameters from the server's own tool schema.
Why create_activity is rated Medium
An AI agent can call create_activity faster than any human can review: one bad instruction and it creates or modifies resources in Moodle by the hundred, each call as confident as the last.
Risk signalsAccepts URL/endpoint input (url) · Accepts raw HTML/template content (content) · High parameter count (32 properties)
Attacks that exploit this kind of access
The rule that runs create_activity safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Moodle, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For create_activity, this is the rule to start with:
create_activity stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Moodle, apply this rule, and every create_activity call is checked against it from then on.
Questions about create_activity
Create an activity or resource of any type (page, label, url, resource, folder, assign, quiz, forum…) at the end of a section, through Moodle's own form, hidden from students by default. Common fields have their own inputs, access restrictions and completion included; any other setting goes in settings by its form field name. files are local paths uploaded to a file resource or folder, or a SCORM's package (type scorm, the first file). Returns the new activity's id and the course structure. Changes the course: confirm with the person first. It is categorised as a Write tool in the Moodle MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
create_activity accepts 12 parameters: url, name, type, embed, files, toolId, content, courseId, settings, sectionId, completion, visibility. Required: type, courseId, sectionId. The full parameter table on this page comes from the server's own tool schema.
Register the Moodle MCP server in PolicyLayer and add a rule for create_activity: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Moodle. Nothing to install.
create_activity is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the create_activity rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for create_activity. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
create_activity is provided by the Moodle MCP server (@falkenslab/moodle-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Moodle, and thousands of servers like it.
This server
Across the catalogue