Skip to content
OntoSkills

MCP With Claude Code

OntoMCP With Claude Code

Install

Install the runtime first:

Terminal window
npx ontoskills install mcp

This gives you the managed runtime binary:

~/.ontoskills/bin/ontomcp

Register The Server

Recommended command:

Terminal window
claude mcp add --scope local ontoskills \
  ~/.ontoskills/bin/ontomcp

If you want to force a specific ontology root:

Terminal window
claude mcp add --scope local ontoskills \
  ~/.ontoskills/bin/ontomcp \
  -- --ontology-root ~/.ontoskills/ontoskills

Verify

Terminal window
claude mcp get ontoskills
claude mcp list

Expected state:

Status: ✓ Connected

What Claude Code Can Use

Once connected, Claude Code can call:

  • search_skills
  • get_skill_context
  • evaluate_execution_plan
  • query_epistemic_rules

Troubleshooting

Connection fails

Check:

  • ~/.ontoskills/bin/ontomcp exists
  • ~/.ontoskills/ontoskills/ exists
  • index.enabled.ttl or compiled .ttl files exist

Ontology not found

Run with an explicit root:

Terminal window
~/.ontoskills/bin/ontomcp --ontology-root ~/.ontoskills/ontoskills

Rebuilt binary but Claude still behaves strangely

Remove and re-add the MCP server, or restart Claude Code. A stale background process can keep the old binary alive.