Skip to main content
What you’ll learn:
  • How to install the Metorial JavaScript SDK
  • How to use the SDK in the browser, Node.js, and Deno environments
  • How to make requests to the Metorial API using the SDK
Before you start:External resources:
The Metorial JavaScript SDK provides a type-safe interface for interacting with the Metorial API. Use it to manage your server deployments, create sessions, handle OAuth flows, and integrate MCP tools into your applications. The SDK works across all JavaScript environments including Node.js, browser applications, and Deno.
Explore Node.js Examples: Check out practical examples and sample code in the metorial-node examples directory on GitHub.
1

Install the SDK

Install the SDK using your preferred package manager:
npm install metorial
2

Using the SDK

To use the SDK, import the Metorial class and create an instance with your API key:
import Metorial from 'metorial';

let metorial = new Metorial({
  apiKey: '$$SECRET_TOKEN$$'
});
You can now use the metorial instance to make requests to the Metorial API.
3

Making Requests

The SDK organizes API resources into logical namespaces (like servers, serverImplementations, oauth, etc.). Each resource provides methods for common operations like get(), list(), create(), update(), and delete().
// Get a server by ID
let server = await metorial.servers.get('srv_Rm4Mnheq2bfEPhBhP7SY');

// Update a server instance
let result = await metorial.serverImplementations.update('svi_Rm4Mnheq2bfEPhBhP7SY', {
  name: "updated name",
  description: "updated description"
});
Each method returns a Promise that resolves with the response data. Use async/await or .then() to handle the results.
4

Using TypeScript

The SDK is written in TypeScript and includes type definitions for all API resources. You can use TypeScript to benefit from type checking and IntelliSense support:
import Metorial from 'metorial';

let metorial = new Metorial({
  apiKey: '$$SECRET_TOKEN$$'
});

let server = await metorial.servers.get('srv_Rm4Mnheq2bfEPhBhP7SY');