Open format · v1

Get a spec. Ship it.

Envelope is the open format for AI agents. Your PM designs the team — roles, models, prompts, access policies — and exports a single JSON file. You attach credentials and wire it in.

Deploy from a spec Schema reference

npm install @openenvelope/schema

How it works

Design. Export. Implement.

Design

A PM or team lead designs the agent team in Envelope — roles, models, prompts, reporting lines, and tool access — without writing any code.

Export

They export the team as a single `.envelope.json` file: a versioned, Git-friendly spec you can drop straight into CI or review in a PR.

Implement

You attach credentials, wire up tools, and run it via MCP, the REST API, or your own runtime. The spec tells you exactly what each agent needs.

The format

A team definition is just JSON.

The Envelope Team Definition Schema captures everything needed to implement your agents — roles, models, prompts, access policies, and escalation paths — in a single, versionable file.

IDE validation and autocomplete via $schema
CI/CD integration with the npm validator
Git-native — diff, review, and audit every change
Semver versioning built in

Full schema reference

team.envelope.json

{
  "$schema": "https://schema.openenvelope.org/team/v1.json",
  "name": "Support Tier",
  "slug": "support-tier",
  "version": "1.0.0",
  "agents": [
    {
      "key": "triage",
      "name": "Triage Agent",
      "role": "specialist",
      "model": "anthropic:claude-sonnet-4-5",
      "prompt": "Classify and route incoming support tickets."
    },
    {
      "key": "lead",
      "name": "Support Lead",
      "role": "manager",
      "model": "anthropic:claude-opus-4-5",
      "reportsToKey": "triage"
    }
  ]
}

Integration options

Three ways to integrate a spec.

The format is open. Pick the integration path that fits your stack.

MCP server

Add the Envelope MCP server to Claude or ChatGPT once. Design and manage teams directly from your AI assistant — no per-team integration work.

MCP reference

REST API

Call agents directly over HTTP. Authenticate with an API key, pass a conversation thread, get a response. Stateless and composable.

API docs

Your own runtime

The schema is open. Parse the spec, provision agents in your stack, and run them however you like. Use the JSON schema to validate definitions.

Schema reference

MCP server · live

Your teams are accessible from Claude and ChatGPT.

The Envelope MCP server connects Claude.ai or ChatGPT to your workspace. Add it once and design, update, or browse your team specs directly from any conversation — no per-team integration work.

MCP reference Claude Code skill

Everything you need

Ready to implement?

Read the deployment guide to go from a fresh spec file to a live implementation in minutes.

Deployment guide API reference