@protoboxai/sdk

Public TypeScript SDK for Protobox — managed MCP servers: tools, toolsets, knowledge, prompts, workspaces, and chat.

Install

npm install @protoboxai/sdk

Quick start

import { ProtoboxSDK } from '@protoboxai/sdk';

const sdk = new ProtoboxSDK({
  apiKey: process.env.PROTOBOX_API_KEY!,
  baseUrl: 'https://platform.protobox.ai', // or http://localhost:3100
});

// MCP-focused surface
const tools = await sdk.tools.list();
const resources = await sdk.knowledge.list();
const prompts = await sdk.prompts.list();

Modules

| Module | Purpose | |--------|---------| | tools / toolsets | HTTP/OpenAPI tools exposed via MCP | | knowledge | Knowledge base (documents, URLs, files) | | prompts | MCP prompt templates | | agents | Workspace agents | | mcp | MCP server helpers | | chat | Text chat with agents |

Sync from upstream

When chanl-sdk changes, refresh this package from the monorepo root:

make sync-public-sdk
make build-public-sdk

Publish

Package is publish-ready (publishConfig.access: public). Bump version in package.json before npm publish from packages/protobox-sdk.