CoreModels
Model, map and validate data schemas. Export JSON Schema, JSON-LD, LinkML, OWL, ShEx, SQL, Avro.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (13)
- HIGH
- MEDIUMen export_rml
- MEDIUMen export_json_ld
- MEDIUMen export_rml
- LOWen fetch_json_schema_import_profiles
- LOWen core_models_get_relation_groups_info
- LOWen schema_library_get_metadata_options
- LOWen schema_library_get_classifications
- LOWen schema_library_projects_section
- LOWen schema_library_get_use_case_types
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"coremodels": {
"url": "https://go.coremodels.io/mcp"
}
}
}Puntos de conexión remotos
https://go.coremodels.io/mcpstreamable-httphttps://go.coremodels.io/mcp-adminstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (37)
🟢export_avro(graphProjectId, spaceId, nodeIds)
Export project data as an Avro (.avsc JSON) schema string.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
},
"nodeIds": {
"type": "array",
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space).",
"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})$"
}
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢analyze_concept_impact(graphProjectId, concept, spaces)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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'."
},
"spaces": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"graphProjectId",
"concept"
],
"additionalProperties": false
}🟢audit_vendor_project(graphProjectId, vendor, artifacts, artifactUrls, spaces)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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"
}
},
"spaces": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional target space ids."
}
},
"required": [
"graphProjectId",
"vendor"
],
"additionalProperties": false
}🟢generate_vendor_artifacts(graphProjectId, vendor, typeNames, targetVersion, layout, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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:."
},
"layout": {
"type": "string",
"enum": [
"model",
"folder",
"single"
],
"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."
},
"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."
},
"spaces": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"graphProjectId",
"vendor"
],
"additionalProperties": false
}🟢get_vendor_integration_status(graphProjectId, vendor, spaces)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"vendor": {
"type": "string",
"description": "Omit to list all registered vendor connectors."
},
"spaces": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢export_json_ld(graphProjectId, configTypeId, exportTypes, exportElements, exportTaxonomies, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"configTypeId": {
"type": "string",
"description": "JSON-LD export profile id (from fetch_json_ld_import_profiles)"
},
"exportTypes": {
"type": "boolean",
"default": false
},
"exportElements": {
"type": "boolean",
"default": false
},
"exportTaxonomies": {
"type": "boolean",
"default": false
},
"exportDataTypes": {
"type": "boolean",
"default": false
},
"graphBased": {
"type": "boolean",
"default": true,
"description": "true = graph-based (no root); false = tree-based (requires exactly one nodeId)"
},
"spaceId": {
"type": "string",
"description": "Optional space id to filter export data; empty = all spaces"
},
"nodeIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "For tree-based export, exactly one root node id; for graph-based, optional"
},
"includeSpace": {
"type": "boolean",
"default": false
},
"useDefaultType": {
"type": "boolean",
"default": false
}
},
"required": [
"graphProjectId",
"configTypeId"
]
}🟢fetch_json_ld_import_profiles(graphProjectId, configTypeId)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"configTypeId": {
"type": "string",
"description": "Optional. A profile id from this tool's list; returns that profile's field mapping."
}
},
"required": [
"graphProjectId"
]
}🟢export_jsonschema(graphProjectId, spaceId, configTypeId, rootNodeId, inheritanceHandler, ...)
Export project data as a JSON Schema string.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
},
"configTypeId": {
"type": "string",
"description": "Export profile id used for the JSON Schema export."
},
"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."
},
"inheritanceHandler": {
"type": "string",
"enum": [
"None",
"IncludeInProperties",
"IncludeAsRef"
],
"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": {
"type": "string",
"enum": [
"None",
"IncludeInProperties",
"IncludeAsRef"
],
"description": "Deprecated misspelling of 'inheritanceHandler', kept for existing callers. Use 'inheritanceHandler'; passing both with different values is an error."
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢fetch_json_schema_import_profiles(graphProjectId, configTypeId)
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, ...).
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string"
},
"configTypeId": {
"type": "string",
"description": "Optional. A profile id from this tool's list; returns that profile's field mapping."
}
},
"required": [
"graphProjectId"
]
}🟢validate_json(graphProjectId, configTypeId, rootNodeId, spaceId, explain, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"configTypeId": {
"type": "string",
"description": "Profile id used to map mixins/relations to schema keywords"
},
"rootNodeId": {
"type": "string",
"description": "Node id used as the root when generating the JSON Schema"
},
"spaceId": {
"type": "string",
"description": "Optional space id to scope the schema"
},
"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."
},
"jsonStrings": {
"type": "array",
"description": "The JSON documents to validate, each serialized as a string. Results reference documents by their 0-based position in this array.",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 100
}
},
"required": [
"graphProjectId",
"rootNodeId",
"jsonStrings"
]
}🟢export_linkml(graphProjectId, spaceId, nodeIds)
Export project data as a LinkML (YAML) schema string.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
},
"nodeIds": {
"type": "array",
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space).",
"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})$"
}
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢check_admissible(graphProjectId, fromNodeId, toNodeId, relationGroupId, mixinId, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
},
"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})$"
},
"relationGroupId": {
"type": "string"
},
"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})$"
},
"targetNodeId": {
"type": "string"
},
"mixinColumns": {
"type": "array",
"description": "id = column ID, label = value.",
"items": {
"type": "object",
"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"
}
},
"required": [
"id",
"label"
],
"additionalProperties": false
}
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢list_comments(graphProjectId, anchorIds, textContains, includeResolved, includeReplies, ...)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "Id of the project whose discussion to read. Viewer access is required."
},
"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."
},
"textContains": {
"type": "string",
"description": "Optional text filter, matched in comments and replies."
},
"includeResolved": {
"type": "boolean",
"default": false,
"description": "Also return resolved (closed) threads."
},
"includeReplies": {
"type": "boolean",
"default": true,
"description": "Nest each thread's replies in the response."
},
"maxResults": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 50,
"description": "Cap on returned top-level threads (newest first); truncated=true when more matched."
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢get_job_status(graphProjectId, jobDetailsId)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"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."
},
"jobDetailsId": {
"type": "string",
"minLength": 1,
"description": "The jobDetailsId returned by the tool that started the job."
}
},
"required": [
"graphProjectId",
"jobDetailsId"
],
"additionalProperties": false
}🟢get_mixins_and_relation_groups(graphProjectId)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢get_modeling_guide
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.
Esquema de entrada
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢get_project_summary(graphProjectId, page, pageSize)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"page": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "0-based page index, applied independently to each category."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 250,
"default": 50
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢list_projects(searchTerm, includePublicProjects, includeAISummary, page, pageSize)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"searchTerm": {
"type": "string",
"description": "Optional case-insensitive substring to filter projects by name."
},
"includePublicProjects": {
"type": "boolean",
"default": false,
"description": "When true, public projects the user is not a member of are also included."
},
"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."
},
"page": {
"type": "integer",
"minimum": 1,
"default": 1,
"description": "1-based page number. Increment to page through results up to totalPages."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 250,
"default": 50
}
},
"additionalProperties": false
}🟢core_models_get_mixins_info(graphProjectId)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢query_model_graphql(graphProjectId, query, schemaOnly, maxChars)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"description": "Id of the project to query. Viewer access is required."
},
"query": {
"type": "string",
"description": "GraphQL query document (query operations only; no variables — inline all literals). Required unless schemaOnly is true."
},
"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."
},
"maxChars": {
"type": "integer",
"minimum": 1000,
"maximum": 500000,
"default": 100000,
"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."
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢core_models_get_relation_groups_info(graphProjectId)
Get information about relation groups for a CoreModels project. Use the relation groups to create a relation between two nodes.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢search_nodes(graphProjectId, nodeType, nodeIds, expression, spaceIds, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"nodeType": {
"type": "string",
"enum": [
"Element",
"Type",
"Taxonomy",
"Exemplar",
"Component",
"Space",
"Tag",
"Mixin"
]
},
"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})$"
}
},
"expression": {
"type": "string",
"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.",
"examples": [
"Patient",
"Address"
]
},
"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})$"
}
},
"includeRelations": {
"type": "boolean",
"default": false
},
"includeMixins": {
"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."
},
"sortAttr": {
"type": "string",
"enum": [
"Label",
"CreationTime",
"UpdateTime",
""
]
},
"sortDesc": {
"type": "boolean",
"default": false
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 250,
"default": 50
},
"page": {
"type": "integer",
"minimum": 1,
"default": 1,
"description": "1-based page number. The response includes 'total' (the total match count) so you can compute how many pages there are."
},
"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."
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢whoami
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.
Esquema de entrada
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢suggest_ontology_terms(graphProjectId, nodeId, label, description, ontologies, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"nodeId": {
"type": "string",
"description": "The schema node to ground. Its label is used as the query. Provide this OR label."
},
"label": {
"type": "string",
"description": "A raw term label to search for. Provide this OR nodeId."
},
"description": {
"type": "string",
"description": "Optional description text to refine the search ranking."
},
"ontologies": {
"type": "string",
"description": "Optional comma-separated ontology ids to restrict to, e.g. 'efo,mondo,hp'."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10,
"description": "Maximum candidates to return (1-50)."
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢export_shex(graphProjectId, spaceId, nodeIds, includeCardinality, typeConstraint, ...)
Export project data as a ShEx (Shape Expressions) schema string.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
},
"nodeIds": {
"type": "array",
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space).",
"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})$"
}
},
"includeCardinality": {
"type": "boolean",
"description": "Whether to emit ShEx cardinality markers (?, *, +). Defaults to true."
},
"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."
},
"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."
},
"linkMode": {
"type": "string",
"enum": [
"shape",
"iri"
],
"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)."
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢export_sql(graphProjectId, spaceId, nodeIds)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
},
"nodeIds": {
"type": "array",
"description": "Optional type node ids to export; omit to export all types (optionally scoped to a space).",
"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})$"
}
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢export_owl(graphProjectId, spaceId)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢export_rml(graphProjectId, spaceId, baseIri, sourceKind, sourceTemplate, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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})$"
},
"baseIri": {
"type": "string",
"description": "Namespace subject IRIs are built under, e.g. https://data.example.gov/id"
},
"sourceKind": {
"type": "string",
"enum": [
"csv",
"json",
"xml",
"sql",
"sql-query"
]
},
"sourceTemplate": {
"type": "string",
"description": "Path or table per type, with {type} substituted, e.g. data/{type}.csv"
},
"sourceForm": {
"type": "string",
"enum": [
"shorthand",
"rml-io"
],
"description": "shorthand (default) is what RML engines accept today; rml-io is the newer structured source form"
}
},
"required": [
"graphProjectId"
],
"additionalProperties": false
}🟢generate_synapse_manifests(graphProjectId, sourceFormat, sourceSchema, typeId)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"sourceFormat": {
"type": "string",
"description": "jsonschema | shex | avro | jsonld | sql | osi | osi-json | owl | linkml | odm"
},
"sourceSchema": {
"type": "string",
"description": "The source schema text."
},
"typeId": {
"type": "string",
"description": "Generate manifests for this type only (matched by id or label). Omit for every type."
}
},
"required": [
"graphProjectId",
"sourceFormat",
"sourceSchema"
],
"additionalProperties": false
}🟢transform_schema(graphProjectId, sourceFormat, sourceSchema, targetFormat, vendor, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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"
},
"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)."
},
"synapseName": {
"type": "string",
"description": "For synapse output: the schema name segment of the $id (default: derived from the root type)."
},
"synapseVersion": {
"type": "string",
"description": "For synapse output: the semver segment of the $id (default 0.0.1; Synapse rejects re-registering an existing version)."
},
"targetHintFormat": {
"type": "string",
"description": "Format of the optional target hint schema."
},
"targetHintSchema": {
"type": "string",
"description": "The schema to map toward. Required for inferred mapping."
},
"mappingKind": {
"type": "string",
"description": "inferred (default) | explicit | ai"
},
"guide": {
"type": "string",
"description": "For explicit mapping: the SIA mapping guide as JSON text. For ai mapping: optional free-text guidance for the model."
},
"caseInsensitive": {
"type": "boolean",
"description": "Inferred mapping: ignore label case (default true)."
}
},
"required": [
"graphProjectId",
"sourceFormat",
"sourceSchema",
"targetFormat"
],
"additionalProperties": false
}🟢schema_library_query_project(projectId)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"projectId": {
"type": "string",
"description": "The SchemaLibrary project ID"
}
},
"required": [
"projectId"
]
}🟢schema_library_get_metadata_options(category)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "Filter by metadata category (optional)",
"enum": [
"AccessMethod",
"AccessType",
"Audience",
"Domains",
"Format",
"License",
"ModelSize",
"Type"
]
}
}
}🟢schema_library_get_classifications(nameFilter)
Get available classification options for SchemaLibrary projects, used to categorize and tag projects. Optionally filter by classification name (partial match supported).
Esquema de entrada
{
"type": "object",
"properties": {
"nameFilter": {
"type": "string",
"description": "Filter by classification name (optional - partial match supported)"
}
}
}🟢schema_library_projects_section(title, graphProjectType, pageSize, page, classificationIds, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Search by project title (partial match)"
},
"graphProjectType": {
"type": "string",
"description": "Graph project type filter (e.g. 'Public', 'Private')"
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 250,
"default": 10
},
"page": {
"type": "integer",
"minimum": 1,
"default": 1
},
"classificationIds": {
"type": "string",
"description": "Comma-separated classification IDs"
},
"onlyFavoriteProjects": {
"type": "boolean",
"default": false,
"description": "Authenticated only"
},
"onlyMyProjects": {
"type": "boolean",
"default": false,
"description": "Authenticated only"
},
"isExternal": {
"type": "boolean"
},
"isFeatured": {
"type": "boolean"
},
"publishState": {
"type": "string",
"enum": [
"Published",
"Unpublished",
"All"
],
"default": "All"
},
"sortBy": {
"type": "string",
"enum": [
"Trending",
"RecentlyCreated",
"RecentlyUpdated"
],
"default": "RecentlyUpdated"
},
"typeId": {
"type": "string"
},
"licenseId": {
"type": "string"
},
"modelSizeId": {
"type": "string"
},
"accessTypeId": {
"type": "string"
},
"accessMethodId": {
"type": "string"
},
"formatIds": {
"type": "string",
"description": "Comma-separated format IDs"
},
"domainIds": {
"type": "string",
"description": "Comma-separated domain IDs"
},
"audienceIds": {
"type": "string",
"description": "Comma-separated audience IDs"
}
}
}🟢schema_library_get_use_case_types
Get available use case types for SchemaLibrary projects. Use these types when creating new use cases for a project.
Esquema de entrada
{
"type": "object",
"properties": {}
}⚪contact_sales(contact_name, contact_email, company, need, calling_agent_name, ...)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"contact_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"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."
},
"company": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The contact's company or organization."
},
"need": {
"type": "string",
"minLength": 1,
"maxLength": 2000,
"description": "What help is needed, in your own words — the plan limit, missing capability, or question that brought you 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)."
},
"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."
},
"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."
}
},
"required": [
"contact_name",
"contact_email",
"company",
"need",
"consent"
],
"additionalProperties": false
}🟢run_code(graphProjectId, code, dryRun)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"graphProjectId": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"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."
}
},
"required": [
"graphProjectId",
"code"
],
"additionalProperties": false
}Comunidad
Evidencia