Powered by Zoomin Software. For more details please contactZoomin

Semaphore 5.13 MCP Server Guide

Available MCP Tools

  • Last Updated: November 20, 2026
  • 3 minute read
    • Semaphore
    • Version 5.13
    • Documentation

The Semaphore MCP Server provides tools that allow MCP-compatible AI clients to work with Knowledge Model Management (KMM) resources. The server is identified as MCP_Knowledge_Model_Management.

You can ask an AI client to explore models, find or modify concepts, manage relationships and metadata, work with tasks, or import RDF data. The AI client selects and invokes the appropriate MCP tools based on your request. Available operations depend on the tools exposed by the server and the permissions associated with your Semaphore access token.

Available capabilities

Capability What you can do
Models and tasks Find and manage knowledge models, inspect their settings, work in tasks, review changes, and commit task changes to the master model.
Concepts Find, inspect, create, classify, and delete concepts.
Concept classes and schemes Inspect and create classes and schemes, and manage top concepts.
Labels Retrieve and manage concept labels and label relationship types.
Relationships Create and manage relationship types and relationships between concepts.
Metadata Inspect metadata type definitions and add, update, or remove concept metadata values.
RDF import Import Turtle/RDF data into a model or task.

For examples of requests you can give an AI client, see Using MCP Tools: Examples.

MCP tool reference

The following tables summarize the tools available in each area. You do not need to select these tools manually when using an MCP-compatible AI client.

Models and tasks

Tool Capability
getAllModelsIndexedByURI List knowledge models and their URIs.
getModelByURI Retrieve model details.
getModelUri Find a model URI by name.
manageModelsOrTasks Create or delete models or tasks.
updateModelSettings Update model or task settings, including permissions.
linkModel Link a model into the current model.
addLanguagesToModel Add languages for labels and notations.
getAllTasksIndexedByURI List tasks associated with a model.
commitTaskToMaster Commit task changes to the master model.
getEnvironments Retrieve publishing environments.
getListOfChangesInModelSince Retrieve changes recorded since a specified date.

Concepts

Tool Capability
getConceptCount Count concepts in a model.
getConceptAsJsonsPaginated Retrieve concepts in pages.
getConceptAsJsonByUri Retrieve a concept by URI.
getConceptsByLabelMatch Find concepts by preferred label.
addConceptWithClassToModelAndReturnURI Create a concept with a specified class.
addConceptsAsChildren Create child concepts under parent concepts.
addConceptClassToExistingConcept Assign a class to an existing concept.
deleteConcept Delete a concept.

Concept classes and schemes

Tool Capability
getAllCurrentClasses List available concept classes.
addConceptClasses Create concept classes.
getAllConceptSchemes List concept schemes.
addConceptSchemesAndReturnURIs Create concept schemes.
addConceptsToConceptSchemeAndReturnURIs Create top concepts in a scheme.
updateConceptScheme Update a scheme label.
removeTopConceptFromConceptScheme Remove a scheme-to-top-concept relationship without deleting the concept.
deleteConceptSchemeByUri Delete an empty concept scheme.

Labels and relationships

Tool Capability
getLabelsForConcept Retrieve concept labels.
addLabelsToConcepts Add labels to concepts.
getAllLabelRelationshipTypes List label relationship types.
deleteAltLabelType Delete an alternative label type.
getAllAssociativeRelationshipTypes List permitted associative relationship types.
createRelationshipType Create a relationship type.
updateRelationshipType Update a relationship type label.
deleteRelationshipType Delete a hierarchical or associative relationship type.
addRelationshipsBetweenConcepts Create relationships between concepts.
deleteRelationshipBetweenConcepts Remove a relationship between concepts.

Metadata

Tool Capability
getAllMetadataTypes Retrieve metadata type definitions.
addMetadataTypes Create metadata types.
updateMetadataType Update a metadata type label.
deleteMetadataType Delete a metadata type.
addMetadataValue Add metadata values to concepts.
updateMetadataValue Replace existing metadata values.
deleteMetadataValue Remove metadata values from concepts.

Metadata value operations support string, boolean, integer, date, decimal, and uri data types. The type must match the metadata property.

RDF import

Tool Capability
getTurtleModelExample Retrieve an illustrative SKOS-XL Turtle example.
importTriples Atomically import Turtle/RDF data into a master model or task.

Important considerations

  • Permissions: The AI client can perform only operations permitted for the authenticated user.
  • Master models and tasks: Changes to a master model may take effect directly. Where appropriate, use a task to review changes before committing them to the master model. Deleting a task discards uncommitted changes; deleting a model also removes its tasks.
  • Concepts and schemes: A concept can be deleted only when it has no children. A concept scheme can be deleted only when it has no children.
  • Concept metadata: Concept retrieval results may omit metadata values, including skos:definition. getAllMetadataTypes returns metadata type definitions, not values assigned to concepts. Inspect the Metadata section in KMM to verify current values.
  • Change history: getListOfChangesInModelSince returns recorded changes, not a complete snapshot of the model.
  • Bulk imports: Review the target model or task and RDF content before importing. Imports are atomic, but large requests may encounter timeouts; split large datasets into smaller batches. The example returned by getTurtleModelExample is illustrative and should not be imported unchanged. Import operations should be initiated only when explicitly requested by the user.
Alert