DocumentationAI-native development platform

MARS SDK

The MARS SDK is the developer-facing TypeScript surface for agents that need to verify clearance, write journal entries, and recall governed memory through a MARS-compatible gateway.

Install path

The SDK currently ships inside the public MARS repository under kernel/native/mars-sdk. It is intentionally small so developers can read the full gateway behavior before integrating it.

Use the SDK

Create a MarsAgent with an agent ID, VISA token, and gateway URL. The agent can then verify clearance, write journal events, and recall memory.

Setup

import { MarsAgent } from "./kernel/native/mars-sdk/index.ts";

const agent = new MarsAgent({
  agentId: "agent-demo",
  visaToken: Deno.env.get("MARS_VISA_TOKEN") ?? "",
  gatewayUrl: "https://mcp.multinex.ai",
});

if (await agent.verifyClearance("L2")) {
  await agent.logJournalEntry("task.accepted", { taskId: "demo-001" });
  const memories = await agent.recallMemory("deployment lessons", 5);
}

Test-first development

The SDK accepts an injected fetch function so tests can prove exact URLs, headers, and fail-closed parsing without calling a real gateway.

Setup

cd kernel/native/mars-sdk
deno test --allow-net index.test.ts

How to evaluate MARS SDK

Use this page to decide whether the product solves the immediate bottleneck: forgotten AI context, sensitive-data risk, or uncoordinated agent work. Then follow the lowest-risk setup path and prove one workflow before expanding.

Buyer checklist

MARS SDK decision path

MARS SDK is a fit when the value is clear to the user who has to do the work, not only to the team buying the platform.

Confirm the user problem this product removes first.
Run one practical setup path and verify the outcome.
Add the next Multinex layer only after the first proof is useful.