goldseam
The U.S. Marketplace of Learning2Earning Opportunity | Sourced checklists, progress, prior learning
我该使用它吗
质量与安全性
发现（13）
- LOWTool 'get_certification' description lacks action verb在 get_certification 中
- LOWTool 'certifications_for_occupation' description lacks action verb在 certifications_for_occupation 中
- LOWTool 'occupations_for_certification' description lacks action verb在 occupations_for_certification 中
- LOWTool 'related_certifications' description lacks action verb在 related_certifications 中
- LOWTool 'certifications_for_program' description lacks action verb在 certifications_for_program 中
- LOWTool 'resolve_term' description lacks action verb在 resolve_term 中
- LOWTool 'crosswalk_code' description lacks action verb在 crosswalk_code 中
- LOWTool 'get_learning_unit' description lacks action verb在 get_learning_unit 中
- LOWTool 'get_transfer_framework' description lacks action verb在 get_transfer_framework 中
- LOWTool 'checklists_requiring_learning_unit' name length outside 3-30 range在 checklists_requiring_learning_unit 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"goldseam": {
"url": "https://goldseam.ksaworks.com/mcp"
}
}
}远程端点
https://goldseam.ksaworks.com/mcpstreamable-http它能做什么
工具清单
工具（46）
🟢search_certifications(issuer, limit, offset, query)
Which certification is this prose name? Start here for any plain question — a trade, field, job, skill, or company in everyday words. Returns candidates with ids, issuers, and source basis — candidates rather than a single guess when the name is ambiguous; the ids feed the other certification tools.
输入模式
{
"type": "object",
"properties": {
"issuer": {
"description": "Optional: only certifications from this organization",
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "What you are looking for, in everyday words — a trade, field, job, or company",
"examples": [
"nursing",
"HVAC",
"welding",
"IBM",
"project management"
],
"type": "string"
}
},
"required": [
"query"
]
}输出模式
{
"type": "object",
"properties": {
"certifications": {
"description": "The certification cards",
"items": {
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"type": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"contract": {
"type": "string"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"next_offset": {
"type": "integer"
},
"portal_url": {
"description": "The same search on the portal",
"type": "string"
},
"statement": {
"type": "string"
},
"total_matching": {
"type": "integer"
},
"understood": {
"description": "What was read: words, issuer, and match (step, matched_terms, statement)",
"type": "object"
}
},
"required": [
"contract"
]
}🟢get_certification(id)
Everything held about one certification: issuer and issuer domain, occupations served, exam and renewal requirements, education-or-experience routes, Credential Engine registry identity where held, and the basis and source URL for the claim.
输入模式
{
"type": "object",
"properties": {
"id": {
"description": "A certification id, copied from a search result's id field",
"examples": [
"LU_CERT_ONET_13108200_8F3480AC7A"
],
"type": "string"
}
},
"required": [
"id"
]
}🟢certifications_for_occupation(limit, offset, soc)
What certifications serve this occupation? SOC-keyed lookup (dashed SOC accepted with or without the O*NET .00 suffix).
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 20, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"soc": {
"description": "An occupation code (SOC), e.g. 29-1141 for Registered Nurses or 47-2111 for Electricians — don't know it? search by the job name instead",
"examples": [
"29-1141",
"47-2111"
],
"type": "string"
}
},
"required": [
"soc"
]
}🟢occupations_for_certification(id, limit, offset)
What occupations does this certification serve?
输入模式
{
"type": "object",
"properties": {
"id": {
"description": "A certification id, copied from a search result's id field",
"examples": [
"LU_CERT_ONET_13108200_8F3480AC7A"
],
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
}
},
"required": [
"id"
]
}🟢related_certifications(id, limit, offset)
What else serves the same occupation? Traverses on SOC only — a certification sharing solely an instructional program (CIP) is not related (contract § 4).
输入模式
{
"type": "object",
"properties": {
"id": {
"description": "A certification id to find others like it, copied from a search result's id field",
"examples": [
"LU_CERT_ONET_29114100_50CD2891D4"
],
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
}
},
"required": [
"id"
]
}🟢certifications_for_program(cip, limit, offset)
Broad academic cross-reference by instructional program (CIP). A deliberately broader, lower-precision question than an occupation lookup — never its peer (contract § 4).
输入模式
{
"type": "object",
"properties": {
"cip": {
"description": "A college program code (CIP), e.g. 51.3801 for Registered Nursing or 47.0201 for HVAC technology",
"examples": [
"51.3801",
"47.0201"
],
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
}
},
"required": [
"cip"
]
}🟢list_issuers(limit, offset, query)
The issuing organizations, optionally filtered by a name query.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 20, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Optional: part of an organization's name",
"examples": [
"IBM",
"nursing"
],
"type": "string"
}
},
"required": []
}🟢resolve_term(term)
Where does a word place in the KSA model? The KSA Dictionary is the shared vocabulary that defines the terms a learner uses to assert what they know, do, and are — and the terms a learning offering uses to express what it comprises — so both sides resolve to the same identifiers, never spelling matches. Answers from three linked layers (governed lexicon, O*NET content model, WordNet-derived index), each placement attributed to its layer with provenance; the WordNet placement carries the word's definition (gloss) and synonyms.
输入模式
{
"type": "object",
"properties": {
"term": {
"description": "A word for something a person knows or can do, e.g. carpentry or mathematics",
"examples": [
"carpentry",
"mathematics",
"welding"
],
"type": "string"
}
},
"required": [
"term"
]
}🟢expand_term(term)
What is this word, upward? Walks the WordNet is-a (hypernym) chain meaning to parent meaning, from the word's KSA-mapped sense toward its broader categories, so every step stays in the sense it started in. Each step carries its definition (gloss) and synonyms.
输入模式
{
"type": "object",
"properties": {
"term": {
"description": "A word to see what broader kind of thing it is, e.g. carpentry",
"examples": [
"carpentry",
"nursing"
],
"type": "string"
}
},
"required": [
"term"
]
}🟢get_dictionary_summary
What does the KSA Dictionary hold? The words and meanings it places, the governed terms, the O*NET content-model elements, the link words and the CIP-SOC crosswalk, each with its own version and build date where the layer publishes one, and an honest not held where it does not. Read as published at boot, never computed at request time, and never a word lookup: for one word use resolve_term. The words it holds are those it places; it is not all of WordNet, and the answer says so.
输入模式
{
"type": "object",
"properties": {}
}🟢crosswalk_code(code, limit, offset)
What does this code cross to? Auto-detects the family — dotted CIP (52.0201) or dashed SOC (11-1021, O*NET .00 suffix accepted) — and answers the other family's codes and titles from the federal CIP-SOC crosswalk.
输入模式
{
"type": "object",
"properties": {
"code": {
"description": "A college program code (CIP, e.g. 51.3801) or an occupation code (SOC, e.g. 29-1141)",
"examples": [
"51.3801",
"29-1141"
],
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
}
},
"required": [
"code"
]
}🟢compare_program_checklists(detail, institution_offset, program, unitids)
Compare what a program takes at several institutions: for each IPEDS UNITID, that institution's published checklist for the program (requirement groups, items, published credit strings — the work effort) beside its published tuition and fee policy (the cost). Schedule is stated not held. Nothing is summed or computed by the service; an institution, checklist, or cost the catalogs do not hold is stated as such.
输入模式
{
"type": "object",
"properties": {
"detail": {
"description": "Optional: full (the default: every requirement group and item) or summary (per checklist its program, award, year, credits and group and item counts, with each school's College Scorecard tuition)",
"examples": [
"summary"
],
"type": "string"
},
"institution_offset": {
"description": "Optional: the next_institution_offset from a previous answer, for the next 5 institutions",
"type": "integer"
},
"program": {
"description": "Program or award words to match, e.g. nursing or Bachelor of Science in Nursing",
"examples": [
"Welding"
],
"type": "string"
},
"unitids": {
"description": "1 to 10 IPEDS UNITIDs, e.g. [\"100663\", \"127060\"]; answered 5 institutions per call, up to 3 checklists each",
"examples": [
[
"225070"
]
],
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"unitids",
"program"
]
}🟢find_institution(city, limit, offset, query, state)
Which institution is this? A name fragment or an IPEDS UNITID answers with the institution's identity, sector, identifiers with their sources, and how many programs, checklists, and learning units its published catalog holds here. A state lists that state's institutions by name; with no name and no state, the answer is the states that hold institutions, each with its count.
输入模式
{
"type": "object",
"properties": {
"city": {
"description": "Optional city, one of a state answer's cities, e.g. Denison",
"examples": [
"Denison"
],
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Name fragment or IPEDS UNITID, e.g. Denver or 127060",
"examples": [
"Grayson",
"225070"
],
"type": "string"
},
"state": {
"description": "Optional two-letter state, e.g. TX: that state's institutions, those with a catalog held first; the answer lists the state's cities",
"examples": [
"TX"
],
"type": "string"
}
}
}🟢programs_for_institution(limit, offset, query, unitid)
What programs does this institution publish? Award, credential class, CIP, the published credit figure verbatim, catalog edition, the captured page each came from, and the checklist ids to pass to get_checklist.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 100, at most 200)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Optional program or award words to filter by",
"type": "string"
},
"unitid": {
"description": "The institution's IPEDS UNITID",
"examples": [
"225070"
],
"type": "string"
}
},
"required": [
"unitid"
]
}🟢get_checklist(checklist_id, item_limit, item_offset)
What does this award require? One checklist: its requirement groups (every header and full item count), each group's items with published credit strings, alternatives, and — where an item resolved to a course — that course's own code, title, and published credits, attributed to the course. Items come in pages across the groups; the answer states items_total and next_item_offset. Every row names the captured page it came from.
输入模式
{
"type": "object",
"properties": {
"checklist_id": {
"description": "A checklist id from programs_for_institution or compare_program_checklists",
"examples": [
"CK_225070_05e6e123"
],
"type": "string"
},
"item_limit": {
"description": "Optional items per page (default 60, at most 150)",
"type": "integer"
},
"item_offset": {
"description": "Optional: the next_item_offset from a previous answer",
"type": "integer"
}
},
"required": [
"checklist_id"
]
}🟢learning_units(code, limit, offset, query, subject, ...)
What courses does this institution publish? Filter by subject abbreviation, course code (spaces and case ignored), or title words; each course carries its published credit string verbatim (ranges stay ranges), edition, and the captured page.
输入模式
{
"type": "object",
"properties": {
"code": {
"description": "Optional course code, e.g. BIO 201",
"type": "string"
},
"limit": {
"description": "Optional page size (default 50, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Optional title words",
"type": "string"
},
"subject": {
"description": "Optional subject abbreviation, e.g. BIO",
"examples": [
"RNSG"
],
"type": "string"
},
"unit_type": {
"description": "Optional learning-unit type, one of the answer's unit_types, e.g. course",
"type": "string"
},
"unitid": {
"description": "The institution's IPEDS UNITID",
"examples": [
"225070"
],
"type": "string"
}
},
"required": [
"unitid"
]
}🟢get_institution(organization_id, unitid)
Everything held about one institution: its identity row, identifiers, addresses, websites, accreditations, relationships, identity history, published costs and calendar dates, each table under its own name, with counts of its programs, courses, checklists, catalogs, policies and agreements and the service that lists each. Contacts name people and are not served.
输入模式
{
"type": "object",
"properties": {
"organization_id": {
"description": "The institution's organization id from find_institution, e.g. ORG_225070",
"examples": [
"ORG_225070"
],
"type": "string"
},
"unitid": {
"description": "Or its IPEDS UNITID instead, e.g. 225070",
"type": "string"
}
},
"anyOf": [
{
"required": [
"organization_id"
]
},
{
"required": [
"unitid"
]
}
]
}🟢find_catalogs(limit, offset, unitid)
Which published catalog editions are held for this institution? Each catalog's edition year, format and source. Answers none held when the build holds none.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"unitid": {
"description": "The institution's IPEDS UNITID, e.g. 225070",
"type": "string"
}
},
"required": [
"unitid"
]
}🟢get_catalog(catalog_id)
One catalog edition: its row, the institutions that use it (and whom it is shared from), and how many programs it holds.
输入模式
{
"type": "object",
"properties": {
"catalog_id": {
"description": "A catalog id from find_catalogs",
"type": "string"
}
},
"required": [
"catalog_id"
]
}🟢find_programs(city, limit, offset, query, state, ...)
Which programs match these words, across institutions? Program or award words (optionally one institution's UNITID) answer with each program's award, CIP, published credit figure verbatim, edition, source page and institution.
输入模式
{
"type": "object",
"properties": {
"city": {
"description": "Optional city: programs at that city's institutions",
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Program or award words, e.g. welding or nursing",
"examples": [
"Welding"
],
"type": "string"
},
"state": {
"description": "Optional two-letter state: programs at that state's institutions",
"type": "string"
},
"unitid": {
"description": "Optional: one institution's IPEDS UNITID",
"type": "string"
}
},
"required": [
"query"
]
}🟢get_program(program_id)
One program whole: its row, identifiers, offerings (campus resolved), its institution, and the checklists that lead to its award — pass one to get_checklist.
输入模式
{
"type": "object",
"properties": {
"program_id": {
"description": "A program id from programs_for_institution or find_programs",
"examples": [
"PG_225070_8c96bb26"
],
"type": "string"
}
},
"required": [
"program_id"
]
}🟢get_learning_unit(learning_unit_id)
One course whole: its row, prerequisites and corequisites, aliases, terms offered, articulation statements and comparable members — each linked course resolved or stated unresolved, never guessed — plus the transfer frameworks it maps to.
输入模式
{
"type": "object",
"properties": {
"learning_unit_id": {
"description": "A learning unit id from learning_units or get_checklist",
"examples": [
"LU_course_225070_ENGL1301_20262027"
],
"type": "string"
}
},
"required": [
"learning_unit_id"
]
}🟢find_policies(limit, offset, query, unitid)
Which academic policies does this institution publish (transfer credit, prior learning, tuition and fees …)? Optional words narrow them. Answers none held when the build holds none.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Optional policy words, e.g. transfer",
"type": "string"
},
"unitid": {
"description": "The institution's IPEDS UNITID, e.g. 225070",
"type": "string"
}
},
"required": [
"unitid"
]
}🟢get_policy(policy_id)
One published academic policy: its section, verbatim text, page, edition and source.
输入模式
{
"type": "object",
"properties": {
"policy_id": {
"description": "A policy id from find_policies",
"type": "string"
}
},
"required": [
"policy_id"
]
}🟢find_checklists(limit, offset, program_id, query, unitid)
Which checklists — the generic itinerary of requirements for an award — does this institution publish? Optional award words or a program id narrow them; pass one to get_checklist.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"program_id": {
"description": "Optional: one program's id",
"type": "string"
},
"query": {
"description": "Optional award words, e.g. welding",
"type": "string"
},
"unitid": {
"description": "The institution's IPEDS UNITID",
"examples": [
"225070"
],
"type": "string"
}
},
"required": [
"unitid"
]
}🟢find_agreements(limit, offset, query, unitid)
Which articulation or transfer agreements are held? Optional title words, or an institution's UNITID as a party. Answers none held when the build holds none.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Optional agreement title words",
"type": "string"
},
"unitid": {
"description": "Optional: an institution party's IPEDS UNITID",
"type": "string"
}
}
}🟢get_agreement(agreement_id)
One agreement: its row, its parties (organizations resolved), and the pathways, comparability bundles and checklists that cite it. Signatories name people and are not served.
输入模式
{
"type": "object",
"properties": {
"agreement_id": {
"description": "An agreement id from find_agreements",
"type": "string"
}
},
"required": [
"agreement_id"
]
}🟢find_pathways(agreement_id, checklist_id, limit, offset, query)
Which pathways are held? Optional title words, an agreement id, or a checklist id. Answers none held when the build holds none.
输入模式
{
"type": "object",
"properties": {
"agreement_id": {
"description": "Optional: the agreement a pathway rests on",
"type": "string"
},
"checklist_id": {
"description": "Optional: the checklist a pathway follows",
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Optional pathway title words",
"type": "string"
}
}
}🟢get_pathway(pathway_id)
One pathway: its row and the checklist and agreement it links. Contacts name people and are not served.
输入模式
{
"type": "object",
"properties": {
"pathway_id": {
"description": "A pathway id from find_pathways",
"type": "string"
}
},
"required": [
"pathway_id"
]
}🟢find_comparability(agreement_id, learning_unit_id, limit, offset, unitid)
Which comparability bundles (published transfer rules) are held? Optional receiving institution UNITID, agreement id, or a learning unit that appears as a source or substitute. Answers none held when the build holds none.
输入模式
{
"type": "object",
"properties": {
"agreement_id": {
"description": "Optional: the agreement that states it",
"type": "string"
},
"learning_unit_id": {
"description": "Optional: a course named in it",
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"unitid": {
"description": "Optional: the receiving institution's IPEDS UNITID",
"type": "string"
}
}
}🟢get_comparability(comparability_id)
One comparability bundle: its row (credits awarded published beside any parse), the receiving institution, and its source and substitute courses, each resolved or stated unresolved.
输入模式
{
"type": "object",
"properties": {
"comparability_id": {
"description": "A comparability id from find_comparability",
"type": "string"
}
},
"required": [
"comparability_id"
]
}🟢find_transfer_frameworks(limit, offset, query)
Which statewide or compact transfer frameworks are held? Optional name or jurisdiction words. Answers none held when the build holds none.
输入模式
{
"type": "object",
"properties": {
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"query": {
"description": "Optional framework name or jurisdiction words",
"type": "string"
}
}
}🟢get_transfer_framework(framework_id)
One transfer framework: its row, authority, codes with their meanings, and the courses mapped to it (resolved).
输入模式
{
"type": "object",
"properties": {
"framework_id": {
"description": "A framework id from find_transfer_frameworks",
"type": "string"
}
},
"required": [
"framework_id"
]
}🟢checklists_requiring_learning_unit(learning_unit_id, limit, offset)
Which checklists require this course? Each requirement item that resolved to it, with its checklist id, award and group heading. Items that did not resolve to a course are never guessed into this list.
输入模式
{
"type": "object",
"properties": {
"learning_unit_id": {
"description": "A learning unit id from learning_units or get_learning_unit",
"examples": [
"LU_course_225070_ENGL1301_20262027"
],
"type": "string"
},
"limit": {
"description": "Optional page size (default 20, at most 100)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
}
},
"required": [
"learning_unit_id"
]
}🟢search_programs_and_learning_units(award, cip, city, code, credential, ...)
Which programs or courses match, and where? Words, a subject (CIP family, or unknown), a course subject prefix, a credential class, an award as published, and a school's state, city, type or UNITID answer with product cards (name, award, length and college when held, school and city, subject, checklist size, and what the program leads to through the CIP-SOC crosswalk) and the counts to refine by. Courses across every school need words of 3 or more characters; words held by very many courses need a state, city or school.
输入模式
{
"type": "object",
"properties": {
"award": {
"description": "Optional award exactly as published, one of the answer's awards",
"examples": [
"Certificate"
],
"type": "string"
},
"cip": {
"description": "Optional: programs with this six-digit CIP code (e.g. 48.0508), a comma-separated list, or an array of codes"
},
"city": {
"description": "Optional city, one of a state answer's cities",
"type": "string"
},
"code": {
"description": "Optional, courses only: a course code as printed, e.g. ZOO 2015; lists that code at every school, or within the state, city or school given",
"type": "string"
},
"credential": {
"description": "Optional, programs only: a credential class, one of the answer's credential values (e.g. ceterms:AssociateDegree), or none",
"type": "string"
},
"limit": {
"description": "Optional page size (default 10, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"place": {
"description": "Optional: a place the question names, read as a state (name or code), a city, or a school, e.g. Wyoming or Casper",
"type": "string"
},
"query": {
"description": "Words: a program's name or award, or a course's title",
"examples": [
"nursing"
],
"type": "string"
},
"sector": {
"description": "Optional school type as IPEDS labels it, e.g. public 2-year",
"type": "string"
},
"state": {
"description": "Optional two-letter state",
"examples": [
"TX"
],
"type": "string"
},
"subject": {
"description": "Optional CIP family (two digits, e.g. 51) or unknown",
"type": "string"
},
"subject_code": {
"description": "Optional: a course subject prefix, e.g. NURS, one of the answer's subject codes. A course's own prefix as printed, or a prefix a program's checklist requires",
"type": "string"
},
"type": {
"description": "program (the default) or learning_unit",
"examples": [
"program"
],
"type": "string"
},
"unitid": {
"description": "Optional: one school's IPEDS UNITID",
"type": "string"
}
}
}输出模式
{
"type": "object",
"properties": {
"build_version": {
"description": "Deprecated: the same value as publish",
"type": "integer"
},
"census_cleared": {
"type": "boolean"
},
"contract": {
"type": "string"
},
"facets": {
"description": "The refinements: each facet's values with their counts of held rows",
"type": "object"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"next_offset": {
"type": "integer"
},
"portal_url": {
"description": "The same view on the portal",
"type": "string"
},
"publish": {
"description": "The data road's publish number",
"type": "integer"
},
"results": {
"description": "The product cards",
"items": {
"properties": {
"award": {
"description": "The award as published, or null"
},
"checklist": {
"description": "checklist_id, requirements, credits_computed; or null"
},
"college": {
"description": "The college within the school that offers the program, when held",
"type": "string"
},
"credits_published": {
"description": "A course's credits as printed, when held",
"type": "string"
},
"description_excerpt": {
"description": "A course description's first 200 characters, with an ellipsis when longer; the full text is on get_learning_unit",
"type": "string"
},
"id": {
"type": "string"
},
"leads_to": {
"description": "occupations through the CIP-SOC crosswalk; absent when none is held",
"type": "object"
},
"name": {
"type": "string"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"normal_length": {
"description": "A program's normal length as published, when held",
"type": "string"
},
"school": {
"description": "name, city, state, sector, ipeds_unit_id",
"type": "object"
},
"subject": {
"description": "cip_code, family, family_title, cip_source; absent when the program holds no CIP",
"type": "object"
},
"type": {
"description": "program or learning_unit",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"schools_matching": {
"description": "How many schools hold the matching set",
"type": "integer"
},
"statement": {
"type": "string"
},
"total_matching": {
"type": "integer"
},
"understood": {
"description": "What was read: words, place (with candidates when several schools fit), the filters in force, question (frame, department, not_held words), lead (the product a page shows first), and match (step, words_used, stems, statement)",
"type": "object"
}
},
"required": [
"contract",
"build_version",
"census_cleared",
"statement"
]
}🟢get_courseshelf_summary
What does CourseShelf hold? From the records published with the build, read as published and never computed: per catalog area, how many institutions have loaded content and how many records were loaded; every table's row count; organizations by sector; the census of the whole index with its verdicts; and per-state counts and per-school verdicts where the build publishes them. Anything not published for this build is said so.
输入模式
{
"type": "object",
"properties": {}
}🟢comparability_for_learning_unit(code, direction, learning_unit_id, limit, offset, ...)
Where does this course land at other schools, and what lands on it (exams included)? The published transfer rules for one course: the rules CourseShelf holds first (a school's own catalog, CourseAtlas), then CourseAtlas's direct rules read live. Each rule names its source authority, source_url and band; comparable, never equivalent. What lands on a course is answered from the held rules only.
输入模式
{
"type": "object",
"properties": {
"code": {
"description": "The course code as printed, e.g. HIST 201",
"type": "string"
},
"direction": {
"description": "lands_as: where it lands; lands_on: what lands on it; both (default)",
"enum": [
"lands_as",
"lands_on",
"both"
],
"type": "string"
},
"learning_unit_id": {
"description": "The course, by its learning unit id",
"type": "string"
},
"limit": {
"description": "Optional page size per list (default 10, at most 50)",
"type": "integer"
},
"offset": {
"description": "Optional: the offset of the next page",
"type": "integer"
},
"school": {
"description": "Or: the course's school, by name (with code or title)",
"type": "string"
},
"target_unitid": {
"description": "Optional: narrow where it lands to one receiving school (IPEDS UNITID)",
"type": "string"
},
"title": {
"description": "Or: the course title, matched exactly",
"type": "string"
},
"unitid": {
"description": "Or: the course's school, by IPEDS UNITID (with code or title)",
"type": "string"
}
}
}🟢find_transitions(class, from, from_soc, limit, offset, ...)
Where can this occupation lead? For a SOC code: destination occupations, each with its typed roads (published by O*NET or by a credential serving both; mapped through the CIP-SOC crosswalk), each road with its source, basis and its class's karat; the bridges (credentials with their exam, education and experience conditions, and programs with checklists nearest the state given); and demand as O*NET publishes it. Roads only, no person data.
输入模式
{
"type": "object",
"properties": {
"class": {
"description": "Optional: only destinations with a road of this class (published, mapped)",
"type": "string"
},
"from": {
"description": "Or the job in everyday words, e.g. welder; several matching occupations answer candidates to pick from",
"type": "string"
},
"from_soc": {
"description": "The occupation's SOC code, e.g. 51-4121 (an O*NET .00 code is accepted)",
"examples": [
"51-4121"
],
"type": "string"
},
"limit": {
"description": "Optional page size (default 10, at most 25)",
"type": "integer"
},
"offset": {
"description": "Optional: the next_offset from a previous answer",
"type": "integer"
},
"prefer": {
"description": "Optional preference such as less physical; answered not held when O*NET work context is not held",
"type": "string"
},
"state": {
"description": "Optional two-letter state for the program bridges",
"type": "string"
}
},
"anyOf": [
{
"required": [
"from_soc"
]
},
{
"required": [
"from"
]
}
]
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"facets": {
"type": "object"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"results": {
"description": "The destination cards",
"items": {
"properties": {
"bridges": {
"type": "object"
},
"demand": {
"type": "object"
},
"edges": {
"items": {
"properties": {
"basis": {
"type": "string"
},
"class": {
"type": "string"
},
"karat": {
"type": "string"
},
"source": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"title": {
"type": "string"
},
"to_soc": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"statement": {
"type": "string"
},
"total_matching": {
"type": "integer"
},
"understood": {
"type": "object"
}
},
"required": [
"contract",
"statement"
]
}🟢compare_destinations(from_soc, to_socs)
Line up 2 to 6 destination occupations side by side from one occupation: the bridge size (credential only, or the program bridges' awards as published), O*NET demand (median wage, outlook, bright outlook) and the evidence classes of the roads. Each cell is copied or counted, never scored.
输入模式
{
"type": "object",
"properties": {
"from_soc": {
"description": "The occupation compared from, e.g. 51-4121",
"examples": [
"51-4121"
],
"type": "string"
},
"to_socs": {
"description": "2 to 6 destination SOC codes, e.g. from find_transitions",
"examples": [
[
"51-4122",
"17-3029"
]
],
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"from_soc",
"to_socs"
]
}输出模式
{
"type": "object",
"properties": {
"columns": {
"type": "array"
},
"contract": {
"type": "string"
},
"rows": {
"items": {
"properties": {
"label": {
"type": "string"
},
"values": {
"type": "array"
}
},
"type": "object"
},
"type": "array"
},
"statement": {
"type": "string"
},
"understood": {
"type": "object"
}
},
"required": [
"contract",
"statement"
]
}🟢will_my_credits_transfer(checklist_id, held, target_unitid)
Will my prior credits apply as credit at my target school? For each thing a person holds (an AP, CLEP or IB exam and its score, or a course taken at a school) the target school's own published transfer rules (CourseAtlas) and CollegeBoard's reported AP policy, in three states: covered (a rule carries it to a course at the target), missing (the target's own rule needs a higher score), unknown (no rule held; never a guess). Each covered item names the course it lands as, every rule with its minimum score and dates, how many rules agree, and the target's programs whose checklists require that course. A case to argue, not a verdict; recognition is the school's act.
输入模式
{
"type": "object",
"properties": {
"checklist_id": {
"description": "Optional: the target program's checklist id; the answer then names the lines each covered item addresses",
"type": "string"
},
"held": {
"description": "1 to 20 things held: an exam { program: AP|CLEP|IB, exam: its code (e.g. AP 3700) or title (e.g. United States History), score }, or a course { unitid or school, code as printed (e.g. HIS 110) }",
"examples": [
[
{
"exam": "United States History",
"program": "AP",
"score": 3
}
]
],
"items": {
"type": "object"
},
"type": "array"
},
"target_unitid": {
"description": "The target school's IPEDS UNITID, e.g. 216038",
"examples": [
"216038"
],
"type": "string"
}
},
"required": [
"held",
"target_unitid"
]
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"counts": {
"description": "covered, missing, unknown",
"type": "object"
},
"items": {
"description": "One per held item: held, read_as, state (covered|missing|unknown), reason, lands_as (course, learning_unit_id, rules, corroboration, band, satisfies), statement",
"items": {
"type": "object"
},
"type": "array"
},
"limits": {
"description": "What this answer could not do, each { code, statement }",
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"statement": {
"type": "string"
},
"target": {
"type": "object"
},
"understood": {
"type": "object"
}
},
"required": [
"contract",
"statement"
]
}🟢assemble_my_formal_education(files, package)
Read a person's transcripts into their evidence package: each file's text and status, its courses and exams as rows, and the items will_my_credits_transfer takes (courses as { unitid or school, code }; AP, CLEP and IB exams with a score). Ask the person for each transcript and the school it came from. Several transcripts are read side by side. A school several schools' names fit is answered with the candidates, and nothing is read. Nothing is stored: the answer returns the package for the agent to keep.
输入模式
{
"type": "object",
"properties": {
"files": {
"description": "1 or more transcripts",
"items": {
"properties": {
"content_base64": {
"description": "The file's bytes, base64. A call's files total at most about 1.5 MB; send more over several calls with the same package.",
"type": "string"
},
"filename": {
"type": "string"
},
"school": {
"description": "The school the transcript came from, a name or initials (e.g. CNM); ask the person",
"type": "string"
},
"slot": {
"enum": [
"transcript"
],
"type": "string"
},
"unitid": {
"description": "Or the school's IPEDS UNITID, e.g. 187532",
"type": "string"
}
},
"required": [
"slot",
"filename",
"content_base64"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.",
"type": "object"
}
},
"required": [
"files"
]
}输出模式
{
"type": "object",
"properties": {
"candidates": {
"description": "When several schools fit a name: each file's candidates",
"type": "array"
},
"contract": {
"type": "string"
},
"counts": {
"description": "files, readable, courses, exams",
"type": "object"
},
"files": {
"description": "Each file read, with its extraction_status",
"type": "array"
},
"limits": {
"description": "What this answer could not do, each { code, statement }",
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The person's package, with this service's part filled",
"type": "object"
},
"statement": {
"type": "string"
}
},
"required": [
"contract",
"statement"
]
}🟢assemble_my_work_and_credentials(files, linkedin_url, package)
Read a person's resume, LinkedIn export, certificates, military records and apprenticeship records into their evidence package: each file's text and status, and the credential signals the certificate, military and apprenticeship documents carry. Ask the person for each file. This assembles; the Selfie is my_selfie_ksa_view. Nothing is stored: the answer returns the package for the agent to keep.
输入模式
{
"type": "object",
"properties": {
"files": {
"description": "1 or more files",
"items": {
"properties": {
"content_base64": {
"description": "The file's bytes, base64. A call's files total at most about 1.5 MB; send more over several calls with the same package.",
"type": "string"
},
"filename": {
"type": "string"
},
"slot": {
"enum": [
"resume",
"linkedin_file",
"certs",
"military",
"apprentice"
],
"type": "string"
}
},
"required": [
"slot",
"filename",
"content_base64"
],
"type": "object"
},
"type": "array"
},
"linkedin_url": {
"description": "Optional: the person's LinkedIn profile address",
"type": "string"
},
"package": {
"description": "The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.",
"type": "object"
}
},
"required": [
"files"
]
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"counts": {
"description": "files, readable, per_slot, credential_signals",
"type": "object"
},
"files": {
"description": "Each file read, with its extraction_status",
"type": "array"
},
"limits": {
"description": "What this answer could not do, each { code, statement }",
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The person's package, with this service's part filled",
"type": "object"
},
"statement": {
"type": "string"
}
},
"required": [
"contract",
"statement"
]
}🟢assert_my_life_experiences(entries, package)
Record what a person says they have done outside school and work (family, clubs, sports, faith, travel, self-taught projects, challenges) in their evidence package, each placed in a Selfie dimension by the KSA classifier or left unresolved, never defaulted. These are the person's own statements, kept apart from formal education. Nothing is stored: the answer returns the package for the agent to keep.
输入模式
{
"type": "object",
"properties": {
"entries": {
"description": "1 to 20 life experiences",
"items": {
"properties": {
"activity": {
"description": "What the person did, in their words",
"type": "string"
},
"category": {
"enum": [
"passions",
"sports",
"clubs",
"faith",
"family",
"selftaught",
"travel",
"challenges",
"other"
],
"type": "string"
},
"difficulty": {
"enum": [
"remember",
"understand",
"apply",
"analyze",
"evaluate",
"create"
],
"type": "string"
},
"elaboration": {
"type": "string"
},
"life_period": {
"enum": [
"childhood",
"adolescence",
"emerging_adult",
"early_adult",
"midlife",
"experienced",
"later_life"
],
"type": "string"
},
"weight": {
"enum": [
"occasional",
"regular",
"central"
],
"type": "string"
}
},
"required": [
"category",
"activity"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.",
"type": "object"
}
},
"required": [
"entries"
]
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"counts": {
"description": "entries, added, unresolved",
"type": "object"
},
"entries": {
"description": "Each entry with its dimension, placement, facets and placed_by",
"type": "array"
},
"limits": {
"description": "What this answer could not do, each { code, statement }",
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The person's package, with this service's part filled",
"type": "object"
},
"statement": {
"type": "string"
}
},
"required": [
"contract",
"statement"
]
}🟢my_selfie_ksa_view(aspiration, language, package)
The person's Selfie from their evidence package: the seven dimensions (skills, knowledge, abilities and more) as the evidence shows them, each item citing the file, the occupation O*NET describes, or the life experience it came from, plus what could not be placed. It mirrors, for the person to confirm, refine or reject; it is never a grade or a credit decision. The person's placements and dismissals in the package's selfie.learner_decisions are honored. Nothing is stored: the answer returns the package with the Selfie for the agent to keep.
输入模式
{
"type": "object",
"properties": {
"aspiration": {
"description": "Optional: what the person is aiming for",
"type": "string"
},
"language": {
"enum": [
"en",
"es",
"fr"
],
"type": "string"
},
"package": {
"description": "The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.",
"type": "object"
}
},
"required": [
"package"
]
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"evidence_by_source": {
"description": "Each dimension's items grouped by the file, occupation or life experience they came from",
"type": "array"
},
"evidence_truncated": {
"type": "array"
},
"limits": {
"description": "What this answer could not do, each { code, statement }",
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The person's package, with this service's part filled",
"type": "object"
},
"selfie": {
"description": "The seven dimensions in canon order, and learner_decisions",
"type": "object"
},
"statement": {
"type": "string"
},
"unresolved_items": {
"type": "array"
}
},
"required": [
"contract",
"statement"
]
}🟢draft_my_claims(aspiration, language, package, school)
Draft the credit claims a person's evidence supports, from their package (after my_selfie_ksa_view): each claim quotes the document it rests on. They are drafts for the person to keep, affirm or decline (set each claim's confidence to ratified, affirmed or declined in the package); the AI never affirms a claim. Give the school they are thinking of as `school` so its catalog is made ready for suggest_credit_for_my_learning. Nothing is stored: the answer returns the package for the agent to keep.
输入模式
{
"type": "object",
"properties": {
"aspiration": {
"description": "Optional: what the person is aiming for",
"type": "string"
},
"language": {
"enum": [
"en",
"es",
"fr"
],
"type": "string"
},
"package": {
"description": "The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.",
"type": "object"
},
"school": {
"description": "Optional: the school they are thinking of, a name or IPEDS UNITID; its catalog is made ready for the suggestions",
"type": "string"
}
},
"required": [
"package"
]
}输出模式
{
"type": "object",
"properties": {
"claims": {
"description": "The claims drafted by this call, each with summary, source_fragment, kind, evidence_tier, confidence (drafted) and recommendation_mode",
"type": "array"
},
"contract": {
"type": "string"
},
"counts": {
"description": "drafted, answered_kept",
"type": "object"
},
"limits": {
"description": "What this answer could not do, each { code, statement }",
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The person's package, with this service's part filled",
"type": "object"
},
"statement": {
"type": "string"
}
},
"required": [
"contract",
"statement"
]
}🟢suggest_credit_for_my_learning(aspiration, checklist_id, language, package, target_unitid)
Where is a person in the program they are aiming for, and what may their learning meet? Name the program with `checklist_id` (find it with find_programs at that school) and the answer is that program's checklist line by line: the lines their claims may meet, each with the claim, how well it is corroborated and every link cited; the lines a transfer answer in their package already covers; and the lines still needed. Learning no line matches stands as block credit. Without a program, no course is suggested and the claims stand as block credit. Each suggestion is a case to put to the school's prior learning review, never a promise: say may, never will. Nothing is stored: the answer returns the package with the suggestions for the agent to keep.
输入模式
{
"type": "object",
"properties": {
"aspiration": {
"description": "Optional: what the person is aiming for",
"type": "string"
},
"checklist_id": {
"description": "The program the person is aiming for, from find_programs or find_checklists at that school. Its lines are the only courses considered; without it no course is suggested.",
"examples": [
"CK_225070_05e6e123"
],
"type": "string"
},
"language": {
"enum": [
"en",
"es",
"fr"
],
"type": "string"
},
"package": {
"description": "The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.",
"type": "object"
},
"target_unitid": {
"description": "The school's IPEDS UNITID, e.g. 240620",
"examples": [
"240620"
],
"type": "string"
}
},
"required": [
"package",
"target_unitid"
]
}输出模式
{
"type": "object",
"properties": {
"contract": {
"type": "string"
},
"counts": {
"description": "claims, comparable_courses, block_credits, checklist_lines, may_be_met, already_covered, still_needed",
"type": "object"
},
"limits": {
"description": "What this answer could not do, each { code, statement }",
"type": "array"
},
"next_actions": {
"items": {
"properties": {
"arguments": {
"type": "object"
},
"label": {
"type": "string"
},
"tool": {
"description": "A GoldSeam service",
"type": "string"
}
},
"required": [
"label",
"tool",
"arguments"
],
"type": "object"
},
"type": "array"
},
"package": {
"description": "The person's package, with this service's part filled",
"type": "object"
},
"statement": {
"type": "string"
},
"suggestions": {
"description": "unitid, school, checklist_id, program, checklist (every line in its own order, each may_be_met with the claim, band and cited chain, already_covered, or still_needed), comparable_courses, block_credits, affirmed_not_pursued",
"type": "object"
}
},
"required": [
"contract",
"statement"
]
}社区
证据