OpenServ Agent SDK

What it does

The OpenServ Agent SDK is a TypeScript framework for building non-deterministic, autonomous AI agents on the OpenServ platform. Agents built with this SDK can reason, make decisions, collaborate with other agents, manage tasks, handle file operations, and call external integrations — all within a structured, strongly-typed runtime.

Crucially, agents can consume MCP servers as tool sources: configure any stdio, http, or sse MCP server in the agent constructor and its tools are automatically registered as agent capabilities.

Tools

The SDK is not a standalone MCP server that exposes tools; instead it provides a runtime to build agents that use MCP servers. Key capabilities exposed by agents built with the SDK include:

• addCapability / addCapabilities — register typed tool functions
• generate() — delegate LLM inference to OpenServ runtime (no OpenAI key required)
• createTask / updateTaskStatus / addLogToTask — full task lifecycle management
• uploadFile / getFiles / deleteFile — workspace file operations
• getSecrets / getSecretValue — secure secrets access
• callIntegration — proxy calls to third-party integrations (Twitter, GitHub, etc.)
• sendChatMessage / requestHumanAssistance — chat and human-in-the-loop flows
• mcpServers config — auto-register MCP server tools as agent capabilities

Installation

// claude_desktop_config.json — run a custom agent built with the SDK as an MCP server
{
  "mcpServers": {
    "my-openserv-agent": {
      "command": "npx",
      "args": ["-y", "my-openserv-agent-package"]
    }
  }
}

Install the SDK in your project:

npm install @openserv-labs/sdk

Supported hosts

The SDK builds HTTP-based agent servers deployable anywhere. MCP connectivity via mcpServers config supports any MCP-compatible host.