Permute developer platform

Build on trusted business data

Give applications and agents a governed way to discover clean sources, ask business questions, find evidence, and retrieve exact rows.

Start building Explore the API

Quickstart

Authenticate and make your first request in minutes.

Get started

Guides

Follow complete workflows for analysis, uploads, search, and SQL.

View guides

API reference

Browse request and response examples generated from the public contract.

View endpoints

Evidence search

Retrieve ranked, citable support from accessible workspace sources.

Search guide

Choose an interface

Use the highest-level interface that fits

The SDK, MCP server, and REST API share the same curated contract and permission boundary. Choose based on who is interacting with Permute.

Preferred

TypeScript SDK

The happy path for programmatic integrations, including uploads, polling, and typed responses.

End users

MCP

The convenient interface for people asking questions of trusted workspace data from an AI client.

Raw interface

REST API

The underlying HTTP contract for custom clients, unsupported runtimes, and low-level control.

One client, trusted scope

Start with your workspace

The same curated contract powers the REST API, TypeScript SDK, these docs, and promoted MCP tools.

15: Public endpoints
6: MCP tools
1.0.0-beta: API version

typescript

import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(
  process.env.PERMUTE_WORKSPACE_ID!,
);

const sources = await client.sources.list();