Overview - Tembo Docs

Base URLs

Tembo API and self-hosted deployments use the same API operations and schemas.

Tembo API: https://api.tembo.io
Self-hosted: https://{deployment-origin}/api/public-api

Self-hosted deployments use their own deployment origin and currently require the additional /api/public-api path prefix.

Authentication

For the Tembo API, create an API key from Settings > API Keys in the hosted Tembo dashboard. For self-hosted, create an API key in your deployment’s own dashboard.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.tembo.io/v1/sessions

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://tembo.example.com/api/public-api/v1/sessions

TypeScript SDK

npm install @tembo-io/sdk

Set the TEMBO_API_KEY environment variable to your API key. Keep it on your server, not in browser code or source control.

import Tembo from '@tembo-io/sdk';

const client = new Tembo();

const sessions = await client.sessions.list({ limit: '5' });
console.log(sessions);

MCP server

Connect AI clients to the public Tembo API through the hosted MCP server using OAuth or an API key.

Connect to Tembo MCP

Configure the MCP endpoint and authentication for hosted or self-hosted Tembo.

Rate limits

100 requests per minute per API key. 1,000 requests per hour per organization.

⌘I

​Base URLs

​Authentication

​TypeScript SDK

​MCP server