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

stdio · local

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

// claude_desktop_config.json / .mcp.json — run from a local checkout
// (git clone … && pnpm install && pnpm build:packages)
{
  "mcpServers": {
    "hoba": {
      "command": "node",
      "args": ["/path/to/hoba.work/packages/mcp/dist/index.js", "--dir", "/path/to/hoba.work"]
    }
  }
}

Available Tools:

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

Packages are not published to npm yet; the npx @hoba/mcp form will work once they are.

Command Line Interface (CLI)

pnpm build:packages && node packages/cli/dist/cli.js --help

hoba search "reposted" — Find matching entities

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

hoba show M-001 — Inspect mechanism specifications

hoba validate --strict — Validate content, DAG, loop declarations and mirror parity

Add --json to any command for machine-readable output.

Raw Graph Exports

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