Skip to content

One Stop @ SAC: 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.

ActivityEntry

Field Type Required Details
entry_id string Yes —
author string or null Yes —
created_on string or null Yes —
kind "comment", "attachment" Yes —
text string Yes —
attachment_id string or null Yes —

Unknown fields are not accepted.

AppointmentSlot

Field Type Required Details
slot_id string Yes —
start string Yes —
end string Yes —
start_utc string or null Yes —
end_utc string or null Yes —
label string Yes —

Unknown fields are not accepted.

ArticleAttachmentTarget

Field Type Required Details
kind "article" Yes —
article_id string Yes pattern: ^[0-9a-f]{32}$

Unknown fields are not accepted.

ArticleComment

Field Type Required Details
comment_id string Yes —
parent_id string or null Yes —
author string or null Yes —
created_on string or null Yes —
text string Yes —
liked boolean Yes —
can_delete boolean Yes —
attachment_ids array of string Yes —

Unknown fields are not accepted.

Attachment

Field Type Required Details
attachment_id string Yes —
file_name string Yes —
size_bytes integer or null Yes —
size_label string or null Yes —
content_type string or null Yes —
url string Yes —
can_delete boolean Yes —

Unknown fields are not accepted.

CartItem

Field Type Required Details
cart_item_id string Yes —
item_id string or null Yes —
title string Yes —
quantity integer Yes —
quantity_editable boolean Yes —
price_label string or null Yes —

Unknown fields are not accepted.

CatalogItem

Field Type Required Details
item_id string Yes —
title string Yes —
summary string or null Yes —
kind "form", "external", "knowledge", "content" Yes —
url string Yes —
form_item_id string or null Yes —

Unknown fields are not accepted.

Category

Field Type Required Details
category_id string Yes —
title string Yes —
parent_id string or null Yes —
item_count integer Yes —
total_item_count integer Yes —

Unknown fields are not accepted.

Choice

Field Type Required Details
value string Yes —
label string Yes —

Unknown fields are not accepted.

CommentAttachmentTarget

Field Type Required Details
kind "article_comment" Yes —
article_id string Yes pattern: ^[0-9a-f]{32}$
comment_id string Yes pattern: ^[0-9a-f]{32}$

Unknown fields are not accepted.

DraftAttachmentTarget

Field Type Required Details
kind "draft" Yes —
draft_id string Yes minimum length: 16; maximum length: 100

Unknown fields are not accepted.

DraftField

Field Type Required Details
name string Yes —
label string Yes —
type string Yes —
mandatory boolean Yes —
read_only boolean Yes —
choices array of Choice Yes —
value string or null Yes —
display_value string or null Yes —
reference boolean Yes —

Unknown fields are not accepted.

Favourite

Field Type Required Details
favourite_id string Yes —
item_id string Yes —
title string Yes —
pinned boolean Yes —

Unknown fields are not accepted.

FormField

Field Type Required Details
name string Yes —
label string Yes —
type string Yes —
mandatory boolean Yes —
read_only boolean Yes —
choices array of Choice Yes —

Unknown fields are not accepted.

KnowledgeResult

Field Type Required Details
article_id string Yes —
number string Yes —
title string Yes —
summary string or null Yes —
published string or null Yes —
url string Yes —

Unknown fields are not accepted.

Field Type Required Details
label string Yes —
url string Yes —

Unknown fields are not accepted.

ListCoverage

Field Type Required Details
kind "case", "request" Yes —
state_group "open", "closed" Yes —
available_count integer Yes —
source_count integer Yes —
source_count_is_lower_bound boolean Yes —
complete boolean Yes —

Unknown fields are not accepted.

NamedValue

Field Type Required Details
name string Yes —
label string Yes —
value string or null Yes —

Unknown fields are not accepted.

PortalRecord

Field Type Required Details
record_id string or null Yes —
title string Yes —
url string or null Yes —
fields array of NamedValue Yes —

Unknown fields are not accepted.

Preference

Field Type Required Details
name string Yes —
label string Yes —
value string or null Yes —
enabled boolean Yes —
choices array of Choice Yes —

Unknown fields are not accepted.

ProfileField

Field Type Required Details
name string Yes —
label string Yes —
value string or null Yes —
type string Yes —
read_only boolean Yes —
choices array of Choice Yes —

Unknown fields are not accepted.

ReferenceChoice

Field Type Required Details
value string Yes —
label string Yes —

Unknown fields are not accepted.

RequestAttachmentTarget

Field Type Required Details
kind "request" Yes —
request_id string Yes pattern: ^[0-9a-f]{32}$
record_id string or null No default: null; pattern: ^[0-9a-f]{32}$

Unknown fields are not accepted.

RequestItemStage

Field Type Required Details
item_id string Yes —
stage string or null Yes —

Unknown fields are not accepted.

RequestRecordDetails

Field Type Required Details
record_id string Yes —
record_type string Yes —
fields array of NamedValue Yes —
variables array of NamedValue Yes —

Unknown fields are not accepted.

RequestSummary

Field Type Required Details
request_id string Yes —
kind "case", "request" Yes —
state_group "open", "closed" Yes —
title string Yes —
number string or null Yes —
state string or null Yes —
created_on string or null Yes —
record_type string Yes —
url string Yes —
detail_supported boolean Yes —

Unknown fields are not accepted.

SavedCart

Field Type Required Details
cart_id string Yes —
name string Yes —

Unknown fields are not accepted.