Skip to content

NTULearn: MCP data types

Service overview · MCP reference

MCP data types

These named types describe nested fields in the MCP tool reference. A required field may still be null when its type allows it.

Announcement

Field Type Required Details
id string Yes —
title string Yes —
body string or null No default: null
created string or null No default: null; format: date-time
modified string or null No default: null; format: date-time

Attachment

Field Type Required Details
id string Yes —
file_name string Yes —
mime_type string or null No default: null

CalendarItem

Field Type Required Details
id string Yes —
title string Yes —
type string or null No default: null
calendar_name string or null No default: null
course_id string or null No default: null
start string or null No default: null; format: date-time
end string or null No default: null; format: date-time
description string or null No default: null
location string or null No default: null

Content

Field Type Required Details
id string Yes —
title string Yes —
parent_id string or null No default: null
has_children boolean or null No default: null
type string or null No default: null
body string or null No default: null
description string or null No default: null
modified string or null No default: null; format: date-time

ContentMatch

Field Type Required Details
course_id string Yes —
content_id string Yes —
title string Yes —
breadcrumb array of string Yes —
excerpt string Yes —

ContentNode

Field Type Required Details
id string Yes —
title string Yes —
parent_id string or null No default: null
has_children boolean or null No default: null
type string or null No default: null
body string or null No default: null
description string or null No default: null
modified string or null No default: null; format: date-time
children array of ContentNode No —
children_complete boolean or null No default: null

Course

Field Type Required Details
id string Yes —
course_code string or null No default: null
name string Yes —
available string or null No default: null
role string or null No default: null
organization boolean or null No default: null

CourseDownloadFile

Field Type Required Details
content_id string Yes —
attachment_id string Yes —
path string Yes —
status "downloaded", "skipped_existing", "failed" Yes —
bytes_written integer or null No default: null

Grade

Field Type Required Details
column_id string Yes —
score number or null No default: null
text string or null No default: null
status string or null No default: null
exempt boolean or null No default: null
feedback string or null No default: null
modified string or null No default: null; format: date-time

GradeColumn

Field Type Required Details
id string Yes —
name string Yes —
possible_score number or null No default: null
due string or null No default: null; format: date-time
available string or null No default: null
content_id string or null No default: null

Group

Field Type Required Details
id string Yes —
name string Yes —
description string or null No default: null
available string or null No default: null
parent_id string or null No default: null
is_group_set boolean or null No default: null

Issue

Field Type Required Details
service string Yes —
course_id string or null No default: null
content_id string or null No default: null
message string Yes —

MessageSummary

Field Type Required Details
id string Yes —
course_id string Yes —
conversation_id string Yes —
subject string or null No default: null
sender Person Yes —
created string or null No default: null; format: date-time
read boolean or null No default: null
folder "inbox", "sent" Yes —

Person

Field Type Required Details
id string Yes —
name string or null No default: null
role string or null No default: null

RecentAnnouncement

Field Type Required Details
id string Yes —
title string Yes —
body string or null No default: null
created string or null No default: null; format: date-time
modified string or null No default: null; format: date-time
course_id string Yes —
changed_since boolean or null Yes —

RecentGrade

Field Type Required Details
course_id string Yes —
column GradeColumn or null No default: null
grade Grade Yes —
changed_since boolean or null Yes —