# Treza MCP

[![npm version](https://camo.githubusercontent.com/7d8a0332279bbb444e4fb70bee61e16eb6638e6e9263fd52b4835f6040f2ebb0/68747470733a2f2f62616467652e667572792e696f2f6a732f2534307472657a612532466d63702e737667)](https://badge.fury.io/js/%40treza%2Fmcp) [![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

Model Context Protocol (MCP) server for Treza Enclaves. Lets AI agents manage hardware-isolated TEEs, verify cryptographic attestations, and interact with the Treza platform — all through natural tool calls.

### Quick Start

#### With Claude Desktop / Cursor / Any MCP Client

Add to your MCP configuration:

```
{
  "mcpServers": {
    "treza": {
      "command": "npx",
      "args": ["@treza/mcp"],
      "env": {
        "TREZA_BASE_URL": "https://app.trezalabs.com"
      }
    }
  }
}
```

#### As a Standalone Server

```
npm install -g @treza/mcp
treza-mcp
```

### Environment Variables

| Variable         | Default                     | Description                     |
| ---------------- | --------------------------- | ------------------------------- |
| `TREZA_BASE_URL` | `https://app.trezalabs.com` | Treza Platform API URL          |
| `TREZA_TIMEOUT`  | `30000`                     | Request timeout in milliseconds |

### Available Tools

#### Enclave Management

| Tool                     | Description                                               |
| ------------------------ | --------------------------------------------------------- |
| `treza_list_enclaves`    | List all enclaves owned by a wallet address               |
| `treza_get_enclave`      | Get detailed info about a specific enclave                |
| `treza_create_enclave`   | Create a new AWS Nitro Enclave with hardware-isolated TEE |
| `treza_update_enclave`   | Update enclave name, description, or config               |
| `treza_delete_enclave`   | Permanently delete a terminated enclave                   |
| `treza_enclave_action`   | Pause, resume, or terminate an enclave                    |
| `treza_get_enclave_logs` | Retrieve logs filtered by source type                     |

#### Attestation & Verification

| Tool                            | Description                                                                |
| ------------------------------- | -------------------------------------------------------------------------- |
| `treza_get_attestation`         | Get attestation document with PCR measurements and certificate chain       |
| `treza_verify_attestation`      | Full cryptographic verification with compliance checks (SOC2, HIPAA, FIPS) |
| `treza_get_verification_status` | Quick trust level check                                                    |

#### Platform

| Tool                   | Description                                    |
| ---------------------- | ---------------------------------------------- |
| `treza_list_providers` | List available enclave providers and regions   |
| `treza_get_provider`   | Get provider details and config schema         |
| `treza_list_tasks`     | List scheduled tasks                           |
| `treza_create_task`    | Create a cron-scheduled task in an enclave     |
| `treza_list_api_keys`  | List scoped API keys                           |
| `treza_create_api_key` | Create a new API key with specific permissions |

### MCP Resources

The server also exposes browsable resources that give agents ambient context:

| Resource URI                                | Description               |
| ------------------------------------------- | ------------------------- |
| `treza://enclaves/{walletAddress}`          | All enclaves for a wallet |
| `treza://enclaves/{enclaveId}/details`      | Full enclave details      |
| `treza://enclaves/{enclaveId}/attestation`  | Attestation document      |
| `treza://enclaves/{enclaveId}/verification` | Verification status       |

### Example Agent Interactions

An AI agent using the Treza MCP server can:

```
"Create me a Nitro Enclave in us-west-2 for my trading bot"
→ treza_create_enclave

"Is my enclave verified? What's the trust level?"
→ treza_verify_attestation

"Show me the last 20 error logs from my enclave"
→ treza_get_enclave_logs

"Pause my enclave to save costs while I'm not using it"
→ treza_enclave_action (pause)
```

### Architecture

```
AI Agent (Claude, Cursor, etc.)
    │
    ▼
┌──────────────┐
│  @treza/mcp  │  ← MCP Server (this package)
│  16 tools    │
│  4 resources │
└──────┬───────┘
       │ HTTP
       ▼
┌──────────────────┐
│  Treza Platform  │  ← https://app.trezalabs.com
│  REST API        │
└──────┬───────────┘
       │
       ▼
┌──────────────────┐
│  AWS Nitro       │  ← Hardware-isolated TEEs
│  Enclaves        │
└──────────────────┘
```

### Development

```
git clone https://github.com/treza-labs/treza-sdk.git
cd treza-sdk/packages/mcp
npm install
npm run build
npm start
```

### Related

* [@treza/sdk](https://www.npmjs.com/package/@treza/sdk) — Core SDK
* [Treza Platform](https://app.trezalabs.com/) — Web dashboard
* [OpenAPI Spec](https://app.trezalabs.com/.well-known/openapi.json) — Full API schema
* [Agent Manifest](https://app.trezalabs.com/.well-known/ai-plugin.json) — Machine-readable capabilities

### License

MIT

### Readme

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trezalabs.com/developers/treza-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.