Guides
Quickstart

Quickstart

Go from zero to your first API call in a few minutes.

1. Get an API key

Sign up (opens in a new tab) and pick a tier. The Free tier is permanent and needs no card. After checkout you'll see your key once — store it somewhere safe (Pluto keeps only a hash; if you lose it, mint a new one from the dashboard).

2. Make a call (REST)

Every endpoint is documented in the API Reference — plain REST with a bearer key works from any language today:

curl https://api.joinpluto.com/v1/usage \
  -H "Authorization: Bearer $PLUTO_API_KEY"

3. TypeScript SDK (coming to npm)

The TypeScript SDK is MIT-licensed and the npm publish is landing shortly. Until it is on npm, use plain REST (above) or the hosted MCP server. Once published:

npm install pluto-sdk-ts
import { Pluto } from 'pluto-sdk-ts';
 
const pluto = new Pluto({ apiKey: process.env.PLUTO_API_KEY! });
 
// Check your plan + remaining quota for the current billing period.
const usage = await pluto.observability.usage();
console.log(`${usage.tier}: ${usage.actions_used}/${usage.actions_limit} actions used`);

4. Watch your usage

Every call is metered against your tier's quota for the current Stripe billing period. Your live usage, recent calls, and account health are on the dashboard (opens in a new tab).

Next steps

Agent quickstartAuthentication