@creature-run/sdk

Core Creature SDK for MCP apps.

This package is platform-specific and provides a generalized SDK foundation for runtime capabilities in Creature-hosted apps. It does not depend on open-mcp-app.

The architecture is module-oriented:

• sdk.kv: runtime key-value APIs (currently available)
• additional modules can be added without changing package boundaries (for example auth/session, runtime metadata, or future platform services)

Install

npm install @creature-run/sdk

Usage

import { sdk } from "@creature-run/sdk";

const isReady = sdk.kv.isAvailable();
if (isReady) {
  await sdk.kv.set({ key: "todos:1", value: JSON.stringify({ title: "Hello" }) });
  const value = await sdk.kv.get({ key: "todos:1" });
  const keys = await sdk.kv.list({ prefix: "todos:" });
}

Runtime Environment Variables

• CREATURE_API_BASE_URL
• CREATURE_APP_ACCESS_TOKEN
• CREATURE_APP_REFRESH_TOKEN

The SDK automatically refreshes access tokens via POST /v1/app-runtime/token/refresh when it receives 401.