SDK Configuration Reference

All MuBit SDKs (Python, Node.js, Rust) share a consistent configuration model based on environment variables and constructor options.

Environment variables

Variable	Required	Default	Description
`MUBIT_API_KEY`	yes	—	API key in format `mbt_<instance>_<key_id>_<secret>`
`MUBIT_ENDPOINT`	no	`https://api.mubit.ai`	Base endpoint for both HTTP and gRPC (SDK resolves protocol automatically)
`MUBIT_TRANSPORT`	no	`auto`	Transport selection: `auto`, `http`, or `grpc`
`MUBIT_HTTP_ENDPOINT`	no	`https://api.mubit.ai`	Override HTTP-specific endpoint
`MUBIT_GRPC_ENDPOINT`	no	`grpc.api.mubit.ai:443`	Override gRPC-specific endpoint

When MUBIT_ENDPOINT is set, it serves as the default for both HTTP and gRPC. The protocol-specific overrides (MUBIT_HTTP_ENDPOINT, MUBIT_GRPC_ENDPOINT) take precedence when set.

Transport selection

The transport option controls how the SDK communicates with MuBit:

Value	Behavior
`auto` (default)	SDK probes the endpoint and selects gRPC if available, falling back to HTTP
`http`	Force HTTP/REST transport
`grpc`	Force gRPC transport

Python
Node / TS
Rust

from mubit import Client

# Auto transport (default)
client = Client(api_key="mbt_...")

# Force gRPC
client = Client(api_key="mbt_...", transport="grpc")

# Force HTTP with custom endpoint
client = Client(
    api_key="mbt_...",
    transport="http",
    endpoint="https://custom.api.mubit.ai",
)

import { Client } from "@mubit-ai/sdk";

// Auto transport (default)
const client = new Client({ api_key: process.env.MUBIT_API_KEY });

// Force gRPC
const client = new Client({ api_key: "mbt_...", transport: "grpc" });

// Force HTTP with custom endpoint
const client = new Client({
  api_key: "mbt_...",
  transport: "http",
  endpoint: "https://custom.api.mubit.ai",
});

use mubit_sdk::{Client, ClientConfig};

// From environment (reads MUBIT_API_KEY, MUBIT_ENDPOINT, etc.)
let client = Client::connect(ClientConfig::from_env()?).await?;

// Explicit gRPC
let config = ClientConfig::new("grpc.api.mubit.ai:443")
    .api_key("mbt_...")
    .transport("grpc");
let client = Client::connect(config).await?;

Endpoint defaults

Context	HTTP endpoint	gRPC endpoint
Hosted (production)	`https://api.mubit.ai`	`grpc.api.mubit.ai:443`
Hosted (dev)	`https://api.dev.mubit.ai`	`grpc.api.dev.mubit.ai:443`
Local	`http://127.0.0.1:3000`	`127.0.0.1:50051`

Both hosted endpoints use TLS. Local endpoints are plaintext by default.

Constructor options

Beyond environment variables, SDK constructors accept these options:

Option	Type	Description
`api_key`	string	API key (overrides `MUBIT_API_KEY`)
`endpoint`	string	Base endpoint (overrides `MUBIT_ENDPOINT`)
`transport`	string	Transport selection (overrides `MUBIT_TRANSPORT`)
`run_id`	string	Default run ID for all operations
`agent_id`	string	Default agent ID
`user_id`	string	Default user ID for scoping

Resolution order

Configuration resolves in this order (first wins):

Explicit constructor argument
Protocol-specific env var (MUBIT_HTTP_ENDPOINT / MUBIT_GRPC_ENDPOINT)
Base env var (MUBIT_ENDPOINT)
Built-in default (https://api.mubit.ai)

Next steps

See Getting started for quick setup.
See gRPC Transport Guide for gRPC-specific guidance.
See Control HTTP reference for the full HTTP API surface.

Overview

Learn the basics

Build with MuBit

Go deeper

Platform

Help

SDK Configuration Reference

Environment variables

Transport selection

Endpoint defaults

Constructor options

Resolution order

Next steps

Overview

Learn the basics

Build with MuBit

Go deeper

Platform

Help

​Environment variables

​Transport selection

​Endpoint defaults

​Constructor options

​Resolution order

​Next steps

Environment variables

Transport selection

Endpoint defaults

Constructor options

Resolution order

Next steps