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 |
— |