---
title: "Developers | Jetstack AI Docs"
description: "Build on Jetstack AI with the REST API, MCP server and CLI: audit portals, browse and reuse HubSpot assets, and drive Projects from your own tools."
url: "https://jetstack.ai/docs/developers/"
---

# Developers

Everything you can do in the Jetstack app is also available to your own code and AI agents. There are three ways in, and all three use the same API keys and scopes.

REST API

Call `https://api.jetstack.ai` directly. Three APIs cover the platform: **Core** (portals, HubSpot browse, import, library, deploy, tasks and Portal Audit), **Projects** and **Workflow Audit**.

MCP server

Connect Claude, ChatGPT, Cursor or any MCP client to `https://mcp.jetstack.ai` and work with portals, audits and Projects in a conversation.

CLI

Install `@jetstackai/cli` to run audits, imports and deployments from the terminal, in scripts and in Claude Code.

## Quick start

1. In the Jetstack app, open **Settings → Access Tokens** and create an API key. Pick the scopes the key needs, or start with the **Read-only** preset.
2. Check the key works:

Terminal window

```
curl   https://api.jetstack.ai/v1/health   \
   -H   "Authorization: Bearer jsai_your_api_key"
```

The response confirms the key and lists its scopes:

```
{
   "data" : {
     "status" :  "ok" ,
     "version" :  "1.0.0" ,
     "orgId" :  "org_…" ,
     "keyPrefix" :  "jsai_abc…xyz" ,
     "scopes" : [ "portals:read" ,  "audit:read" ]
   }
}
```

3. List your connected HubSpot portals:

Terminal window

```
curl   https://api.jetstack.ai/v1/portals   \
   -H   "Authorization: Bearer jsai_your_api_key"
```

From here, start a Portal Audit with `POST /v1/audit/runs`, browse a portal with `GET /v1/hubspot/{portalId}/{assetType}`, or open a Project with the [Projects API](https://jetstack.ai/docs/developers/projects-api).

## Guides and reference

[Authentication ](https://jetstack.ai/docs/developers/authentication)API keys, scopes, presets, the optional Instance ID, rate limits and errors.

[API reference ](https://jetstack.ai/api)Every endpoint for the Core, Projects and Workflow Audit APIs, with a built-in request console.

[Projects API ](https://jetstack.ai/docs/developers/projects-api)Plan, generate, deploy and verify HubSpot builds programmatically.

[Workflow Audit API ](https://jetstack.ai/docs/developers/workflow-audit-api)Run workflow audits and read scores, findings, dependencies and paths.

[MCP server ](https://jetstack.ai/docs/developers/mcp)Connect an AI client and use Jetstack tools in a conversation.

[CLI ](https://jetstack.ai/docs/developers/cli)Install, sign in and run Jetstack from the terminal.

## OpenAPI specs

Each API is published as an OpenAPI 3.1 document you can load into your own tooling or code generator:

| API                | Spec                                                                              |
| ------------------ | --------------------------------------------------------------------------------- |
| Core API           | [`/openapi/core.json`](https://jetstack.ai/openapi/core.json)                     |
| Projects API       | [`/openapi/projects.json`](https://jetstack.ai/openapi/projects.json)             |
| Workflow Audit API | [`/openapi/workflow-audit.json`](https://jetstack.ai/openapi/workflow-audit.json) |
