ontoboom-mcp 0.2.0

MCP server for accessing OntoBoom Studio ontologies and the public Hub registry via Model Context Protocol

OntoBoom MCP Server

Access your OntoBoom ontologies directly from Claude Desktop and other MCP-compatible AI assistants via the Model Context Protocol.

Features

• List Projects & Ontologies - Browse your accessible projects and ontologies
• Get Ontology Data - Retrieve classes, properties, and full ontology models
• Export Formats - Export ontologies as Turtle, JSON-LD, RDF/XML, or JSON
• Search - Search for classes across all your ontologies
• Secure - Uses your OntoBoom API token for authentication

Installation

Using pip

pip install ontoboom-mcp

Using uvx (recommended for Claude Desktop)

No installation required - uvx runs directly:

uvx ontoboom-mcp

Setup

1. Generate an API Token

1. Log in to OntoBoom
2. Click your avatar → API Tokens
3. Click Generate Token
4. Enter a name (e.g., "Claude Desktop")
5. Select the projects you want to access
6. Copy the token (shown only once!)

2. Configure Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the OntoBoom MCP server:

{
  "mcpServers": {
    "ontoboom": {
      "command": "uvx",
      "args": ["ontoboom-mcp"],
      "env": {
        "ONTOBOOM_API_TOKEN": "obt_your_token_here"
      }
    }
  }
}

Alternative using pip installation:

{
  "mcpServers": {
    "ontoboom": {
      "command": "ontoboom-mcp",
      "env": {
        "ONTOBOOM_API_TOKEN": "obt_your_token_here"
      }
    }
  }
}

3. Restart Claude Desktop

Close and reopen Claude Desktop to load the MCP server.

Usage

Once configured, you can ask Claude about your ontologies:

• "What projects do I have in OntoBoom?"
• "List the ontologies in my Research project"
• "What classes are in the Medical Terms ontology?"
• "Export my Product Catalog ontology as Turtle"
• "Search for classes related to 'customer' across all my ontologies"

Available Tools

Tool	Description
list_projects	List all accessible projects
list_ontologies	List ontologies in a project
get_ontology	Get full ontology metadata and model
get_classes	Get all classes from an ontology
get_properties	Get object and data properties
export_ontology	Export as Turtle, JSON-LD, XML, or JSON
search_classes	Search classes across all ontologies

Available Resources

The server also exposes ontologies as MCP resources:

URI Pattern	Description
ontoboom://ontology/{id}	Full ontology model
ontoboom://ontology/{id}/classes	Classes only
ontoboom://ontology/{id}/properties	Properties only
ontoboom://ontology/{id}/turtle	Turtle export

Environment Variables

Variable	Required	Description
ONTOBOOM_API_TOKEN	Yes	Your OntoBoom API token
ONTOBOOM_API_URL	No	API URL (default: https://api.ontoboom.com)

Development

Local Development

# Clone the repository
git clone https://github.com/bojannyc/ontoboom.git
cd ontoboom/mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install in development mode
pip install -e .

# Run the server
ONTOBOOM_API_TOKEN=obt_xxx ontoboom-mcp

Testing with MCP Inspector

npx @modelcontextprotocol/inspector uvx ontoboom-mcp

License

MIT License - see LICENSE for details.

Links

• OntoBoom - Visual Ontology Design
• OntoBoom API Docs - REST API Documentation
• Model Context Protocol - MCP Specification
• Report Issues