# CoreModels MCP server

CoreModels schema editor: nodes, mixins, relations, JSON Schema import/export. Sign-in required.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-aramai-schematica-coremodels
- Website: https://www.aramai.net/products/coremodels

## Install
- Endpoint: https://go.coremodels.io/mcp-admin
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://go.coremodels.io/mcp-admin
- Header: Authorization

## Tools
- export_json_ld (Export JSON-LD) - 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. Endpoint: https://go.coremodels.io/mcp-admin
- fetch_json_ld_import_profiles (Fetch JSON-LD Import Profiles) - Fetch JSON-LD import/export profiles available for a project. Endpoint: https://go.coremodels.io/mcp-admin
- export_jsonschema (Export JSON Schema) - Export project data as a JSON Schema string. Endpoint: https://go.coremodels.io/mcp-admin
- fetch_json_schema_import_profiles (Fetch JSON Schema Import Profiles) - Fetch JSON Schema import/export profiles available for a project. Endpoint: https://go.coremodels.io/mcp-admin
- import_jsonschema (Import JSON Schema) - Imports a JSON Schema into a space Endpoint: https://go.coremodels.io/mcp-admin
- validate_json (Validate JSON) - Validate a JSON document against a project's stored JSON Schema.

The schema is regenerated from the project using the supplied configTypeId (the export profile id) and rootNodeId. Provide the JSON to validate as a serialized string. Endpoint: https://go.coremodels.io/mcp-admin
- bulk_create (Bulk Create) - Create multiple nodes, relations, and mixin values in one atomic operation.

When to use:
- Creating more than one node.
- Any creation that includes relations and/or mixins.
- For a single node with no relations/mixins, prefer create_node.

Required ids come from:
- get_mixins_and_relation_groups: relationGroupId, mixinId, and each mixin column id.
- get_project_summary or search_nodes (nodeType=Space): spaceIds, plus any existing nodeIds you want to reference.

Relation endpoints (fromNodeId / toNodeId) may be either:
- ids of nodes created elsewhere in this same payload, or
- ids of nodes already in the project.
 Endpoint: https://go.coremodels.io/mcp-admin
- create_mixin_type (Create Mixin Type) - Create a new mixin type. Check existing mixins first with get_mixins_and_relation_groups to avoid duplicates. Mixins are reusable property sets applicable to any node. Endpoint: https://go.coremodels.io/mcp-admin
- generate_project_ai_summary (Generate Project Ai Summary) - Generate an AI summary of the project (from its types, elements and taxonomies) and save it as the project's markdown AI summary. Returns the generated summary. If a summary already exists it is returned unchanged unless regenerateIfExists=true. Requires the user to have a Claude API key configured in ChatBot settings. Endpoint: https://go.coremodels.io/mcp-admin
- get_mixins_and_relation_groups (Get Mixins & Relation Groups) - 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. Endpoint: https://go.coremodels.io/mcp-admin
- get_project_summary (Get Project Summary) - 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. Endpoint: https://go.coremodels.io/mcp-admin
- list_projects (List Projects) - 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). Paged: page is 1-based; increment page up to the returned totalPages to get all results. Endpoint: https://go.coremodels.io/mcp-admin
- create_mixin_value (Create Mixin Value) - Create a mixin value for a node. mixinId and column ids come from get_mixins_and_relation_groups. A node can have multiple mixins; each mixin can have multiple columns. Endpoint: https://go.coremodels.io/mcp-admin
- remove_mixin_value (Remove Mixin Value) - Remove one or more mixin column values from a node. mixinId and column ids come from get_mixins_and_relation_groups. This does not delete the mixin definition itself. Endpoint: https://go.coremodels.io/mcp-admin
- create_node (Create Node) - Create a new node. Empty/omitted spaceIds = default space; MUST be empty when nodeType is 'Space'. Endpoint: https://go.coremodels.io/mcp-admin
- update_node (Update Node) - Update an existing node's label and/or its space assignments. Omitted fields are unchanged. spaceIds replaces (not merges) existing assignments; empty array = default space. At least one of label or spaceIds must be provided. Endpoint: https://go.coremodels.io/mcp-admin
- remove_node (Remove Node) - Suspend a node. Endpoint: https://go.coremodels.io/mcp-admin
- create_relation (Create Relation) - Create a directed relation fromNodeId → toNodeId. relationGroupId is the relation template; list templates with get_mixins_and_relation_groups. Endpoint: https://go.coremodels.io/mcp-admin
- remove_relation (Remove Relation) - Remove a relation between two nodes. Endpoint: https://go.coremodels.io/mcp-admin
- search_nodes (Search Nodes) - Search nodes in a CoreModels project. Returns compact positional arrays; the response "format" field describes the layout.

Filters (provide at least one; 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 to specific spaces

Optional flags: includeRelations, includeMixins, sortAttr, sortDesc, pageSize.

Pagination:
- First call: omit pagingToken.
- If the response has a pagingToken, more pages exist. Repeat the same call with that exact token to get the next page.
- If the response has no pagingToken, this was the last page. Endpoint: https://go.coremodels.io/mcp-admin
- export_shex (Export ShEx) - Export project data as a ShEx (Shape Expressions) schema string. Endpoint: https://go.coremodels.io/mcp-admin

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.aramai-schematica
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 20, 2026
- Source: https://registry.modelcontextprotocol.io