CoreModels is an MCP server published by io.coremodels, hosted at go.coremodels.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 37 tools, including export_avro, analyze_concept_impact, audit_vendor_project, generate_vendor_artifacts, get_vendor_integration_status.
Model, map and validate data schemas. Export JSON Schema, JSON-LD, LinkML, OWL, ShEx, SQL, Avro.
2 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Export project data as an Avro (.avsc JSON) schema string.
| Parameter | Type | Description |
|---|---|---|
| nodeIds | array | Optional type node ids to export; omit to export all types (optionally scoped to a space). |
| spaceId | string | |
| graphProjectId * | string |
{
"name": "export_avro",
"title": "Export Avro",
"description": "Export project data as an Avro (.avsc JSON) schema string.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"nodeIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space)."
},
"spaceId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export Avro",
"readOnlyHint": true,
"openWorldHint": false
}
}Answers 'what is affected if this concept changes?' for a governed type, element or controlled vocabulary. Returns: where it is used inside the model (blast radius), which vendor estates carry it and by what path, which external standards it is bound to, and which serializations it can be exported as. Read-only — nothing is modified. Useful before editing a vocabulary term or a column's meaning.
| Parameter | Type | Description |
|---|---|---|
| spaces | array | |
| concept * | string | The governed type, element or taxonomy — by node id, or by label (case-insensitive), e.g. 'order status values' or 'status'. |
| graphProjectId * | string |
{
"name": "analyze_concept_impact",
"title": "Analyze Concept Impact",
"description": "Answers 'what is affected if this concept changes?' for a governed type, element or controlled vocabulary. Returns: where it is used inside the model (blast radius), which vendor estates carry it and by what path, which external standards it is bound to, and which serializations it can be exported as. Read-only — nothing is modified. Useful before editing a vocabulary term or a column's meaning.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"concept"
],
"properties": {
"spaces": {
"type": "array",
"items": {
"type": "string"
}
},
"concept": {
"type": "string",
"description": "The governed type, element or taxonomy — by node id, or by label (case-insensitive), e.g. 'order status values' or 'status'."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Analyze Concept Impact",
"readOnlyHint": true,
"openWorldHint": false
}
}Audits vendor artifacts (e.g. a dbt manifest) against the governed CoreModels graph — read-only. Reports coverage (what is/isn't governed, canonical-mapping coverage), drift (fields added/removed/retyped, enum changes, contract flips), and conformance (vendor best-practice rules). errorCount > 0 is the CI-gate fail signal; 'markdown' holds the human-readable report.
| Parameter | Type | Description |
|---|---|---|
| spaces | array | Optional target space ids. |
| vendor * | string | Vendor connector key, e.g. 'dbt'. |
| artifacts | object | Artifact name -> raw content. dbt: manifest (required), catalog, semantic_manifest. |
| artifactUrls | object | Artifact name -> URL to fetch it from (for payloads too large to inline). |
| graphProjectId * | string |
{
"name": "audit_vendor_project",
"title": "Audit Vendor Project",
"description": "Audits vendor artifacts (e.g. a dbt manifest) against the governed CoreModels graph — read-only. Reports coverage (what is/isn't governed, canonical-mapping coverage), drift (fields added/removed/retyped, enum changes, contract flips), and conformance (vendor best-practice rules). errorCount > 0 is the CI-gate fail signal; 'markdown' holds the human-readable report.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"vendor"
],
"properties": {
"spaces": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional target space ids."
},
"vendor": {
"type": "string",
"description": "Vendor connector key, e.g. 'dbt'."
},
"artifacts": {
"type": "object",
"description": "Artifact name -> raw content. dbt: manifest (required), catalog, semantic_manifest.",
"additionalProperties": {
"type": "string"
}
},
"artifactUrls": {
"type": "object",
"description": "Artifact name -> URL to fetch it from (for payloads too large to inline).",
"additionalProperties": {
"type": "string",
"format": "url"
}
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Audit Vendor Project",
"readOnlyHint": true,
"openWorldHint": true
}
}Generates vendor artifacts from the governed CoreModels graph. For dbt: a schema.yml with enforced model contracts — column data types, not_null/unique constraints and tests, accepted_values tests from governed taxonomies, relationships tests from governed references. SMEs change meaning once in CoreModels; engineers get a reviewed contract diff.
| Parameter | Type | Description |
|---|---|---|
| layout | string | dbt file layout: 'model' (default) one property file per model colocated with its .sql; 'folder' one file per model directory; 'single' one repo-wide file. |
| spaces | array | |
| vendor * | string | Vendor connector key, e.g. 'dbt'. |
| typeNames | array | Restrict generation to these model/type names (empty = everything eligible). |
| targetVersion | string | Vendor dialect/version. dbt: default emits data_tests: (>=1.8); '1.7' emits legacy tests:. |
| graphProjectId * | string | |
| iriInDescription | boolean | dbt: also append bound ontology IRIs to the column description so persist_docs carries them into the warehouse column comment. Default true; they always ride in meta regardless. |
Lists the registered vendor connectors (dbt, ...) with capabilities and expected artifacts, and — when 'vendor' is given — the project's last-import state for that vendor (when, tool version, artifact versions, fingerprint, counts, governed dataset count).
| Parameter | Type | Description |
|---|---|---|
| spaces | array | |
| vendor | string | Omit to list all registered vendor connectors. |
| graphProjectId * | string |
{
"name": "get_vendor_integration_status",
"title": "Vendor Integration Status",
"description": "Lists the registered vendor connectors (dbt, ...) with capabilities and expected artifacts, and — when 'vendor' is given — the project's last-import state for that vendor (when, tool version, artifact versions, fingerprint, counts, governed dataset count).",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"spaces": {
"type": "array",
"items": {
"type": "string"
}
},
"vendor": {
"type": "string",
"description": "Omit to list all registered vendor connectors."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Vendor Integration Status",
"readOnlyHint": true,
"openWorldHint": false
}
}Export project data in JSON-LD format using a configured export profile. Use `fetch_json_ld_import_profiles` first to discover the configTypeId. At least one of exportTypes/exportElements/exportTaxonomies/exportDataTypes must be true. Tree-based mode (graphBased=false) requires exactly one nodeId; graph-based mode allows multiple or none.
| Parameter | Type | Description |
|---|---|---|
| nodeIds | array | For tree-based export, exactly one root node id; for graph-based, optional |
| spaceId | string | Optional space id to filter export data; empty = all spaces |
| graphBased | boolean | true = graph-based (no root); false = tree-based (requires exactly one nodeId) |
| exportTypes | boolean | |
| configTypeId * | string | JSON-LD export profile id (from fetch_json_ld_import_profiles) |
| includeSpace | boolean | |
| exportElements | boolean | |
| graphProjectId * | string | |
| useDefaultType | boolean | |
| exportDataTypes |
Fetch JSON-LD import/export profiles available for a project (id and label each). Pass configTypeId to read that one profile's field mapping instead: every JSON-LD key it knows and what the key imports as - importAs is mixin (target = mixin column id), relation (target = relation group id), newMixin/newRelation (created on import), space, or none (ignored). targetLabel names the mixin column or relation group; isReversed marks a relation read in the opposite direction.
| Parameter | Type | Description |
|---|---|---|
| configTypeId | string | Optional. A profile id from this tool's list; returns that profile's field mapping. |
| graphProjectId * | string |
{
"name": "fetch_json_ld_import_profiles",
"title": "Fetch JSON-LD Import Profiles",
"description": "Fetch JSON-LD import/export profiles available for a project (id and label each).\nPass configTypeId to read that one profile's field mapping instead: every JSON-LD key it knows and what the key imports as - importAs is mixin (target = mixin column id), relation (target = relation group id), newMixin/newRelation (created on import), space, or none (ignored). targetLabel names the mixin column or relation group; isReversed marks a relation read in the opposite direction.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"configTypeId": {
"type": "string",
"description": "Optional. A profile id from this tool's list; returns that profile's field mapping."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
}
},
"annotations": {
"title": "Fetch JSON-LD Import Profiles",
"readOnlyHint": true,
"openWorldHint": false
}
}Export project data as a JSON Schema string.
| Parameter | Type | Description |
|---|---|---|
| spaceId | string | |
| rootNodeId | string | Root node id (a Type). Optional only when the project has one Type or one node carries the Root Id mixin; with several Types it is required, and a call without it is refused with the list of Types. |
| configTypeId | string | Export profile id used for the JSON Schema export. |
| graphProjectId * | string | |
| inheritanceHandler | string | How Inheritance relations are emitted: None ignores them, IncludeInProperties flattens inherited elements into the child's properties, IncludeAsRef emits the parent under $defs and references it. |
| inheritenceHandler | string | Deprecated misspelling of 'inheritanceHandler', kept for existing callers. Use 'inheritanceHandler'; passing both with different values is an error. |
{
"name": "export_jsonschema",
"title": "Export JSON Schema",
"description": "Export project data as a JSON Schema string.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"spaceId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"rootNodeId": {
"type": "string",
"description": "Root node id (a Type). Optional only when the project has one Type or one node carries the Root Id mixin; with several Types it is required, and a call without it is refused with the list of Types."
},
"configTypeId": {
"type": "string",
"description": "Export profile id used for the JSON Schema export."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"inheritanceHandler": {
"enum": [
"None",
"IncludeInProperties",
"IncludeAsRef"
],
"type": "string",
"default": "None",
"description": "How Inheritance relations are emitted: None ignores them, IncludeInProperties flattens inherited elements into the child's properties, IncludeAsRef emits the parent under $defs and references it."
},
"inheritenceHandler": {
"enum": [
"None",
"IncludeInProperties",
"IncludeAsRef"
],
"type": "string",
"description": "Deprecated misspelling of 'inheritanceHandler', kept for existing callers. Use 'inheritanceHandler'; passing both with different values is an error."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export JSON Schema",
"readOnlyHint": true,
"openWorldHint": false
}
}Fetch JSON Schema import/export profiles available for a project (id and label each). Pass configTypeId to read that one profile's field mapping instead: every JSON Schema keyword it knows and what the keyword imports as - importAs is mixin (target = mixin column id), relation (target = relation group id), newMixin/newRelation (created on import), space, or none (ignored). targetLabel names the mixin column or relation group; isSpecialKey marks a structural JSON Schema keyword (properties, items, $ref, ...).
| Parameter | Type | Description |
|---|---|---|
| configTypeId | string | Optional. A profile id from this tool's list; returns that profile's field mapping. |
| graphProjectId * | string |
{
"name": "fetch_json_schema_import_profiles",
"title": "Fetch JSON Schema Import Profiles",
"description": "Fetch JSON Schema import/export profiles available for a project (id and label each).\nPass configTypeId to read that one profile's field mapping instead: every JSON Schema keyword it knows and what the keyword imports as - importAs is mixin (target = mixin column id), relation (target = relation group id), newMixin/newRelation (created on import), space, or none (ignored). targetLabel names the mixin column or relation group; isSpecialKey marks a structural JSON Schema keyword (properties, items, $ref, ...).",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"configTypeId": {
"type": "string",
"description": "Optional. A profile id from this tool's list; returns that profile's field mapping."
},
"graphProjectId": {
"type": "string"
}
}
},
"annotations": {
"title": "Fetch JSON Schema Import Profiles",
"readOnlyHint": true,
"openWorldHint": false
}
}Validate one or more JSON documents against a project's stored JSON Schema. The schema is regenerated from the project using the supplied configTypeId (the export profile id) and rootNodeId, then reused for every document - so validating a batch costs barely more than validating one. Pass up to 100 documents per call and chunk anything larger. Response: - isValid: true only when EVERY document passed. - total, validCount: counts over the whole batch. - invalid: one entry per failing document, as {index, errors}. Only failures are listed - any index not present passed. index is the 0-based position in the jsonStrings array you sent. - A document that is not parseable JSON fails in its own slot; it does not abort the rest of the batch. Set explain=true to add a plain-English "- Explanation:" line to every error, describing what is wrong, where, and how to fix it. The raw structured lines are unchanged either way - use it when a person will read the result, leave it off for machine parsing.
| Parameter | Type | Description |
|---|---|---|
| explain | boolean | Add a plain-English explanation to each error alongside the raw structured fields. Use when a person will read the output. |
| spaceId | string | Optional space id to scope the schema |
| rootNodeId * | string | Node id used as the root when generating the JSON Schema |
| jsonStrings * | array | The JSON documents to validate, each serialized as a string. Results reference documents by their 0-based position in this array. |
| configTypeId | string | Profile id used to map mixins/relations to schema keywords |
| graphProjectId |
Export project data as a LinkML (YAML) schema string.
| Parameter | Type | Description |
|---|---|---|
| nodeIds | array | Optional type node ids to export; omit to export all types (optionally scoped to a space). |
| spaceId | string | |
| graphProjectId * | string |
{
"name": "export_linkml",
"title": "Export LinkML",
"description": "Export project data as a LinkML (YAML) schema string.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"nodeIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space)."
},
"spaceId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export LinkML",
"readOnlyHint": true,
"openWorldHint": false
}
}Check whether a relation would be admissible before writing it. Reads the SAME relation-group rule table create_relation and bulk_create validate against, so the answer matches what a write would do. Pass relationGroupId plus fromNodeId and toNodeId — both must already exist in the project. Returns admissible, the rule (relation group label) it was checked against, a reason when refused (naming the allowed direction), and alternative relation groups that do admit this node-type pair. Mixin form: instead of the relation arguments, pass mixinId, targetNodeId and mixinColumns (the same items bulk_create takes under mixins; id = column ID, label = value). The answer comes from the same dry-run checks bulk_create runs for mixin values, with nothing written: admissible, and the reason when refused. Do not pass both forms in one call.
| Parameter | Type | Description |
|---|---|---|
| mixinId | string | |
| toNodeId | string | |
| fromNodeId | string | |
| mixinColumns | array | id = column ID, label = value. |
| targetNodeId | string | |
| graphProjectId * | string | |
| relationGroupId | string |
List the discussion (comments and replies) of a CoreModels project — the same threads users see in the app's grid collaboration panel. Viewer access is required. Comments are anchored by tag sets: a comment left on a grid cell carries that cell's tag ids (node/element/relation ids, sometimes a section label) plus the project id. Omit anchorIds to list the whole project's discussion; pass anchorIds to return only comments anchored to exactly that tag set (the project id is implied — never include it). Returns { comments, total, returned, truncated }. comments are top-level threads, newest first, each with its replies nested oldest first; every entry has { id, createdBy, createdByName, message, anchorIds, mentionUserIds, parentId, isResolved, createdDate }. Reply to a thread or leave a new one with add_comment (admin endpoint).
| Parameter | Type | Description |
|---|---|---|
| anchorIds | array | Optional cell anchor: return only comments whose anchor tag set equals exactly this set. Do not include the project id. |
| maxResults | integer | Cap on returned top-level threads (newest first); truncated=true when more matched. |
| textContains | string | Optional text filter, matched in comments and replies. |
| graphProjectId * | string | Id of the project whose discussion to read. Viewer access is required. |
| includeReplies | boolean | Nest each thread's replies in the response. |
| includeResolved | boolean | Also return resolved (closed) threads. |
Get the status of a background job in a project, e.g. the copy started by copy_project or a background import_owl. Returns { jobDetailsId, projectId, type, status, createdAt, lastUpdatedAt } where status is "inProgress", "success" or "failed". Result-bearing jobs (background import_owl) additionally return a 'result' field on success — for OWL imports it carries the type/element/taxonomy counts and the aggregated lossiness. Poll until status is no longer "inProgress"; leave a few seconds between polls.
| Parameter | Type | Description |
|---|---|---|
| jobDetailsId * | string | The jobDetailsId returned by the tool that started the job. |
| graphProjectId * | string | Id of the project the job belongs to. For copy_project this is the returned (destination) projectId. |
{
"name": "get_job_status",
"title": "Get Job Status",
"description": "Get the status of a background job in a project, e.g. the copy started by copy_project or a background import_owl. Returns { jobDetailsId, projectId, type, status, createdAt, lastUpdatedAt } where status is \"inProgress\", \"success\" or \"failed\". Result-bearing jobs (background import_owl) additionally return a 'result' field on success — for OWL imports it carries the type/element/taxonomy counts and the aggregated lossiness. Poll until status is no longer \"inProgress\"; leave a few seconds between polls.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"jobDetailsId"
],
"properties": {
"jobDetailsId": {
"type": "string",
"minLength": 1,
"description": "The jobDetailsId returned by the tool that started the job."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "Id of the project the job belongs to. For copy_project this is the returned (destination) projectId."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Job Status",
"readOnlyHint": true,
"openWorldHint": false
}
}Get the project schema: all mixin definitions and all relation-group definitions. Use this once at the start of a session to discover the IDs needed by other tools (mixinId, columnId, relationGroupId). Returns compact positional arrays - see the "format" field for the layout. Read get_modeling_guide before your first write - it explains what each relation group means and which direction it runs.
| Parameter | Type | Description |
|---|---|---|
| graphProjectId * | string |
{
"name": "get_mixins_and_relation_groups",
"title": "Get Mixins & Relation Groups",
"description": "Get the project schema: all mixin definitions and all relation-group definitions.\n\nUse this once at the start of a session to discover the IDs needed by other tools (mixinId, columnId, relationGroupId). Returns compact positional arrays - see the \"format\" field for the layout.\n\nRead get_modeling_guide before your first write - it explains what each relation group means and which direction it runs.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Mixins & Relation Groups",
"readOnlyHint": true,
"openWorldHint": false
}
}Returns the CoreModels modeling guide (markdown): how to import vs build, what each relation group means and which direction it runs (Domain Includes, Range Includes, Controlled List, Has List Item, Inheritance, Derived From), bulk_create conventions, and how to verify your work. Read it once before your first write in a session.
No parameters.
{
"name": "get_modeling_guide",
"title": "Get Modeling Guide",
"description": "Returns the CoreModels modeling guide (markdown): how to import vs build, what each relation group means and which direction it runs (Domain Includes, Range Includes, Controlled List, Has List Item, Inheritance, Derived From), bulk_create conventions, and how to verify your work. Read it once before your first write in a session.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Get Modeling Guide",
"readOnlyHint": true,
"openWorldHint": false
}
}Labels and IDs of types, elements, and taxonomies in the project. Each category is paginated independently. Pagination: - First call: omit page (defaults to 0). - Each category reports page, pageSize and hasMore. Re-request with page+1 for any category whose hasMore is true.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 0-based page index, applied independently to each category. |
| pageSize | integer | |
| graphProjectId * | string |
{
"name": "get_project_summary",
"title": "Get Project Summary",
"description": "Labels and IDs of types, elements, and taxonomies in the project. Each category is paginated independently.\n\nPagination:\n- First call: omit page (defaults to 0).\n- Each category reports page, pageSize and hasMore. Re-request with page+1 for any category whose hasMore is true.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"page": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "0-based page index, applied independently to each category."
},
"pageSize": {
"type": "integer",
"default": 50,
"maximum": 250,
"minimum": 1
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Project Summary",
"readOnlyHint": true,
"openWorldHint": false
}
}List the user's CoreModels projects as [id,name,accessLevel] (see the response "format" field). Use a returned id as graphProjectId for other tools. Pass searchTerm to filter by name (case-insensitive substring). Set includePublicProjects=true to also include public projects. Set includeAISummary=true to also return each project's saved AI-generated summary and the time it was generated (4th and 5th elements). The response's inLibrary maps each returned id to whether the project is in the Schema Library (schema_library_projects_section); a public project need not be curated into the library, and external library catalog entries are not graph projects listed here. Paged: page is 1-based; increment page up to the returned totalPages to get all results.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. Increment to page through results up to totalPages. |
| pageSize | integer | |
| searchTerm | string | Optional case-insensitive substring to filter projects by name. |
| includeAISummary | boolean | When true, each project row includes its saved AI-generated summary (markdown) and the time it was generated as 4th and 5th elements, or null if none has been generated. |
| includePublicProjects | boolean | When true, public projects the user is not a member of are also included. |
{
"name": "list_projects",
"title": "List Projects",
"description": "List the user's CoreModels projects as [id,name,accessLevel] (see the response \"format\" field). Use a returned id as graphProjectId for other tools. Pass searchTerm to filter by name (case-insensitive substring). Set includePublicProjects=true to also include public projects. Set includeAISummary=true to also return each project's saved AI-generated summary and the time it was generated (4th and 5th elements). The response's inLibrary maps each returned id to whether the project is in the Schema Library (schema_library_projects_section); a public project need not be curated into the library, and external library catalog entries are not graph projects listed here. Paged: page is 1-based; increment page up to the returned totalPages to get all results.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number. Increment to page through results up to totalPages."
},
"pageSize": {
"type": "integer",
"default": 50,
"maximum": 250,
"minimum": 1
},
"searchTerm": {
"type": "string",
"description": "Optional case-insensitive substring to filter projects by name."
},
"includeAISummary": {
"type": "boolean",
"default": false,
"description": "When true, each project row includes its saved AI-generated summary (markdown) and the time it was generated as 4th and 5th elements, or null if none has been generated."
},
"includePublicProjects": {
"type": "boolean",
"default": false,
"description": "When true, public projects the user is not a member of are also included."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Projects",
"readOnlyHint": true,
"openWorldHint": false
}
}Get information about all mixins in a CoreModels project. Mixins define structured metadata used for mapping models, system integrations, and other extensions. Mixin values are attached to nodes; use search_nodes with includeMixins to see them, and bulk_create or create_mixin_value to set them.
| Parameter | Type | Description |
|---|---|---|
| graphProjectId * | string |
{
"name": "core_models_get_mixins_info",
"title": "Core Models Get Mixins Info",
"description": "Get information about all mixins in a CoreModels project.\n\nMixins define structured metadata used for mapping models, system integrations, and other extensions.\nMixin values are attached to nodes; use search_nodes with includeMixins to see them, and bulk_create or create_mixin_value to set them.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Core Models Get Mixins Info",
"readOnlyHint": true,
"openWorldHint": false
}
}Run a read-only GraphQL query against a CoreModels project's model — the general query escape hatch for precise questions (projections, traversals, counts) that the fixed read tools don't answer. Viewer access is required, same as the app. The schema is GENERATED PER PROJECT: field names are camelCased from this project's labels and cannot be guessed. Always call with schemaOnly=true first and write queries against the returned SDL (standard introspection queries also work, but the SDL is far cheaper). Root fields: types, elements, taxonomies, views, exemplars, spaces, mixins, relationGroups. Node roots take filter arguments id, ids, names, spaceId — note `names` is a search expression, not an exact match. Queries only: the schema has no Mutation or Subscription type. GraphQL variables and operationName are not supported — inline all literals into the query document. There is NO pagination and every matched node is returned with all its relations, so select narrowly and always filter. Results whose serialized data exceeds maxChars come back as { truncated: true, totalChars, maxChars, dataPreview } instead of { data } — tighten the query rather than raising maxChars. On a GraphQL error (usually a wrong field name) you get an error result; re-check the schema with schemaOnly=true.
| Parameter | Type | Description |
|---|---|---|
| query | string | GraphQL query document (query operations only; no variables — inline all literals). Required unless schemaOnly is true. |
| maxChars | integer | Cap on the serialized result size. The server has no pagination; over the cap you get truncated:true with a string preview instead of data. |
| schemaOnly | boolean | Return the project's generated GraphQL schema as SDL without executing anything. Call this first: field names are camelCased from this project's labels. |
| graphProjectId * | string | Id of the project to query. Viewer access is required. |
Get information about relation groups for a CoreModels project. Use the relation groups to create a relation between two nodes.
| Parameter | Type | Description |
|---|---|---|
| graphProjectId * | string |
{
"name": "core_models_get_relation_groups_info",
"title": "Core Models Get Relation Groups Info",
"description": "Get information about relation groups for a CoreModels project.\n\nUse the relation groups to create a relation between two nodes.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Core Models Get Relation Groups Info",
"readOnlyHint": true,
"openWorldHint": false
}
}Search nodes in a CoreModels project. Returns compact positional arrays; the response "format" field describes the layout. Filters (provide at least one of the first three; they combine with AND): - nodeIds: exact id lookup - nodeType: one of Element, Type, Taxonomy, Exemplar, Component, Space, Tag, Mixin - expression: partial substring match on the node label (plain text, no wildcards) - spaceIds: restrict results to specific spaces. Narrowing only - cannot be the sole filter; always combine it with nodeIds, nodeType, or expression. Optional flags: includeRelations, includeMixins, includeTimestamps, sortAttr, sortDesc, pageSize. Pagination: - Page-number based: pass page (1-based) and pageSize (max 250). - The response includes the total match count, so more pages exist while page * pageSize < total.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. The response includes 'total' (the total match count) so you can compute how many pages there are. |
| nodeIds | array | |
| nodeType | string | one of ["Element","Type","Taxonomy","Exemplar","Component","Space","Tag","Mixin"] |
| pageSize | integer | |
| sortAttr | string | one of ["Label","CreationTime","UpdateTime",""] |
| sortDesc | boolean | |
| spaceIds | array | |
| expression | string | Partial substring match against the node label. Plain text only - no wildcards, no regex, no '*', '%', '_' or '?' characters; the literal characters are matched as-is. |
Who is calling: returns the identity and subscription plan of the MCP token in use. No project id needed. Returns { userId, name, email, organizationId, endpoint, plan }. endpoint is { path, mode (read-only or write), writeEndpoint } for the endpoint this call arrived on. plan holds the raw tier and expiry from the token plus the derived limits and permissions the other tools enforce: canWrite (writes allowed at all), sharingAllowed (whether invite_user will work — the app's Share-button rule), isEnterprise (large-project copies), maxProjects (null when no limit is enforced on MCP, with maxProjectsEnforced=false; planMaxProjects is the web-app plan value) and maxNodesPerProject (same: absent when not enforced, with maxNodesEnforced=false, maxNodesNote and planMaxNodesPerProject). limitsEnforced says whether those two caps are applied on MCP calls now, and limitsEnforcedFrom when they start (2026-12-31; the sandbox project is exempt); while limitsEnforced is false, maxProjects and maxNodesPerProject stay null as above. Call it at the start of a session to know your limits before creating or importing.
No parameters.
{
"name": "whoami",
"title": "Whoami",
"description": "Who is calling: returns the identity and subscription plan of the MCP token in use. No project id needed.\n\nReturns { userId, name, email, organizationId, endpoint, plan }. endpoint is { path, mode (read-only or write), writeEndpoint } for the endpoint this call arrived on. plan holds the raw tier and expiry from the token plus the derived limits and permissions the other tools enforce: canWrite (writes allowed at all), sharingAllowed (whether invite_user will work — the app's Share-button rule), isEnterprise (large-project copies), maxProjects (null when no limit is enforced on MCP, with maxProjectsEnforced=false; planMaxProjects is the web-app plan value) and maxNodesPerProject (same: absent when not enforced, with maxNodesEnforced=false, maxNodesNote and planMaxNodesPerProject). limitsEnforced says whether those two caps are applied on MCP calls now, and limitsEnforcedFrom when they start (2026-12-31; the sandbox project is exempt); while limitsEnforced is false, maxProjects and maxNodesPerProject stay null as above. Call it at the start of a session to know your limits before creating or importing.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Whoami",
"readOnlyHint": true,
"openWorldHint": false
}
}Suggest ontology-term candidates for a schema node from the public EMBL-EBI Ontology Lookup Service (OLS). ADVISORY ONLY: this is a read-only search — it calls the external EBI OLS API and returns ranked candidates, and it NEVER writes anything to the graph. In particular it never sets the authoritative mapsTo mixin; binding a chosen term is a separate, explicit human-directed act via bind_ontology_term (you name the exact node and the exact term IRI). Provide either nodeId (the node's label is used as the query) or a raw label (optionally with a description). Optionally restrict to a comma-separated list of ontologies (e.g. "efo,mondo,hp") and cap the number of candidates. Each candidate carries { iri, curie, label, description, ontology, type } in the relevance order OLS returns; the iri is what you would pass to bind_ontology_term.
| Parameter | Type | Description |
|---|---|---|
| label | string | A raw term label to search for. Provide this OR nodeId. |
| limit | integer | Maximum candidates to return (1-50). |
| nodeId | string | The schema node to ground. Its label is used as the query. Provide this OR label. |
| ontologies | string | Optional comma-separated ontology ids to restrict to, e.g. 'efo,mondo,hp'. |
| description | string | Optional description text to refine the search ranking. |
| graphProjectId * | string |
Export project data as a ShEx (Shape Expressions) schema string.
| Parameter | Type | Description |
|---|---|---|
| closed | boolean | When true, every Type shape is CLOSED (no properties beyond the ones listed). Taxonomy shapes stay open. When false, a shape with a type constraint gets 'EXTRA rdf:type' so the node may have other types too. |
| nodeIds | array | Optional type node ids to export; omit to export all types (optionally scoped to a space). |
| spaceId | string | |
| linkMode | string | How an element whose range is another Type is written: 'shape' writes @<OtherShape> (the linked node must also match that shape), 'iri' writes IRI (the linked node only has to be an IRI). |
| graphProjectId * | string | |
| typeConstraint | boolean | When true, a shape whose Type is bound to a class (bind_ontology_term / mapsTo) gets 'rdf:type [ <classIRI> ]'. Types with no binding are unchanged. |
| includeCardinality | boolean | Whether to emit ShEx cardinality markers (?, *, +). Defaults to true. |
{
"name": "export_shex",
"title": "Export ShEx",
"description": "Export project data as a ShEx (Shape Expressions) schema string.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"closed": {
"type": "boolean",
"default": false,
"description": "When true, every Type shape is CLOSED (no properties beyond the ones listed). Taxonomy shapes stay open. When false, a shape with a type constraint gets 'EXTRA rdf:type' so the node may have other types too."
},
"nodeIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space)."
},
"spaceId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"linkMode": {
"enum": [
"shape",
"iri"
],
"type": "string",
"default": "shape",
"description": "How an element whose range is another Type is written: 'shape' writes @<OtherShape> (the linked node must also match that shape), 'iri' writes IRI (the linked node only has to be an IRI)."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"typeConstraint": {
"type": "boolean",
"default": false,
"description": "When true, a shape whose Type is bound to a class (bind_ontology_term / mapsTo) gets 'rdf:type [ <classIRI> ]'. Types with no binding are unchanged."
},
"includeCardinality": {
"type": "boolean",
"description": "Whether to emit ShEx cardinality markers (?, *, +). Defaults to true."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export ShEx",
"readOnlyHint": true,
"openWorldHint": false
}
}Export the project's types as runnable SQL DDL (CREATE TABLE statements) for PostgreSQL / SQLite. Identifiers are double-quoted; column types come from the Json Schema Mixin (number -> NUMERIC, integer -> INTEGER, boolean -> BOOLEAN, string date/date-time -> DATE/TIMESTAMP, else VARCHAR); required -> NOT NULL; every table gets a PRIMARY KEY (the element marked key, else a generated "id" VARCHAR(36)); a Controlled List -> CHECK (col IN (...)); a Range Includes to a Type -> a foreign key (on the child table for an array, e.g. "customer_id" on "Order"); referenced tables come first.
| Parameter | Type | Description |
|---|---|---|
| nodeIds | array | Optional type node ids to export; omit to export all types (optionally scoped to a space). |
| spaceId | string | |
| graphProjectId * | string |
{
"name": "export_sql",
"title": "Export SQL",
"description": "Export the project's types as runnable SQL DDL (CREATE TABLE statements) for PostgreSQL / SQLite.\n\nIdentifiers are double-quoted; column types come from the Json Schema Mixin (number -> NUMERIC, integer -> INTEGER, boolean -> BOOLEAN, string date/date-time -> DATE/TIMESTAMP, else VARCHAR); required -> NOT NULL; every table gets a PRIMARY KEY (the element marked key, else a generated \"id\" VARCHAR(36)); a Controlled List -> CHECK (col IN (...)); a Range Includes to a Type -> a foreign key (on the child table for an array, e.g. \"customer_id\" on \"Order\"); referenced tables come first.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"nodeIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space)."
},
"spaceId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export SQL",
"readOnlyHint": true,
"openWorldHint": false
}
}Export project schema as an OWL ontology (Turtle): owl:Class per Type, Datatype/ObjectProperty per Element with domain/range, rdfs:subClassOf inheritance, cardinality restrictions preserving required/array-ness, SKOS concept schemes per Taxonomy, and owl:equivalentClass/Property from cross-standard mappings. Anything OWL cannot express is reported as '# lossiness:' comments at the top of the document instead of being silently dropped.
| Parameter | Type | Description |
|---|---|---|
| spaceId | string | |
| graphProjectId * | string |
{
"name": "export_owl",
"title": "Export OWL (Turtle)",
"description": "Export project schema as an OWL ontology (Turtle): owl:Class per Type, Datatype/ObjectProperty per\nElement with domain/range, rdfs:subClassOf inheritance, cardinality restrictions preserving\nrequired/array-ness, SKOS concept schemes per Taxonomy, and owl:equivalentClass/Property from\ncross-standard mappings. Anything OWL cannot express is reported as '# lossiness:' comments at the\ntop of the document instead of being silently dropped.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"spaceId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export OWL (Turtle)",
"readOnlyHint": true,
"openWorldHint": false
}
}Export the project as an RML mapping document (RML-Core + RML-IO, namespace http://w3id.org/rml/): one rml:TriplesMap per Type, an rml:logicalSource per source file or table, a subject template from the identifier element, one rml:predicateObjectMap per Element, and joins (rml:parentTriplesMap + rml:joinCondition) for type references. Run the result in an RML engine (RMLMapper, morph-KGC, SDM-RDFizer) to build a knowledge graph from your data. Give sourceKind to bind it to real data (csv | json | xml | sql | sql-query); omit it for a skeleton with placeholder sources. The document's first line states its fidelity: RUNNABLE, TEMPLATE or SKELETON. Class and predicate IRIs come from each Type's and Element's mapsTo binding. Where a term is not bound, the IRI is minted from its name and reported as '# lossiness:' — a mapping built on minted IRIs produces a graph that joins to nothing, so bind the terms (bind_ontology_term) before publishing the output.
| Parameter | Type | Description |
|---|---|---|
| baseIri | string | Namespace subject IRIs are built under, e.g. https://data.example.gov/id |
| spaceId | string | |
| sourceForm | string | shorthand (default) is what RML engines accept today; rml-io is the newer structured source form |
| sourceKind | string | one of ["csv","json","xml","sql","sql-query"] |
| graphProjectId * | string | |
| sourceTemplate | string | Path or table per type, with {type} substituted, e.g. data/{type}.csv |
Generate Synapse curation-manifest CSV templates from a schema — the tabular companion to the transform_schema synapse export. Two artifacts per type: {name}.manifest.csv (the blank entry grid, header row only, loadable as a Curator RecordSet CSV) and {name}.dictionary.csv (the column dictionary: Column, Type, Description, Required, Value Set — followed by a value-set section listing taxonomy terms for dropdown columns). Source formats: jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | odm. Stateless — the project scopes auth only; nothing is written.
| Parameter | Type | Description |
|---|---|---|
| typeId | string | Generate manifests for this type only (matched by id or label). Omit for every type. |
| sourceFormat * | string | jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | odm |
| sourceSchema * | string | The source schema text. |
| graphProjectId * | string |
{
"name": "generate_synapse_manifests",
"title": "Generate Synapse Manifests",
"description": "Generate Synapse curation-manifest CSV templates from a schema — the tabular companion to the\ntransform_schema synapse export. Two artifacts per type: {name}.manifest.csv (the blank entry grid,\nheader row only, loadable as a Curator RecordSet CSV) and {name}.dictionary.csv (the column\ndictionary: Column, Type, Description, Required, Value Set — followed by a value-set section listing\ntaxonomy terms for dropdown columns). Source formats: jsonschema | shex | avro | jsonld | sql | osi |\nosi-json | owl | linkml | odm. Stateless — the project scopes auth only; nothing is written.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"sourceFormat",
"sourceSchema"
],
"properties": {
"typeId": {
"type": "string",
"description": "Generate manifests for this type only (matched by id or label). Omit for every type."
},
"sourceFormat": {
"type": "string",
"description": "jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | odm"
},
"sourceSchema": {
"type": "string",
"description": "The source schema text."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Generate Synapse Manifests",
"readOnlyHint": true,
"openWorldHint": false
}
}Transform a schema from one format to another through the ARAMAI mapping engine. Formats: jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | protobuf | odcs | graphql | odm | synapse (odm decodes only; osi-json is the OSI coder in its JSON serialization — the form dbt ingests; synapse encodes only — the Sage Bionetworks Synapse draft-07 subset with a registered-schema $id; its output is plain JSON Schema, decodable via jsonschema; protobuf is a single proto3 .proto file, alias proto; odcs is a Bitol Open Data Contract Standard v3 YAML data contract; graphql is a GraphQL SDL type-system document, alias sdl — the universal fallback for importing any CMS content model, since every headless CMS can emit an SDL schema; decode imports the content model and skips the generated query surface — root operation types, Connection/Edge/PageInfo pagination, filter inputs — with an honest lossiness summary). Mapping: 'inferred' (label/type matching against a target hint), 'explicit' (a SIA mapping-guide JSON: autoMatchByMapsTo, fieldMappings [{sourceElementIds, targetElementIds, transformName}], taxonomyDirectives, drops), or 'ai' (Claude proposes a plan; the same validation gate accepts or rejects it — requires a server-configured Anthropic key and Editor/Admin project membership, and sends the schemas to the Anthropic API server-side). The response carries the produced schema, the executed plan (replayable), and an honest lossiness ledger of everything the transformation could not preserve.
| Parameter | Type | Description |
|---|---|---|
| guide | string | For explicit mapping: the SIA mapping guide as JSON text. For ai mapping: optional free-text guidance for the model. |
| vendor | string | For sql output: postgres (default) | mysql | sqlserver. |
| synapseOrg | string | For synapse output: the Synapse Organization name for the $id (default 'example'; org.sagebionetworks is reserved). |
| mappingKind | string |
Query and retrieve details of a SchemaLibrary project including metadata, classifications, likes, cover images, and user permissions. Authenticated callers receive additional user-specific data (e.g. ILiked, Role).
| Parameter | Type | Description |
|---|---|---|
| projectId * | string | The SchemaLibrary project ID |
{
"name": "schema_library_query_project",
"title": "Schema Library Query Project",
"description": "Query and retrieve details of a SchemaLibrary project including metadata, classifications, likes, cover images, and user permissions. Authenticated callers receive additional user-specific data (e.g. ILiked, Role).",
"inputSchema": {
"type": "object",
"required": [
"projectId"
],
"properties": {
"projectId": {
"type": "string",
"description": "The SchemaLibrary project ID"
}
}
},
"annotations": {
"title": "Schema Library Query Project",
"readOnlyHint": true,
"openWorldHint": false
}
}Get available metadata options for SchemaLibrary projects (access methods, types, licenses, formats, domains, audiences, model sizes). Use these IDs when creating or updating projects. Optionally filter by category.
| Parameter | Type | Description |
|---|---|---|
| category | string | Filter by metadata category (optional) |
{
"name": "schema_library_get_metadata_options",
"title": "Schema Library Get Metadata Options",
"description": "Get available metadata options for SchemaLibrary projects (access methods, types, licenses, formats, domains, audiences, model sizes). Use these IDs when creating or updating projects. Optionally filter by category.",
"inputSchema": {
"type": "object",
"properties": {
"category": {
"enum": [
"AccessMethod",
"AccessType",
"Audience",
"Domains",
"Format",
"License",
"ModelSize",
"Type"
],
"type": "string",
"description": "Filter by metadata category (optional)"
}
}
},
"annotations": {
"title": "Schema Library Get Metadata Options",
"readOnlyHint": true,
"openWorldHint": false
}
}Get available classification options for SchemaLibrary projects, used to categorize and tag projects. Optionally filter by classification name (partial match supported).
| Parameter | Type | Description |
|---|---|---|
| nameFilter | string | Filter by classification name (optional - partial match supported) |
{
"name": "schema_library_get_classifications",
"title": "Schema Library Get Classifications",
"description": "Get available classification options for SchemaLibrary projects, used to categorize and tag projects. Optionally filter by classification name (partial match supported).",
"inputSchema": {
"type": "object",
"properties": {
"nameFilter": {
"type": "string",
"description": "Filter by classification name (optional - partial match supported)"
}
}
},
"annotations": {
"title": "Schema Library Get Classifications",
"readOnlyHint": true,
"openWorldHint": false
}
}Search and retrieve a filtered, paginated list of SchemaLibrary projects with advanced filtering options including metadata, classifications, and project attributes. The library is the curated catalog, not the graph-project list: each row's inProjectList says whether list_projects (includePublicProjects=true) also returns it — external catalog entries (isExternal) and suspended or stopped projects are library-only.
| Parameter | Type | Description |
|---|---|---|
| page | integer | |
| title | string | Search by project title (partial match) |
| sortBy | string | one of ["Trending","RecentlyCreated","RecentlyUpdated"] |
| typeId | string | |
| pageSize | integer | |
| domainIds | string | Comma-separated domain IDs |
| formatIds | string | Comma-separated format IDs |
| licenseId | string | |
| isExternal | boolean | |
| isFeatured | boolean | |
| audienceIds |
Get available use case types for SchemaLibrary projects. Use these types when creating new use cases for a project.
No parameters.
{
"name": "schema_library_get_use_case_types",
"title": "Schema Library Get Use Case Types",
"description": "Get available use case types for SchemaLibrary projects. Use these types when creating new use cases for a project.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Schema Library Get Use Case Types",
"readOnlyHint": true,
"openWorldHint": false
}
}Ask the CoreModels team for a scoping call: the escalation path when this MCP server cannot do the job alone (a plan limit, a missing capability, or a question only a person can answer). Call it when you are stuck for that reason, not as a first resort. Creates a sales lead; a person from the CoreModels team follows up by email. No project id and no sign-in needed: this is the one tool on /mcp that works without a JWT. Rate-limited per caller and in total. The person named in contact_email must have agreed to be contacted (consent: true).
| Parameter | Type | Description |
|---|---|---|
| need * | string | What help is needed, in your own words — the plan limit, missing capability, or question that brought you here. |
| company * | string | The contact's company or organization. |
| consent * | boolean | Must be true: confirms the person named in contact_name/contact_email has agreed to be contacted by email. |
| contact_name * | string | Name of the person who should be contacted. |
| contact_email * | string | Email of the person who should be contacted. They are told why: a person replies within one business day. |
| recent_tool_calls | array | Names of the MCP tools you called before this one, in order, for context on what led here. |
| calling_agent_name | string |
Execute a JavaScript program that orchestrates this server's tools, and return only its result. Prefer this over many individual tool calls when a task needs several steps, looping, filtering, or combining data: intermediate results stay in the sandbox, so only what you return reaches the model. Inside the script: - listTools() -> [{name, summary}] discover available tools - getToolDoc(name) -> {name, description, parameters, required} inspect one tool's inputs - tools.<name>(args) -> parsed result call a tool (graphProjectId is injected automatically; do NOT pass it) - console.log(...) captured and returned alongside the result - return <value> JSON-serialized and returned Environment: sandboxed JavaScript, no network or filesystem. Limits: 30 seconds, 128 MB of memory, 200,000 statements, 50 tool calls per script (20 of them writes on the admin endpoint). This endpoint serves read-only tools, so only read tools are ever callable from code here. Code-mode writes (an allowlist of creation tools) are served by the admin endpoint (/mcp-admin). Use listTools() to see what is callable right now.
| Parameter | Type | Description |
|---|---|---|
| code * | string | JavaScript to execute. Use tools.<name>(args), listTools(), getToolDoc(name); end with `return <value>`. |
| dryRun | boolean | When true, write-tool calls are collected and reported as plannedWrites instead of being executed. Read tools run normally. |
| graphProjectId * | string |
{
"name": "run_code",
"title": "Run Code",
"description": "Execute a JavaScript program that orchestrates this server's tools, and return only its result.\n\nPrefer this over many individual tool calls when a task needs several steps, looping, filtering, or\ncombining data: intermediate results stay in the sandbox, so only what you return reaches the model.\n\nInside the script:\n- listTools() -> [{name, summary}] discover available tools\n- getToolDoc(name) -> {name, description, parameters, required} inspect one tool's inputs\n- tools.<name>(args) -> parsed result call a tool (graphProjectId is injected automatically; do NOT pass it)\n- console.log(...) captured and returned alongside the result\n- return <value> JSON-serialized and returned\n\nEnvironment: sandboxed JavaScript, no network or filesystem. Limits: 30 seconds, 128 MB of memory,\n200,000 statements, 50 tool calls per script (20 of them writes on the admin endpoint).\nThis endpoint serves read-only tools, so only read tools are ever callable from code here. Code-mode\nwrites (an allowlist of creation tools) are served by the admin endpoint (/mcp-admin).\nUse listTools() to see what is callable right now.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"code"
],
"properties": {
"code": {
"type": "string",
"description": "JavaScript to execute. Use tools.<name>(args), listTools(), getToolDoc(name); end with `return <value>`."
},
"dryRun": {
"type": "boolean",
"default": false,
"description": "When true, write-tool calls are collected and reported as plannedWrites instead of being executed. Read tools run normally."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Run Code",
"readOnlyHint": true,
"openWorldHint": false
}
}CoreModels is a schema graph. What you build here exports to JSON Schema, JSON-LD, ShEx, LinkML, SQL, Avro, OWL and vendor artifacts, so structure and relation direction matter. Before writing anything, read the full modeling guide: call get_modeling_guide (or read the resource coremodels://guides/modeling). It takes one call. The essentials: 1. Start each session with get_project_summary and get_mixins_and_relation_groups. Match relation groups by label. 1b. copy_project clones an existing project server-side (node ids preserved); it runs in the background, poll get_job_status until success. 2. Import before you build. JSON Schema at a URL: import_jsonschema. dbt, Snowflake, BigQuery, Salesforce and 17 other vendors: get_vendor_integration_status, then import_vendor_project. For dbt, send manifest and catalog. Never rebuild a vendor project by hand. 3. Domain Includes runs Type -> Element ("this type has this element"). Range Includes runs Element -> Type/Taxonomy. Controlled List runs Element -> Taxonomy. 4. Mint random 32-hex ids or GUIDs, never sequential ones. Mixin types and relation groups are the exception: create_mixin_type and create_relation_group generate deterministic ids server-side, so never pass ids to them. remove_mixin_type removes a mixin type you made; the standard ones refuse. 5. Rehearse writes with run_code dryRun=true. check_admissible answers whether a relation is allowed before you write it. Check your work: a Type's Domain Includes relations should be outgoing to its Elements. 6. Large files go by URL (artifactUrls, customFileUrl), never inline. 7. Questions or feedback humans should see: list_comments reads a project's discussion, add_comment leaves a comment or reply that shows up in the CoreModels app. 8. Precise read questions (projections, traversals, counts): query_model_graphql — always fetch the schema first with schemaOnly=true; field names are generated from the project's labels.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "generate_vendor_artifacts",
"title": "Generate Vendor Artifacts",
"description": "Generates vendor artifacts from the governed CoreModels graph. For dbt: a schema.yml with enforced model contracts — column data types, not_null/unique constraints and tests, accepted_values tests from governed taxonomies, relationships tests from governed references. SMEs change meaning once in CoreModels; engineers get a reviewed contract diff.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"vendor"
],
"properties": {
"layout": {
"enum": [
"model",
"folder",
"single"
],
"type": "string",
"description": "dbt file layout: 'model' (default) one property file per model colocated with its .sql; 'folder' one file per model directory; 'single' one repo-wide file."
},
"spaces": {
"type": "array",
"items": {
"type": "string"
}
},
"vendor": {
"type": "string",
"description": "Vendor connector key, e.g. 'dbt'."
},
"typeNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Restrict generation to these model/type names (empty = everything eligible)."
},
"targetVersion": {
"type": "string",
"description": "Vendor dialect/version. dbt: default emits data_tests: (>=1.8); '1.7' emits legacy tests:."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"iriInDescription": {
"type": "boolean",
"description": "dbt: also append bound ontology IRIs to the column description so persist_docs carries them into the warehouse column comment. Default true; they always ride in meta regardless."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Generate Vendor Artifacts",
"readOnlyHint": true,
"openWorldHint": false
}
}| boolean |
| exportTaxonomies | boolean |
{
"name": "export_json_ld",
"title": "Export JSON-LD",
"description": "Export project data in JSON-LD format using a configured export profile.\n\nUse `fetch_json_ld_import_profiles` first to discover the configTypeId. At least one of exportTypes/exportElements/exportTaxonomies/exportDataTypes must be true. Tree-based mode (graphBased=false) requires exactly one nodeId; graph-based mode allows multiple or none.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"configTypeId"
],
"properties": {
"nodeIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "For tree-based export, exactly one root node id; for graph-based, optional"
},
"spaceId": {
"type": "string",
"description": "Optional space id to filter export data; empty = all spaces"
},
"graphBased": {
"type": "boolean",
"default": true,
"description": "true = graph-based (no root); false = tree-based (requires exactly one nodeId)"
},
"exportTypes": {
"type": "boolean",
"default": false
},
"configTypeId": {
"type": "string",
"description": "JSON-LD export profile id (from fetch_json_ld_import_profiles)"
},
"includeSpace": {
"type": "boolean",
"default": false
},
"exportElements": {
"type": "boolean",
"default": false
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"useDefaultType": {
"type": "boolean",
"default": false
},
"exportDataTypes": {
"type": "boolean",
"default": false
},
"exportTaxonomies": {
"type": "boolean",
"default": false
}
}
},
"annotations": {
"title": "Export JSON-LD",
"readOnlyHint": true,
"openWorldHint": false
}
}| string |
{
"name": "validate_json",
"title": "Validate JSON",
"description": "Validate one or more JSON documents against a project's stored JSON Schema.\n\nThe schema is regenerated from the project using the supplied configTypeId (the export profile id) and rootNodeId, then reused for every document - so validating a batch costs barely more than validating one. Pass up to 100 documents per call and chunk anything larger.\n\nResponse:\n- isValid: true only when EVERY document passed.\n- total, validCount: counts over the whole batch.\n- invalid: one entry per failing document, as {index, errors}. Only failures are listed - any index not present passed. index is the 0-based position in the jsonStrings array you sent.\n- A document that is not parseable JSON fails in its own slot; it does not abort the rest of the batch.\n\nSet explain=true to add a plain-English \"- Explanation:\" line to every error, describing what is wrong, where, and how to fix it. The raw structured lines are unchanged either way - use it when a person will read the result, leave it off for machine parsing.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"rootNodeId",
"jsonStrings"
],
"properties": {
"explain": {
"type": "boolean",
"default": false,
"description": "Add a plain-English explanation to each error alongside the raw structured fields. Use when a person will read the output."
},
"spaceId": {
"type": "string",
"description": "Optional space id to scope the schema"
},
"rootNodeId": {
"type": "string",
"description": "Node id used as the root when generating the JSON Schema"
},
"jsonStrings": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "The JSON documents to validate, each serialized as a string. Results reference documents by their 0-based position in this array."
},
"configTypeId": {
"type": "string",
"description": "Profile id used to map mixins/relations to schema keywords"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
}
},
"annotations": {
"title": "Validate JSON",
"readOnlyHint": true,
"openWorldHint": false
}
}{
"name": "check_admissible",
"title": "Check Admissible",
"description": "Check whether a relation would be admissible before writing it. Reads the SAME relation-group\nrule table create_relation and bulk_create validate against, so the answer matches what a write\nwould do.\n\nPass relationGroupId plus fromNodeId and toNodeId — both must already exist in the project.\nReturns admissible, the rule (relation group label) it was checked against, a reason when\nrefused (naming the allowed direction), and alternative relation groups that do admit this\nnode-type pair.\n\nMixin form: instead of the relation arguments, pass mixinId, targetNodeId and mixinColumns (the same\nitems bulk_create takes under mixins; id = column ID, label = value). The answer comes from the same\ndry-run checks bulk_create runs for mixin values, with nothing written: admissible, and the reason when\nrefused. Do not pass both forms in one call.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"mixinId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"toNodeId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"fromNodeId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"mixinColumns": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "id = column ID, label = value."
},
"targetNodeId": {
"type": "string"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"relationGroupId": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Check Admissible",
"readOnlyHint": true,
"openWorldHint": false
}
}{
"name": "list_comments",
"title": "List Comments",
"description": "List the discussion (comments and replies) of a CoreModels project — the same threads users see in the app's grid collaboration panel. Viewer access is required.\n\nComments are anchored by tag sets: a comment left on a grid cell carries that cell's tag ids (node/element/relation ids, sometimes a section label) plus the project id. Omit anchorIds to list the whole project's discussion; pass anchorIds to return only comments anchored to exactly that tag set (the project id is implied — never include it).\n\nReturns { comments, total, returned, truncated }. comments are top-level threads, newest first, each with its replies nested oldest first; every entry has { id, createdBy, createdByName, message, anchorIds, mentionUserIds, parentId, isResolved, createdDate }. Reply to a thread or leave a new one with add_comment (admin endpoint).",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"anchorIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[^,_]+$"
},
"description": "Optional cell anchor: return only comments whose anchor tag set equals exactly this set. Do not include the project id."
},
"maxResults": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "Cap on returned top-level threads (newest first); truncated=true when more matched."
},
"textContains": {
"type": "string",
"description": "Optional text filter, matched in comments and replies."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "Id of the project whose discussion to read. Viewer access is required."
},
"includeReplies": {
"type": "boolean",
"default": true,
"description": "Nest each thread's replies in the response."
},
"includeResolved": {
"type": "boolean",
"default": false,
"description": "Also return resolved (closed) threads."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List Comments",
"readOnlyHint": true,
"openWorldHint": false
}
}{
"name": "query_model_graphql",
"title": "Query Model Graphql",
"description": "Run a read-only GraphQL query against a CoreModels project's model — the general query escape hatch for precise questions (projections, traversals, counts) that the fixed read tools don't answer. Viewer access is required, same as the app.\n\nThe schema is GENERATED PER PROJECT: field names are camelCased from this project's labels and cannot be guessed. Always call with schemaOnly=true first and write queries against the returned SDL (standard introspection queries also work, but the SDL is far cheaper). Root fields: types, elements, taxonomies, views, exemplars, spaces, mixins, relationGroups. Node roots take filter arguments id, ids, names, spaceId — note `names` is a search expression, not an exact match.\n\nQueries only: the schema has no Mutation or Subscription type. GraphQL variables and operationName are not supported — inline all literals into the query document.\n\nThere is NO pagination and every matched node is returned with all its relations, so select narrowly and always filter. Results whose serialized data exceeds maxChars come back as { truncated: true, totalChars, maxChars, dataPreview } instead of { data } — tighten the query rather than raising maxChars. On a GraphQL error (usually a wrong field name) you get an error result; re-check the schema with schemaOnly=true.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"query": {
"type": "string",
"description": "GraphQL query document (query operations only; no variables — inline all literals). Required unless schemaOnly is true."
},
"maxChars": {
"type": "integer",
"default": 100000,
"maximum": 500000,
"minimum": 1000,
"description": "Cap on the serialized result size. The server has no pagination; over the cap you get truncated:true with a string preview instead of data."
},
"schemaOnly": {
"type": "boolean",
"default": false,
"description": "Return the project's generated GraphQL schema as SDL without executing anything. Call this first: field names are camelCased from this project's labels."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "Id of the project to query. Viewer access is required."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Query Model Graphql",
"readOnlyHint": true,
"openWorldHint": false
}
}| includeMixins | boolean |
| graphProjectId * | string |
| includeRelations | boolean |
| includeTimestamps | boolean | Adds creationTime and updateTime (ISO 8601 UTC) to each node. Combine with sortAttr CreationTime/UpdateTime to see when nodes changed. |
| limitPerRelationGroup | integer | Only with includeRelations. Caps relations returned PER relation group for each node (e.g. 100). Omit for no cap. |
{
"name": "search_nodes",
"title": "Search Nodes",
"description": "Search nodes in a CoreModels project. Returns compact positional arrays; the response \"format\" field describes the layout.\n\nFilters (provide at least one of the first three; they combine with AND):\n- nodeIds: exact id lookup\n- nodeType: one of Element, Type, Taxonomy, Exemplar, Component, Space, Tag, Mixin\n- expression: partial substring match on the node label (plain text, no wildcards)\n- spaceIds: restrict results to specific spaces. Narrowing only - cannot be the sole filter; always combine it with nodeIds, nodeType, or expression.\n\nOptional flags: includeRelations, includeMixins, includeTimestamps, sortAttr, sortDesc, pageSize.\n\nPagination:\n- Page-number based: pass page (1-based) and pageSize (max 250).\n- The response includes the total match count, so more pages exist while page * pageSize < total.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "1-based page number. The response includes 'total' (the total match count) so you can compute how many pages there are."
},
"nodeIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
}
},
"nodeType": {
"enum": [
"Element",
"Type",
"Taxonomy",
"Exemplar",
"Component",
"Space",
"Tag",
"Mixin"
],
"type": "string"
},
"pageSize": {
"type": "integer",
"default": 50,
"maximum": 250,
"minimum": 1
},
"sortAttr": {
"enum": [
"Label",
"CreationTime",
"UpdateTime",
""
],
"type": "string"
},
"sortDesc": {
"type": "boolean",
"default": false
},
"spaceIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
}
},
"expression": {
"type": "string",
"examples": [
"Patient",
"Address"
],
"description": "Partial substring match against the node label. Plain text only - no wildcards, no regex, no '*', '%', '_' or '?' characters; the literal characters are matched as-is."
},
"includeMixins": {
"type": "boolean",
"default": false
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"includeRelations": {
"type": "boolean",
"default": false
},
"includeTimestamps": {
"type": "boolean",
"default": false,
"description": "Adds creationTime and updateTime (ISO 8601 UTC) to each node. Combine with sortAttr CreationTime/UpdateTime to see when nodes changed."
},
"limitPerRelationGroup": {
"type": "integer",
"minimum": 1,
"description": "Only with includeRelations. Caps relations returned PER relation group for each node (e.g. 100). Omit for no cap."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search Nodes",
"readOnlyHint": true,
"openWorldHint": false
}
}{
"name": "suggest_ontology_terms",
"title": "Suggest Ontology Terms",
"description": "Suggest ontology-term candidates for a schema node from the public EMBL-EBI Ontology Lookup Service\n(OLS). ADVISORY ONLY: this is a read-only search — it calls the external EBI OLS API and returns\nranked candidates, and it NEVER writes anything to the graph. In particular it never sets the\nauthoritative mapsTo mixin; binding a chosen term is a separate, explicit human-directed act via\nbind_ontology_term (you name the exact node and the exact term IRI).\n\nProvide either nodeId (the node's label is used as the query) or a raw label (optionally with a\ndescription). Optionally restrict to a comma-separated list of ontologies (e.g. \"efo,mondo,hp\") and\ncap the number of candidates. Each candidate carries { iri, curie, label, description, ontology, type }\nin the relevance order OLS returns; the iri is what you would pass to bind_ontology_term.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"label": {
"type": "string",
"description": "A raw term label to search for. Provide this OR nodeId."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum candidates to return (1-50)."
},
"nodeId": {
"type": "string",
"description": "The schema node to ground. Its label is used as the query. Provide this OR label."
},
"ontologies": {
"type": "string",
"description": "Optional comma-separated ontology ids to restrict to, e.g. 'efo,mondo,hp'."
},
"description": {
"type": "string",
"description": "Optional description text to refine the search ranking."
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Suggest Ontology Terms",
"readOnlyHint": true,
"openWorldHint": true
}
}{
"name": "export_rml",
"title": "Export RML mapping (Turtle)",
"description": "Export the project as an RML mapping document (RML-Core + RML-IO, namespace http://w3id.org/rml/):\none rml:TriplesMap per Type, an rml:logicalSource per source file or table, a subject template from\nthe identifier element, one rml:predicateObjectMap per Element, and joins (rml:parentTriplesMap +\nrml:joinCondition) for type references. Run the result in an RML engine (RMLMapper, morph-KGC,\nSDM-RDFizer) to build a knowledge graph from your data.\n\nGive sourceKind to bind it to real data (csv | json | xml | sql | sql-query); omit it for a\nskeleton with placeholder sources. The document's first line states its fidelity: RUNNABLE,\nTEMPLATE or SKELETON.\n\nClass and predicate IRIs come from each Type's and Element's mapsTo binding. Where a term is not\nbound, the IRI is minted from its name and reported as '# lossiness:' — a mapping built on minted\nIRIs produces a graph that joins to nothing, so bind the terms (bind_ontology_term) before\npublishing the output.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId"
],
"properties": {
"baseIri": {
"type": "string",
"description": "Namespace subject IRIs are built under, e.g. https://data.example.gov/id"
},
"spaceId": {
"type": "string",
"pattern": "^([a-f0-9]{32}|[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})$"
},
"sourceForm": {
"enum": [
"shorthand",
"rml-io"
],
"type": "string",
"description": "shorthand (default) is what RML engines accept today; rml-io is the newer structured source form"
},
"sourceKind": {
"enum": [
"csv",
"json",
"xml",
"sql",
"sql-query"
],
"type": "string"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"sourceTemplate": {
"type": "string",
"description": "Path or table per type, with {type} substituted, e.g. data/{type}.csv"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Export RML mapping (Turtle)",
"readOnlyHint": true,
"openWorldHint": false
}
}| inferred (default) | explicit | ai |
| synapseName | string | For synapse output: the schema name segment of the $id (default: derived from the root type). |
| sourceFormat * | string | jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | protobuf | odcs | graphql | odm |
| sourceSchema * | string | The source schema text. |
| targetFormat * | string | jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | protobuf | odcs | graphql | synapse |
| graphProjectId * | string |
| synapseVersion | string | For synapse output: the semver segment of the $id (default 0.0.1; Synapse rejects re-registering an existing version). |
| caseInsensitive | boolean | Inferred mapping: ignore label case (default true). |
| targetHintFormat | string | Format of the optional target hint schema. |
| targetHintSchema | string | The schema to map toward. Required for inferred mapping. |
{
"name": "transform_schema",
"title": "Transform Schema",
"description": "Transform a schema from one format to another through the ARAMAI mapping engine.\nFormats: jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | protobuf | odcs | graphql | odm | synapse\n(odm decodes only; osi-json is the OSI coder in its JSON serialization — the form dbt ingests;\nsynapse encodes only — the Sage Bionetworks Synapse draft-07 subset with a registered-schema $id;\nits output is plain JSON Schema, decodable via jsonschema; protobuf is a single proto3 .proto file,\nalias proto; odcs is a Bitol Open Data Contract Standard v3 YAML data contract; graphql is a GraphQL\nSDL type-system document, alias sdl — the universal fallback for importing any CMS content model,\nsince every headless CMS can emit an SDL schema; decode imports the content model and skips the\ngenerated query surface — root operation types, Connection/Edge/PageInfo pagination, filter inputs —\nwith an honest lossiness summary).\nMapping: 'inferred' (label/type matching against a target hint), 'explicit' (a SIA mapping-guide\nJSON: autoMatchByMapsTo, fieldMappings [{sourceElementIds, targetElementIds, transformName}],\ntaxonomyDirectives, drops), or 'ai' (Claude proposes a plan; the same validation gate accepts or\nrejects it — requires a server-configured Anthropic key and Editor/Admin project membership, and\nsends the schemas to the Anthropic API server-side). The response carries the produced schema,\nthe executed plan (replayable), and an honest lossiness ledger of everything the transformation\ncould not preserve.",
"inputSchema": {
"type": "object",
"required": [
"graphProjectId",
"sourceFormat",
"sourceSchema",
"targetFormat"
],
"properties": {
"guide": {
"type": "string",
"description": "For explicit mapping: the SIA mapping guide as JSON text. For ai mapping: optional free-text guidance for the model."
},
"vendor": {
"type": "string",
"description": "For sql output: postgres (default) | mysql | sqlserver."
},
"synapseOrg": {
"type": "string",
"description": "For synapse output: the Synapse Organization name for the $id (default 'example'; org.sagebionetworks is reserved)."
},
"mappingKind": {
"type": "string",
"description": "inferred (default) | explicit | ai"
},
"synapseName": {
"type": "string",
"description": "For synapse output: the schema name segment of the $id (default: derived from the root type)."
},
"sourceFormat": {
"type": "string",
"description": "jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | protobuf | odcs | graphql | odm"
},
"sourceSchema": {
"type": "string",
"description": "The source schema text."
},
"targetFormat": {
"type": "string",
"description": "jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | protobuf | odcs | graphql | synapse"
},
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"synapseVersion": {
"type": "string",
"description": "For synapse output: the semver segment of the $id (default 0.0.1; Synapse rejects re-registering an existing version)."
},
"caseInsensitive": {
"type": "boolean",
"description": "Inferred mapping: ignore label case (default true)."
},
"targetHintFormat": {
"type": "string",
"description": "Format of the optional target hint schema."
},
"targetHintSchema": {
"type": "string",
"description": "The schema to map toward. Required for inferred mapping."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Transform Schema",
"readOnlyHint": true,
"openWorldHint": true
}
}| string |
| Comma-separated audience IDs |
| modelSizeId | string |
| accessTypeId | string |
| publishState | string | one of ["Published","Unpublished","All"] |
| accessMethodId | string |
| onlyMyProjects | boolean | Authenticated only |
| graphProjectType | string | Graph project type filter (e.g. 'Public', 'Private') |
| classificationIds | string | Comma-separated classification IDs |
| onlyFavoriteProjects | boolean | Authenticated only |
{
"name": "schema_library_projects_section",
"title": "Schema Library Projects Section",
"description": "Search and retrieve a filtered, paginated list of SchemaLibrary projects with advanced filtering options including metadata, classifications, and project attributes. The library is the curated catalog, not the graph-project list: each row's inProjectList says whether list_projects (includePublicProjects=true) also returns it — external catalog entries (isExternal) and suspended or stopped projects are library-only.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"title": {
"type": "string",
"description": "Search by project title (partial match)"
},
"sortBy": {
"enum": [
"Trending",
"RecentlyCreated",
"RecentlyUpdated"
],
"type": "string",
"default": "RecentlyUpdated"
},
"typeId": {
"type": "string"
},
"pageSize": {
"type": "integer",
"default": 10,
"maximum": 250,
"minimum": 1
},
"domainIds": {
"type": "string",
"description": "Comma-separated domain IDs"
},
"formatIds": {
"type": "string",
"description": "Comma-separated format IDs"
},
"licenseId": {
"type": "string"
},
"isExternal": {
"type": "boolean"
},
"isFeatured": {
"type": "boolean"
},
"audienceIds": {
"type": "string",
"description": "Comma-separated audience IDs"
},
"modelSizeId": {
"type": "string"
},
"accessTypeId": {
"type": "string"
},
"publishState": {
"enum": [
"Published",
"Unpublished",
"All"
],
"type": "string",
"default": "All"
},
"accessMethodId": {
"type": "string"
},
"onlyMyProjects": {
"type": "boolean",
"default": false,
"description": "Authenticated only"
},
"graphProjectType": {
"type": "string",
"description": "Graph project type filter (e.g. 'Public', 'Private')"
},
"classificationIds": {
"type": "string",
"description": "Comma-separated classification IDs"
},
"onlyFavoriteProjects": {
"type": "boolean",
"default": false,
"description": "Authenticated only"
}
}
},
"annotations": {
"title": "Schema Library Projects Section",
"readOnlyHint": true,
"openWorldHint": false
}
}| Name of the AI agent or application making this call (self-reported, e.g. 'Claude Desktop', 'Cursor', a custom script name). |
{
"name": "contact_sales",
"title": "Contact Sales",
"description": "Ask the CoreModels team for a scoping call: the escalation path when this MCP server cannot do the\njob alone (a plan limit, a missing capability, or a question only a person can answer). Call it when\nyou are stuck for that reason, not as a first resort.\n\nCreates a sales lead; a person from the CoreModels team follows up by email. No project id and no\nsign-in needed: this is the one tool on /mcp that works without a JWT. Rate-limited per caller and\nin total. The person named in contact_email must have agreed to be contacted (consent: true).",
"inputSchema": {
"type": "object",
"required": [
"contact_name",
"contact_email",
"company",
"need",
"consent"
],
"properties": {
"need": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "What help is needed, in your own words — the plan limit, missing capability, or question that brought you here."
},
"company": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The contact's company or organization."
},
"consent": {
"type": "boolean",
"const": true,
"description": "Must be true: confirms the person named in contact_name/contact_email has agreed to be contacted by email."
},
"contact_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Name of the person who should be contacted."
},
"contact_email": {
"type": "string",
"maxLength": 254,
"description": "Email of the person who should be contacted. They are told why: a person replies within one business day."
},
"recent_tool_calls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 20,
"description": "Names of the MCP tools you called before this one, in order, for context on what led here."
},
"calling_agent_name": {
"type": "string",
"maxLength": 200,
"description": "Name of the AI agent or application making this call (self-reported, e.g. 'Claude Desktop', 'Cursor', a custom script name)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Contact Sales",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}