OntoBoom MCP Server

Access your OntoBoom ontologies and the public Hub registry 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
• Hub Discovery — Search and explore public ontologies on the OntoBoom Hub (no auth required)
• Secure — Uses your OntoBoom API token for authenticated access

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. Go to Playground → API Key
   (or: avatar → API Tokens in the app)
3. Click Generate Token, name it (e.g. "Claude Desktop"), select your projects
4. 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

{
  "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

Your private 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"

Public Hub registry (no token required for these)

• "Search the Hub for insurance ontologies"
• "What's in the @ontoboom namespace?"
• "Show me the classes in @ontoboom/supply-chain"
• "What versions of @ontoboom/fibo are available?"
• "Find ontologies about healthcare on the Hub"

Available Tools

Private ontology tools (require API token)

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

Hub tools (public, no auth required)

Tool	Description
search_hub	Search public ontologies by keyword or domain
explore_hub	Browse featured, popular, and recent ontologies
list_hub_namespace	List ontologies in a namespace (e.g. @ontoboom)
get_hub_ontology	Get full manifest for a Hub ontology
list_hub_versions	List all published versions of a Hub ontology

Available Resources

URI Pattern	Description
ontoboom://ontology/{id}	Full ontology model (private)
ontoboom://ontology/{id}/classes	Classes only
ontoboom://ontology/{id}/properties	Properties only
ontoboom://ontology/{id}/turtle	Turtle export
ontoboom://hub/@{namespace}/{slug}	Hub ontology manifest (public)
ontoboom://hub/@{namespace}/{slug}@{version}	Specific version manifest

Environment Variables

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

* Hub tools work without a token. A token is only required for accessing your private ontologies.

Development

git clone https://github.com/bojannyc/ontoboom.git
cd ontoboom/mcp-server

python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows

pip install -e .

ONTOBOOM_API_TOKEN=obt_xxx ontoboom-mcp

Testing with MCP Inspector

npx @modelcontextprotocol/inspector uvx ontoboom-mcp

License

MIT — see LICENSE for details.

Links

• OntoBoom
• Hub — public ontology registry
• Playground — API keys, Hub discovery, API explorer
• API Docs
• Model Context Protocol
• Report Issues