Quickstart
Install the SDK, set two environment variables, and run your first mission in under 5 minutes.
API Reference
Explore the full versioned Praxa Integration Gateway REST API, including mission lifecycle endpoints and event streaming.
TypeScript SDK
A typed HTTP and server-sent-event client for submitting and observing missions from Node.js applications.
MCP Contracts
MCP 2025-03-26 tool and JSON-RPC contracts for integrating Praxa missions into model-context-protocol workflows.
Get started in four steps
1
Get your gateway URL and token
Obtain your Praxa Integration Gateway HTTPS origin and a short-lived delegated OAuth access token from your Praxa deployment administrator. You’ll export both as environment variables before running any code.
2
Install the SDK
Add
@praxa/sdk to your Node.js 20+ project with your package manager of choice:3
Create your first mission
Instantiate a
PraxaClient with your gateway URL and token provider, then call createMission with a goal specification and a resource budget. The SDK returns a runId and initial status immediately.4
Stream mission events
Use
missionEvents to consume the bounded, resumable server-sent-event stream for your mission:Explore further
Mission Concepts
Understand the mission model: goal specs, resource budgets, idempotency keys, and the event stream lifecycle.
Task Automation
See how Praxa fits into automated task pipelines and recurring workflows without embedding credentials.
CLI Reference
Use
@praxa/cli to create, inspect, and cancel missions from the command line or CI pipelines.