Meta Agent Tools
PT

Back to the catalog

Sutra

Private, portable memory and reusable skills for AI agents.

Open source Repository Open in the app JSON README (API)

About

Private, portable memory and reusable skills for AI agents.

Details

Kind
MCP servers
Topic
AI, RAG & memory
Publisher
shivnathtathe
Origin
official
Category
ferramentas
Transport
http
Version
1.0.1
Stars
1
Last push
2026-09-03T20:19:23Z
Repository state
ativo
License
MIT
Added
2026-09-03 20:00:52
Updated
2026-09-03 21:00:53
Origin id
io.github.shivnathtathe/sutra

README

<p align="center">
  <a href="https://sutra.shivnathtathe.com">
    <img src="assets/readme-hero.png" width="100%" alt="Sutra - one private memory layer for every AI agent">
  </a>
</p>

<p align="center">
  <strong>Open MCP integration files for the hosted Sutra service.</strong><br>
  Connect private, portable context to the AI agents you already use.
</p>

<p align="center">
  <a href="https://sutra.shivnathtathe.com">Website</a> &nbsp;&middot;&nbsp;
  <a href="https://sutra.shivnathtathe.com/integrations">All integrations</a> &nbsp;&middot;&nbsp;
  <a href="https://smithery.ai/servers/sutra/sutra">Smithery</a> &nbsp;&middot;&nbsp;
  <a href="https://glama.ai/mcp/connectors/com.onrender.sutra-c3or/sutra">Glama</a> &nbsp;&middot;&nbsp;
  <a href="https://sutra.shivnathtathe.com/support">Support</a>
</p>

<p align="center">
  <img alt="MCP Streamable HTTP" src="https://img.shields.io/badge/MCP-Streamable_HTTP-192033?style=flat-square">
  <img alt="OAuth 2.1" src="https://img.shields.io/badge/auth-OAuth_2.1-d94f2b?style=flat-square">
  <img alt="Ten typed tools" src="https://img.shields.io/badge/tools-10_typed-71a7d6?style=flat-square">
  <img alt="MIT licensed integrations" src="https://img.shields.io/badge/integrations-MIT-192033?style=flat-square">
</p>

## Connect Sutra

```text
https://sutra-c3or.onrender.com/mcp
```

| Connection    | Use when                                       | What happens                                                                                    |
| ------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **OAuth 2.1** | Your client supports remote MCP authorization. | The client opens Sutra in your browser, requests consent, and stores its grant.                 |
| **API key**   | Your client expects an `Authorization` header. | You create a dedicated, revocable key in Sutra and store it with the client's secret mechanism. |

1. [Create a Sutra account](https://sutra.shivnathtathe.com/login).
2. Choose a client configuration below.
3. Complete OAuth or enter a dedicated API key when prompted.
4. Confirm the client discovers 10 tools.
5. Try: `Use Sutra to list my project clusters. Ask before saving anything.`

> [!IMPORTANT]
> Never put a real Sutra API key, OAuth token, memory export, or password in a checked-in configuration file.

## Choose Your Client

| Client                   | Authentication          | Configuration                                        |
| ------------------------ | ----------------------- | ---------------------------------------------------- |
| Cursor                   | OAuth                   | [`clients/cursor-mcp.json`](clients/cursor-mcp.json) |
| OpenCode                 | OAuth with DCR and PKCE | [`clients/opencode.json`](clients/opencode.json)     |
| VS Code / GitHub Copilot | Revocable API key       | [`clients/vscode-mcp.json`](clients/vscode-mcp.json) |
| Claude Code              | Revocable API key       | Guided CLI setup                                     |

<details>
<summary><strong>Cursor</strong> &nbsp; OAuth</summary>

Install this repository as an [Agent Plugin](https://cursor.com/docs/plugins/building), or add the following to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "sutra": {
      "url": "https://sutra-c3or.onrender.com/mcp"
    }
  }
}
```

Connect the server and complete Sutra's browser authorization flow.

</details>

<details>
<summary><strong>OpenCode</strong> &nbsp; OAuth + DCR + PKCE</summary>

Merge [`clients/opencode.json`](clients/opencode.json) into your global or project `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sutra": {
      "type": "remote",
      "url": "https://sutra-c3or.onrender.com/mcp",
      "oauth": {}
    }
  }
}
```

Authorize and inspect the connection:

```sh
opencode mcp auth sutra
opencode mcp list
```

</details>

<details>
<summary><strong>VS Code and GitHub Copilot</strong> &nbsp; API key</summary>

Copy [`clients/vscode-mcp.json`](clients/vscode-mcp.json) to `.vscode/mcp.json`, or merge it into your user MCP configuration:

```json
{
  "inputs": [
    {
      "id": "sutra-api-key",
      "type": "promptString",
      "description": "Sutra API key",
      "password": true
    }
  ],
  "servers": {
    "sutra": {
      "type": "http",
      "url": "https://sutra-c3or.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sutra-api-key}"
      }
    }
  }
}
```

Start Sutra from the MCP configuration editor. VS Code requests the key through a masked input instead of storing it in the file.

</details>

<details>
<summary><strong>Claude Code</strong> &nbsp; API key</summary>

Use the Sutra CLI for guided setup:

```sh
npm install -g @shivnathtathe/sutra-cli
sutra connect claude-code
```

The CLI requests a dedicated key and safely writes the supported local configuration. It does not send your key to this repository.

</details>

Need another agent? Sutra publishes current instructions for [all 22 tested integrations](https://sutra.shivnathtathe.com/integrations).

## Confirmed Compatibility

<p align="center">
  <a href="https://sutra.shivnathtathe.com/integrations">
    <img src="assets/integration-grid.svg" width="100%" alt="The 22 AI clients independently tested with Sutra">
  </a>
</p>

<p align="center"><sub>11 web agents use OAuth. 11 CLI and desktop agents use dedicated API keys. Product names and marks belong to their respective owners.</sub></p>

## Tool Surface

Sutra exposes 10 typed tools. Read operations retrieve only the context needed for the current request. Write, upload, and export operations require deliberate user intent.

| Context and memory  | Access | Purpose                                                     |
| ------------------- | ------ | ----------------------------------------------------------- |
| `read_context`      | Read   | Load the user's shared identity context.                    |
| `search_memory`     | Read   | Find targeted memories by keyword.                          |
| `list_clusters`     | Read   | Discover available project clusters.                        |
| `get_cluster`       | Read   | Load one known project cluster.                             |
| `write_observation` | Write  | Save one durable preference, decision, correction, or fact. |
| `export_all`        | Export | Export all user memories for data portability.              |

| Reusable skills      | Access | Purpose                                                            |
| -------------------- | ------ | ------------------------------------------------------------------ |
| `list_skills`        | Read   | Discover skills explicitly enabled by the user.                    |
| `get_skill`          | Read   | Load an enabled skill and its resource index.                      |
| `get_skill_resource` | Read   | Read one resource referenced by an enabled skill.                  |
| `upload_skill`       | Write  | Upload a new immutable skill version after explicit authorization. |

## Data Boundaries

| Sutra does                                                            | Sutra does not                                      |
| --------------------------------------------------------------------- | --------------------------------------------------- |
| Stores observations deliberately saved by a user or authorized agent. | Copy every conversation from a connected client.    |
| Isolates unrelated context in named project clusters.                 | Share one cluster with every request automatically. |
| Shows the source agent, tags, and activity for stored memories.       | Hide writes inside an opaque client profile.        |
| Supports revocable OAuth grants and per-client API keys.              | Require one permanent credential across all agents. |
| Provides an explicit full export for portability.                     | Lock user memory to one AI vendor.                  |

Read [Security and data boundaries](docs/security-and-data.md), the [Privacy Policy](https://sutra.shivnathtathe.com/privacy), and the [Terms of Service](https://sutra.shivnathtathe.com/terms) before connecting sensitive workflows.

## Repository Contents

```text
.
|-- plugin.json             # Agent Plugins 1.0 manifest
|-- mcp.json                # Portable Streamable HTTP connection
|-- server.json             # Official MCP Registry metadata
|-- clients/
|   |-- cursor-mcp.json
|   |-- opencode.json
|   `-- vscode-mcp.json
|-- docs/
|   |-- client-support.md
|   `-- security-and-data.md
`-- assets/
    |-- integration-grid.svg
    |-- readme-hero.png       # Pixel-tested GitHub banner
    |-- readme-hero.svg       # Editable banner source
    `-- sutra-logo.png
```

## Open Integration Layer

This repository contains the open-source manifests, examples, documentation, and artwork needed to connect clients to Sutra. Corrections for changing client formats are welcome; see [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).

The files in this repository are licensed under the [MIT License](LICENSE). The hosted Sutra backend, dashboard, APIs, infrastructure, datasets, service implementation, and trademarks remain proprietary and are not included. The Sutra logo and third-party product names and marks are excluded from the MIT grant; see [NOTICE](NOTICE).

---

<p align="center">
  <strong>Context should outlast the chat window.</strong><br>
  <a href="https://sutra.shivnathtathe.com/login">Create your private workspace</a>
</p>

More