Docs & SDK

From install to first graph in minutes

The Nexum SDK compiles sources into a typed graph draft and exposes it to agents through native MCP servers.

1. Install

$ npm install @x12i/nexum

2. Compile your first source

import { Nexum } from "@x12i/nexum";

const nexum = new Nexum({ apiKey: process.env.NEXUM_API_KEY });

const draft = await nexum.compile({
  sources: [
    { type: "openapi", path: "./specs/billing.yaml" },
    { type: "markdown", path: "./docs/**/*.md" },
    { type: "repo", url: "github.com/acme/core-service" }
  ]
});

console.log(draft.nodes.length, "nodes compiled");
console.log(draft.applyPlan.creates, "pending creates");

3. Query with deterministic traversal

const path = await nexum.traverse({
  from: "customer:8841",
  relation: "OWNS -> FILED",
});

// path.confidence === "exact"
// path.sourceHashes -> full provenance chain

4. Connect via MCP

Nexum ships a native MCP server so any orchestration framework can query the graph without a custom connector.

{
  "mcpServers": {
    "nexum": {
      "command": "npx",
      "args": ["@x12i/nexum-mcp"],
      "env": { "NEXUM_API_KEY": "..." }
    }
  }
}

Graph Draft

A strictly typed, reviewable output — never applied automatically.

Apply Plan

The explicit set of creates, merges, and conflicts pending approval.

MCP Server

Native compatibility with multi-agent orchestration frameworks.

Need governed access, not just a graph?

Layer LSCP's MCP servers on top for bound extractions and traceable provenance.

LSCP Docs →