Developer API & MCP

Machine Interfaces & SDK

Access the HOBA knowledge graph via REST static endpoints, OpenAPI 3.1, Model Context Protocol (MCP), CLI, and npm.

Static REST API

/openapi.json →

Deterministic, read-only static JSON endpoints served directly from CDN with zero runtime database latency.

GET /api/v1/artifacts View JSON

GET /api/v1/barriers View JSON

GET /api/v1/mechanisms View JSON

GET /api/v1/graph View JSON

Model Context Protocol (MCP) Server

mcp.hoba.work

Connect AI coding assistants and autonomous agents directly to the HOBA Knowledge Graph.

// claude_desktop_config.json or antigravity mcp config
{
  "mcpServers": {
    "hoba": {
      "command": "npx",
      "args": ["-y", "@hoba/mcp"]
    }
  }
}

Available Tools:

search_registry, get_node, explain_observation, find_compatible_mechanisms, get_diagnostic_probes, find_patterns, get_interventions, traverse_graph, get_methodology.

Command Line Interface (CLI)

npm install -g @hoba/cli

hoba search "reposted" — Find matching entities

hoba explain A-004 --stage technical — Run HOBA diagnostic protocol

hoba show M-001 — Inspect mechanism specifications

Raw Graph Exports

registry.json registry.ndjson nodes.csv graph.graphml