MCP Server

goldseam

com.ksaworks/goldseam
Education Knowledge & Documentation Public & reachable MCP 2026-07-28

What this MCP does

Provides education and credential data covering institutions, programs, courses, certifications, transfer pathways, policies, and academic checklists.

assemble_my_formal_education
Assemble My Formal Education
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.
Read only
Input schema
{'type': 'object', 'required': ['files'], 'properties': {'files': {'type': 'array', 'items': {'type': 'object', 'required': ['slot', 'filename', 'content_base64'], 'properties': {'slot': {'enum': ['transcript'], 'type': 'string'}, 'school': {'type': 'string', 'description': 'The school the transcript came from, a name or initials (e.g. CNM); ask the person'}, 'unitid': {'type': 'string', 'description': "Or the school's IPEDS UNITID, e.g. 187532"}, 'filename': {'type': 'string'}, 'content_base64': {'type': 'string', '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."}}}, 'description': '1 or more transcripts'}, 'package': {'type': 'object', '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.'}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'files': {'type': 'array', 'description': 'Each file read, with its extraction_status'}, 'counts': {'type': 'object', 'description': 'files, readable, courses, exams'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'candidates': {'type': 'array', 'description': "When several schools fit a name: each file's candidates"}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
assemble_my_work_and_credentials
Assemble My Work and Credentials
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.
Read only
Input schema
{'type': 'object', 'required': ['files'], 'properties': {'files': {'type': 'array', 'items': {'type': 'object', 'required': ['slot', 'filename', 'content_base64'], 'properties': {'slot': {'enum': ['resume', 'linkedin_file', 'certs', 'military', 'apprentice'], 'type': 'string'}, 'filename': {'type': 'string'}, 'content_base64': {'type': 'string', '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."}}}, 'description': '1 or more files'}, 'package': {'type': 'object', '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.'}, 'linkedin_url': {'type': 'string', 'description': "Optional: the person's LinkedIn profile address"}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'files': {'type': 'array', 'description': 'Each file read, with its extraction_status'}, 'counts': {'type': 'object', 'description': 'files, readable, per_slot, credential_signals'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
assert_my_life_experiences
Assert My Life Experiences
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.
Read only
Input schema
{'type': 'object', 'required': ['entries'], 'properties': {'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['category', 'activity'], 'properties': {'weight': {'enum': ['occasional', 'regular', 'central'], 'type': 'string'}, 'activity': {'type': 'string', 'description': 'What the person did, in their words'}, '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'}}}, 'description': '1 to 20 life experiences'}, 'package': {'type': 'object', '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.'}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'counts': {'type': 'object', 'description': 'entries, added, unresolved'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'entries': {'type': 'array', 'description': 'Each entry with its dimension, placement, facets and placed_by'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
certifications_for_occupation
Certifications for Occupation
What certifications serve this occupation? SOC-keyed lookup (dashed SOC accepted with or without the O*NET .00 suffix).
Read only
Input schema
{'type': 'object', 'required': ['soc'], 'properties': {'soc': {'type': 'string', 'examples': ['29-1141', '47-2111'], '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"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
certifications_for_program
Certifications for Program
Broad academic cross-reference by instructional program (CIP). A deliberately broader, lower-precision question than an occupation lookup — never its peer (contract § 4).
Read only
Input schema
{'type': 'object', 'required': ['cip'], 'properties': {'cip': {'type': 'string', 'examples': ['51.3801', '47.0201'], 'description': 'A college program code (CIP), e.g. 51.3801 for Registered Nursing or 47.0201 for HVAC technology'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
checklists_requiring_learning_unit
Checklists Requiring Learning Unit
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.
Read only
Input schema
{'type': 'object', 'required': ['learning_unit_id'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'learning_unit_id': {'type': 'string', 'examples': ['LU_course_225070_ENGL1301_20262027'], 'description': 'A learning unit id from learning_units or get_learning_unit'}}}
comparability_for_learning_unit
Comparability for a Course
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.
Read only
Input schema
{'type': 'object', 'properties': {'code': {'type': 'string', 'description': 'The course code as printed, e.g. HIST 201'}, 'limit': {'type': 'integer', 'description': 'Optional page size per list (default 10, at most 50)'}, 'title': {'type': 'string', 'description': 'Or: the course title, matched exactly'}, 'offset': {'type': 'integer', 'description': 'Optional: the offset of the next page'}, 'school': {'type': 'string', 'description': "Or: the course's school, by name (with code or title)"}, 'unitid': {'type': 'string', 'description': "Or: the course's school, by IPEDS UNITID (with code or title)"}, 'direction': {'enum': ['lands_as', 'lands_on', 'both'], 'type': 'string', 'description': 'lands_as: where it lands; lands_on: what lands on it; both (default)'}, 'target_unitid': {'type': 'string', 'description': 'Optional: narrow where it lands to one receiving school (IPEDS UNITID)'}, 'learning_unit_id': {'type': 'string', 'description': 'The course, by its learning unit id'}}}
compare_destinations
Compare Destinations
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.
Read only
Input schema
{'type': 'object', 'required': ['from_soc', 'to_socs'], 'properties': {'to_socs': {'type': 'array', 'items': {'type': 'string'}, 'examples': [['51-4122', '17-3029']], 'description': '2 to 6 destination SOC codes, e.g. from find_transitions'}, 'from_soc': {'type': 'string', 'examples': ['51-4121'], 'description': 'The occupation compared from, e.g. 51-4121'}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'values': {'type': 'array'}}}}, 'columns': {'type': 'array'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}}}
compare_program_checklists
Compare Program Checklists
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.
Read only
Input schema
{'type': 'object', 'required': ['unitids', 'program'], 'properties': {'detail': {'type': 'string', 'examples': ['summary'], '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)"}, 'program': {'type': 'string', 'examples': ['Welding'], 'description': 'Program or award words to match, e.g. nursing or Bachelor of Science in Nursing'}, 'unitids': {'type': 'array', 'items': {'type': 'string'}, 'examples': [['225070']], 'description': '1 to 10 IPEDS UNITIDs, e.g. ["100663", "127060"]; answered 5 institutions per call, up to 3 checklists each'}, 'institution_offset': {'type': 'integer', 'description': 'Optional: the next_institution_offset from a previous answer, for the next 5 institutions'}}}
crosswalk_code
Crosswalk Code
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.
Read only
Input schema
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'examples': ['51.3801', '29-1141'], 'description': 'A college program code (CIP, e.g. 51.3801) or an occupation code (SOC, e.g. 29-1141)'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
draft_my_claims
Draft My Claims
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.
Read only
Input schema
{'type': 'object', 'required': ['package'], 'properties': {'school': {'type': 'string', 'description': 'Optional: the school they are thinking of, a name or IPEDS UNITID; its catalog is made ready for the suggestions'}, 'package': {'type': 'object', '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.'}, 'language': {'enum': ['en', 'es', 'fr'], 'type': 'string'}, 'aspiration': {'type': 'string', 'description': 'Optional: what the person is aiming for'}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'claims': {'type': 'array', 'description': 'The claims drafted by this call, each with summary, source_fragment, kind, evidence_tier, confidence (drafted) and recommendation_mode'}, 'counts': {'type': 'object', 'description': 'drafted, answered_kept'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
expand_term
Expand 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.
Read only
Input schema
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string', 'examples': ['carpentry', 'nursing'], 'description': 'A word to see what broader kind of thing it is, e.g. carpentry'}}}
find_agreements
Find Agreements
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.
Read only
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional agreement title words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "Optional: an institution party's IPEDS UNITID"}}}
find_catalogs
Find Catalogs
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.
Read only
Input schema
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "The institution's IPEDS UNITID, e.g. 225070"}}}
find_checklists
Find Checklists
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.
Read only
Input schema
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional award words, e.g. welding'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'examples': ['225070'], 'description': "The institution's IPEDS UNITID"}, 'program_id': {'type': 'string', 'description': "Optional: one program's id"}}}
find_comparability
Find Comparability
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.
Read only
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "Optional: the receiving institution's IPEDS UNITID"}, 'agreement_id': {'type': 'string', 'description': 'Optional: the agreement that states it'}, 'learning_unit_id': {'type': 'string', 'description': 'Optional: a course named in it'}}}
find_institution
Find Institution
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.
Read only
Input schema
{'type': 'object', 'properties': {'city': {'type': 'string', 'examples': ['Denison'], 'description': "Optional city, one of a state answer's cities, e.g. Denison"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'examples': ['Grayson', '225070'], 'description': 'Name fragment or IPEDS UNITID, e.g. Denver or 127060'}, 'state': {'type': 'string', 'examples': ['TX'], '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"}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
find_pathways
Find Pathways
Which pathways are held? Optional title words, an agreement id, or a checklist id. Answers none held when the build holds none.
Read only
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional pathway title words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'agreement_id': {'type': 'string', 'description': 'Optional: the agreement a pathway rests on'}, 'checklist_id': {'type': 'string', 'description': 'Optional: the checklist a pathway follows'}}}
find_policies
Find Policies
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.
Read only
Input schema
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional policy words, e.g. transfer'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "The institution's IPEDS UNITID, e.g. 225070"}}}
find_programs
Find Programs
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.
Read only
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'city': {'type': 'string', 'description': "Optional city: programs at that city's institutions"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'examples': ['Welding'], 'description': 'Program or award words, e.g. welding or nursing'}, 'state': {'type': 'string', 'description': "Optional two-letter state: programs at that state's institutions"}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "Optional: one institution's IPEDS UNITID"}}}
find_transfer_frameworks
Find Transfer Frameworks
Which statewide or compact transfer frameworks are held? Optional name or jurisdiction words. Answers none held when the build holds none.
Read only
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional framework name or jurisdiction words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
find_transitions
Find Transitions
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.
Read only
Input schema
{'type': 'object', 'anyOf': [{'required': ['from_soc']}, {'required': ['from']}], 'properties': {'from': {'type': 'string', 'description': 'Or the job in everyday words, e.g. welder; several matching occupations answer candidates to pick from'}, 'class': {'type': 'string', 'description': 'Optional: only destinations with a road of this class (published, mapped)'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 10, at most 25)'}, 'state': {'type': 'string', 'description': 'Optional two-letter state for the program bridges'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'prefer': {'type': 'string', 'description': 'Optional preference such as less physical; answered not held when O*NET work context is not held'}, 'from_soc': {'type': 'string', 'examples': ['51-4121'], 'description': "The occupation's SOC code, e.g. 51-4121 (an O*NET .00 code is accepted)"}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'facets': {'type': 'object'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'edges': {'type': 'array', 'items': {'type': 'object', 'properties': {'basis': {'type': 'string'}, 'class': {'type': 'string'}, 'karat': {'type': 'string'}, 'source': {'type': 'string'}}}}, 'title': {'type': 'string'}, 'demand': {'type': 'object'}, 'to_soc': {'type': 'string'}, 'bridges': {'type': 'object'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}, 'description': 'The destination cards'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'total_matching': {'type': 'integer'}}}
get_agreement
Get Agreement
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.
Read only
Input schema
{'type': 'object', 'required': ['agreement_id'], 'properties': {'agreement_id': {'type': 'string', 'description': 'An agreement id from find_agreements'}}}
get_catalog
Get Catalog
One catalog edition: its row, the institutions that use it (and whom it is shared from), and how many programs it holds.
Read only
Input schema
{'type': 'object', 'required': ['catalog_id'], 'properties': {'catalog_id': {'type': 'string', 'description': 'A catalog id from find_catalogs'}}}
get_certification
Get Certification
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.
Read only
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'examples': ['LU_CERT_ONET_13108200_8F3480AC7A'], 'description': "A certification id, copied from a search result's id field"}}}
get_checklist
Get Checklist
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.
Read only
Input schema
{'type': 'object', 'required': ['checklist_id'], 'properties': {'item_limit': {'type': 'integer', 'description': 'Optional items per page (default 60, at most 150)'}, 'item_offset': {'type': 'integer', 'description': 'Optional: the next_item_offset from a previous answer'}, 'checklist_id': {'type': 'string', 'examples': ['CK_225070_05e6e123'], 'description': 'A checklist id from programs_for_institution or compare_program_checklists'}}}
get_comparability
Get Comparability
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.
Read only
Input schema
{'type': 'object', 'required': ['comparability_id'], 'properties': {'comparability_id': {'type': 'string', 'description': 'A comparability id from find_comparability'}}}
get_courseshelf_summary
CourseShelf Holdings 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.
Read only
Input schema
{'type': 'object', 'properties': {}}
get_dictionary_summary
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.
Read only
Input schema
{'type': 'object', 'properties': {}}
get_institution
Get Institution
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.
Read only
Input schema
{'type': 'object', 'anyOf': [{'required': ['organization_id']}, {'required': ['unitid']}], 'properties': {'unitid': {'type': 'string', 'description': 'Or its IPEDS UNITID instead, e.g. 225070'}, 'organization_id': {'type': 'string', 'examples': ['ORG_225070'], 'description': "The institution's organization id from find_institution, e.g. ORG_225070"}}}
get_learning_unit
Get Learning Unit
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.
Read only
Input schema
{'type': 'object', 'required': ['learning_unit_id'], 'properties': {'learning_unit_id': {'type': 'string', 'examples': ['LU_course_225070_ENGL1301_20262027'], 'description': 'A learning unit id from learning_units or get_checklist'}}}
get_pathway
Get Pathway
One pathway: its row and the checklist and agreement it links. Contacts name people and are not served.
Read only
Input schema
{'type': 'object', 'required': ['pathway_id'], 'properties': {'pathway_id': {'type': 'string', 'description': 'A pathway id from find_pathways'}}}
get_policy
Get Policy
One published academic policy: its section, verbatim text, page, edition and source.
Read only
Input schema
{'type': 'object', 'required': ['policy_id'], 'properties': {'policy_id': {'type': 'string', 'description': 'A policy id from find_policies'}}}
get_program
Get Program
One program whole: its row, identifiers, offerings (campus resolved), its institution, and the checklists that lead to its award — pass one to get_checklist.
Read only
Input schema
{'type': 'object', 'required': ['program_id'], 'properties': {'program_id': {'type': 'string', 'examples': ['PG_225070_8c96bb26'], 'description': 'A program id from programs_for_institution or find_programs'}}}
get_transfer_framework
Get Transfer Framework
One transfer framework: its row, authority, codes with their meanings, and the courses mapped to it (resolved).
Read only
Input schema
{'type': 'object', 'required': ['framework_id'], 'properties': {'framework_id': {'type': 'string', 'description': 'A framework id from find_transfer_frameworks'}}}
learning_units
Learning Units
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.
Read only
Input schema
{'type': 'object', 'required': ['unitid'], 'properties': {'code': {'type': 'string', 'description': 'Optional course code, e.g. BIO 201'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 50, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional title words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'examples': ['225070'], 'description': "The institution's IPEDS UNITID"}, 'subject': {'type': 'string', 'examples': ['RNSG'], 'description': 'Optional subject abbreviation, e.g. BIO'}, 'unit_type': {'type': 'string', 'description': "Optional learning-unit type, one of the answer's unit_types, e.g. course"}}}
list_issuers
List Issuers
The issuing organizations, optionally filtered by a name query.
Read only
Input schema
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'query': {'type': 'string', 'examples': ['IBM', 'nursing'], 'description': "Optional: part of an organization's name"}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
my_selfie_ksa_view
My Selfie (KSA View)
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.
Read only
Input schema
{'type': 'object', 'required': ['package'], 'properties': {'package': {'type': 'object', '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.'}, 'language': {'enum': ['en', 'es', 'fr'], 'type': 'string'}, 'aspiration': {'type': 'string', 'description': 'Optional: what the person is aiming for'}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'selfie': {'type': 'object', 'description': 'The seven dimensions in canon order, and learner_decisions'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'unresolved_items': {'type': 'array'}, 'evidence_by_source': {'type': 'array', 'description': "Each dimension's items grouped by the file, occupation or life experience they came from"}, 'evidence_truncated': {'type': 'array'}}}
occupations_for_certification
Occupations for Certification
What occupations does this certification serve?
Read only
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'examples': ['LU_CERT_ONET_13108200_8F3480AC7A'], 'description': "A certification id, copied from a search result's id field"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
programs_for_institution
Programs for Institution
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.
Read only
Input schema
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 100, at most 200)'}, 'query': {'type': 'string', 'description': 'Optional program or award words to filter by'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'examples': ['225070'], 'description': "The institution's IPEDS UNITID"}}}
related_certifications
Related Certifications
What else serves the same occupation? Traverses on SOC only — a certification sharing solely an instructional program (CIP) is not related (contract § 4).
Read only
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'examples': ['LU_CERT_ONET_29114100_50CD2891D4'], 'description': "A certification id to find others like it, copied from a search result's id field"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
resolve_term
Resolve 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.
Read only
Input schema
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string', 'examples': ['carpentry', 'mathematics', 'welding'], 'description': 'A word for something a person knows or can do, e.g. carpentry or mathematics'}}}
search_certifications
Search Certifications
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.
Read only
Input schema
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'query': {'type': 'string', 'examples': ['nursing', 'HVAC', 'welding', 'IBM', 'project management'], 'description': 'What you are looking for, in everyday words — a trade, field, job, or company'}, 'issuer': {'type': 'string', 'description': 'Optional: only certifications from this organization'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
Output schema
{'type': 'object', 'required': ['contract'], 'properties': {'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'portal_url': {'type': 'string', 'description': 'The same search on the portal'}, 'understood': {'type': 'object', 'description': 'What was read: words, issuer, and match (step, matched_terms, statement)'}, 'next_offset': {'type': 'integer'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'certifications': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}, 'description': 'The certification cards'}, 'total_matching': {'type': 'integer'}}}
search_programs_and_learning_units
Search Programs and Learning Units
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.
Read only
Input schema
{'type': 'object', 'properties': {'cip': {'description': 'Optional: programs with this six-digit CIP code (e.g. 48.0508), a comma-separated list, or an array of codes'}, 'city': {'type': 'string', 'description': "Optional city, one of a state answer's cities"}, 'code': {'type': 'string', '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': {'type': 'string', 'examples': ['program'], 'description': 'program (the default) or learning_unit'}, 'award': {'type': 'string', 'examples': ['Certificate'], 'description': "Optional award exactly as published, one of the answer's awards"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 10, at most 50)'}, 'place': {'type': 'string', 'description': 'Optional: a place the question names, read as a state (name or code), a city, or a school, e.g. Wyoming or Casper'}, 'query': {'type': 'string', 'examples': ['nursing'], 'description': "Words: a program's name or award, or a course's title"}, 'state': {'type': 'string', 'examples': ['TX'], 'description': 'Optional two-letter state'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'sector': {'type': 'string', 'description': 'Optional school type as IPEDS labels it, e.g. public 2-year'}, 'unitid': {'type': 'string', 'description': "Optional: one school's IPEDS UNITID"}, 'subject': {'type': 'string', 'description': 'Optional CIP family (two digits, e.g. 51) or unknown'}, 'credential': {'type': 'string', 'description': "Optional, programs only: a credential class, one of the answer's credential values (e.g. ceterms:AssociateDegree), or none"}, 'subject_code': {'type': 'string', '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"}}}
Output schema
{'type': 'object', 'required': ['contract', 'build_version', 'census_cleared', 'statement'], 'properties': {'facets': {'type': 'object', 'description': "The refinements: each facet's values with their counts of held rows"}, 'publish': {'type': 'integer', 'description': "The data road's publish number"}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string', 'description': 'program or learning_unit'}, 'award': {'description': 'The award as published, or null'}, 'school': {'type': 'object', 'description': 'name, city, state, sector, ipeds_unit_id'}, 'college': {'type': 'string', 'description': 'The college within the school that offers the program, when held'}, 'subject': {'type': 'object', 'description': 'cip_code, family, family_title, cip_source; absent when the program holds no CIP'}, 'leads_to': {'type': 'object', 'description': 'occupations through the CIP-SOC crosswalk; absent when none is held'}, 'checklist': {'description': 'checklist_id, requirements, credits_computed; or null'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'normal_length': {'type': 'string', 'description': "A program's normal length as published, when held"}, 'credits_published': {'type': 'string', 'description': "A course's credits as printed, when held"}, 'description_excerpt': {'type': 'string', 'description': "A course description's first 200 characters, with an ellipsis when longer; the full text is on get_learning_unit"}}}, 'description': 'The product cards'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'portal_url': {'type': 'string', 'description': 'The same view on the portal'}, 'understood': {'type': 'object', '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)'}, 'next_offset': {'type': 'integer'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'build_version': {'type': 'integer', 'description': 'Deprecated: the same value as publish'}, 'census_cleared': {'type': 'boolean'}, 'total_matching': {'type': 'integer'}, 'schools_matching': {'type': 'integer', 'description': 'How many schools hold the matching set'}}}
suggest_credit_for_my_learning
Suggest Credit For My Learning
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.
Read only
Input schema
{'type': 'object', 'required': ['package', 'target_unitid'], 'properties': {'package': {'type': 'object', '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.'}, 'language': {'enum': ['en', 'es', 'fr'], 'type': 'string'}, 'aspiration': {'type': 'string', 'description': 'Optional: what the person is aiming for'}, 'checklist_id': {'type': 'string', 'examples': ['CK_225070_05e6e123'], '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.'}, 'target_unitid': {'type': 'string', 'examples': ['240620'], 'description': "The school's IPEDS UNITID, e.g. 240620"}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'counts': {'type': 'object', 'description': 'claims, comparable_courses, block_credits, checklist_lines, may_be_met, already_covered, still_needed'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'suggestions': {'type': 'object', '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'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
will_my_credits_transfer
Will My Credits Transfer
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.
Read only
Input schema
{'type': 'object', 'required': ['held', 'target_unitid'], 'properties': {'held': {'type': 'array', 'items': {'type': 'object'}, 'examples': [[{'exam': 'United States History', 'score': 3, 'program': 'AP'}]], '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) }'}, 'checklist_id': {'type': 'string', 'description': "Optional: the target program's checklist id; the answer then names the lines each covered item addresses"}, 'target_unitid': {'type': 'string', 'examples': ['216038'], 'description': "The target school's IPEDS UNITID, e.g. 216038"}}}
Output schema
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}, 'description': 'One per held item: held, read_as, state (covered|missing|unknown), reason, lands_as (course, learning_unit_id, rules, corroboration, band, satisfies), statement'}, 'counts': {'type': 'object', 'description': 'covered, missing, unknown'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'target': {'type': 'object'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
Added
suggest_credit_for_my_learning
Sept. 25, 2026, 3:02 a.m.
Added
draft_my_claims
Sept. 25, 2026, 3:02 a.m.
Changed
my_selfie_ksa_view
Sept. 25, 2026, 3:02 a.m.
Changed
assert_my_life_experiences
Sept. 25, 2026, 3:02 a.m.
Changed
assemble_my_work_and_credentials
Sept. 25, 2026, 3:02 a.m.
Changed
assemble_my_formal_education
Sept. 25, 2026, 3:02 a.m.
Changed
will_my_credits_transfer
Sept. 25, 2026, 3:02 a.m.
Changed
compare_destinations
Sept. 25, 2026, 3:02 a.m.
Changed
find_transitions
Sept. 25, 2026, 3:02 a.m.
Added
get_dictionary_summary
Sept. 25, 2026, 3:02 a.m.
Added
my_selfie_ksa_view
Sept. 23, 2026, 2:53 a.m.
Added
assert_my_life_experiences
Sept. 23, 2026, 2:53 a.m.
Added
assemble_my_work_and_credentials
Sept. 23, 2026, 2:53 a.m.
Added
assemble_my_formal_education
Sept. 23, 2026, 2:53 a.m.
Added
comparability_for_learning_unit
Sept. 21, 2026, 3 a.m.
Added
will_my_credits_transfer
Sept. 17, 2026, 12:35 p.m.
Added
compare_destinations
Sept. 17, 2026, 12:35 p.m.
Added
find_transitions
Sept. 17, 2026, 12:35 p.m.
Added
get_courseshelf_summary
Sept. 17, 2026, 12:35 p.m.
Added
search_programs_and_learning_units
Sept. 17, 2026, 12:35 p.m.
Added
checklists_requiring_learning_unit
Sept. 17, 2026, 12:35 p.m.
Added
get_transfer_framework
Sept. 17, 2026, 12:35 p.m.
Added
find_transfer_frameworks
Sept. 17, 2026, 12:35 p.m.
Added
get_comparability
Sept. 17, 2026, 12:35 p.m.
Added
find_comparability
Sept. 17, 2026, 12:35 p.m.
Added
get_pathway
Sept. 17, 2026, 12:35 p.m.
Added
find_pathways
Sept. 17, 2026, 12:35 p.m.
Added
get_agreement
Sept. 17, 2026, 12:35 p.m.
Added
find_agreements
Sept. 17, 2026, 12:35 p.m.
Added
find_checklists
Sept. 17, 2026, 12:35 p.m.