Reference

SDKs

Client libraries for integrating with Conductor programmatically.

Available SDKs

TypeScript

npm i @conductor/sdk

Full type support, MCP client utilities, and plugin helpers.

Python

pip install conductor-sdk

Async client with webhook handling and event streaming.

REST API

HTTP / JSON

Use any HTTP client. OpenAPI spec at /openapi.json.

TypeScript Example

index.ts

import { ConductorClient } from "@conductor/sdk";

const client = new ConductorClient({
  transport: "stdio",
  command: "npx",
  args: ["-y", "@useconductor/conductor"],
});

await client.connect();

// Call a tool
const result = await client.callTool("filesystem.read", {
  path: "./package.json",
});
console.log(result.content[0].text);

// List all available tools
const tools = await client.listTools();
console.log(tools.map((t) => t.name));

// Subscribe to events (HTTP transport only)
client.on("tool.complete", (event) => {
  console.log("Tool completed:", event.data.tool);
});

await client.disconnect();

Python Example

main.py

from conductor import ConductorClient

# HTTP transport
client = ConductorClient(
    transport="http",
    base_url="http://localhost:3000",
)

async with client:
    # Call a tool
    result = await client.call_tool(
        "filesystem.read",
        path="./package.json",
    )
    print(result.content[0].text)

    # List tools
    tools = await client.list_tools()
    print([t.name for t in tools])

REST API Examples

curl

# List tools
curl http://localhost:3000/tools

# Call a tool
curl -X POST http://localhost:3000/tools/filesystem.read \
  -H "Content-Type: application/json" \
  -d '{"path": "./package.json"}'

# Health check
curl http://localhost:3000/health

# Audit log
curl http://localhost:3000/audit

Next: Guides