{
  "markdown": "<p align=\"center\">\n  <a href=\"https://sutra.shivnathtathe.com\">\n    <img src=\"assets/readme-hero.png\" width=\"100%\" alt=\"Sutra - one private memory layer for every AI agent\">\n  </a>\n</p>\n\n<p align=\"center\">\n  <strong>Open MCP integration files for the hosted Sutra service.</strong><br>\n  Connect private, portable context to the AI agents you already use.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://sutra.shivnathtathe.com\">Website</a> &nbsp;&middot;&nbsp;\n  <a href=\"https://sutra.shivnathtathe.com/integrations\">All integrations</a> &nbsp;&middot;&nbsp;\n  <a href=\"https://smithery.ai/servers/sutra/sutra\">Smithery</a> &nbsp;&middot;&nbsp;\n  <a href=\"https://glama.ai/mcp/connectors/com.onrender.sutra-c3or/sutra\">Glama</a> &nbsp;&middot;&nbsp;\n  <a href=\"https://sutra.shivnathtathe.com/support\">Support</a>\n</p>\n\n<p align=\"center\">\n  <img alt=\"MCP Streamable HTTP\" src=\"https://img.shields.io/badge/MCP-Streamable_HTTP-192033?style=flat-square\">\n  <img alt=\"OAuth 2.1\" src=\"https://img.shields.io/badge/auth-OAuth_2.1-d94f2b?style=flat-square\">\n  <img alt=\"Ten typed tools\" src=\"https://img.shields.io/badge/tools-10_typed-71a7d6?style=flat-square\">\n  <img alt=\"MIT licensed integrations\" src=\"https://img.shields.io/badge/integrations-MIT-192033?style=flat-square\">\n</p>\n\n## Connect Sutra\n\n```text\nhttps://sutra-c3or.onrender.com/mcp\n```\n\n| Connection    | Use when                                       | What happens                                                                                    |\n| ------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------- |\n| **OAuth 2.1** | Your client supports remote MCP authorization. | The client opens Sutra in your browser, requests consent, and stores its grant.                 |\n| **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. |\n\n1. [Create a Sutra account](https://sutra.shivnathtathe.com/login).\n2. Choose a client configuration below.\n3. Complete OAuth or enter a dedicated API key when prompted.\n4. Confirm the client discovers 10 tools.\n5. Try: `Use Sutra to list my project clusters. Ask before saving anything.`\n\n> [!IMPORTANT]\n> Never put a real Sutra API key, OAuth token, memory export, or password in a checked-in configuration file.\n\n## Choose Your Client\n\n| Client                   | Authentication          | Configuration                                        |\n| ------------------------ | ----------------------- | ---------------------------------------------------- |\n| Cursor                   | OAuth                   | [`clients/cursor-mcp.json`](clients/cursor-mcp.json) |\n| OpenCode                 | OAuth with DCR and PKCE | [`clients/opencode.json`](clients/opencode.json)     |\n| VS Code / GitHub Copilot | Revocable API key       | [`clients/vscode-mcp.json`](clients/vscode-mcp.json) |\n| Claude Code              | Revocable API key       | Guided CLI setup                                     |\n\n<details>\n<summary><strong>Cursor</strong> &nbsp; OAuth</summary>\n\nInstall this repository as an [Agent Plugin](https://cursor.com/docs/plugins/building), or add the following to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"sutra\": {\n      \"url\": \"https://sutra-c3or.onrender.com/mcp\"\n    }\n  }\n}\n```\n\nConnect the server and complete Sutra's browser authorization flow.\n\n</details>\n\n<details>\n<summary><strong>OpenCode</strong> &nbsp; OAuth + DCR + PKCE</summary>\n\nMerge [`clients/opencode.json`](clients/opencode.json) into your global or project `opencode.json`:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"sutra\": {\n      \"type\": \"remote\",\n      \"url\": \"https://sutra-c3or.onrender.com/mcp\",\n      \"oauth\": {}\n    }\n  }\n}\n```\n\nAuthorize and inspect the connection:\n\n```sh\nopencode mcp auth sutra\nopencode mcp list\n```\n\n</details>\n\n<details>\n<summary><strong>VS Code and GitHub Copilot</strong> &nbsp; API key</summary>\n\nCopy [`clients/vscode-mcp.json`](clients/vscode-mcp.json) to `.vscode/mcp.json`, or merge it into your user MCP configuration:\n\n```json\n{\n  \"inputs\": [\n    {\n      \"id\": \"sutra-api-key\",\n      \"type\": \"promptString\",\n      \"description\": \"Sutra API key\",\n      \"password\": true\n    }\n  ],\n  \"servers\": {\n    \"sutra\": {\n      \"type\": \"http\",\n      \"url\": \"https://sutra-c3or.onrender.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${input:sutra-api-key}\"\n      }\n    }\n  }\n}\n```\n\nStart Sutra from the MCP configuration editor. VS Code requests the key through a masked input instead of storing it in the file.\n\n</details>\n\n<details>\n<summary><strong>Claude Code</strong> &nbsp; API key</summary>\n\nUse the Sutra CLI for guided setup:\n\n```sh\nnpm install -g @shivnathtathe/sutra-cli\nsutra connect claude-code\n```\n\nThe CLI requests a dedicated key and safely writes the supported local configuration. It does not send your key to this repository.\n\n</details>\n\nNeed another agent? Sutra publishes current instructions for [all 22 tested integrations](https://sutra.shivnathtathe.com/integrations).\n\n## Confirmed Compatibility\n\n<p align=\"center\">\n  <a href=\"https://sutra.shivnathtathe.com/integrations\">\n    <img src=\"assets/integration-grid.svg\" width=\"100%\" alt=\"The 22 AI clients independently tested with Sutra\">\n  </a>\n</p>\n\n<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>\n\n## Tool Surface\n\nSutra exposes 10 typed tools. Read operations retrieve only the context needed for the current request. Write, upload, and export operations require deliberate user intent.\n\n| Context and memory  | Access | Purpose                                                     |\n| ------------------- | ------ | ----------------------------------------------------------- |\n| `read_context`      | Read   | Load the user's shared identity context.                    |\n| `search_memory`     | Read   | Find targeted memories by keyword.                          |\n| `list_clusters`     | Read   | Discover available project clusters.                        |\n| `get_cluster`       | Read   | Load one known project cluster.                             |\n| `write_observation` | Write  | Save one durable preference, decision, correction, or fact. |\n| `export_all`        | Export | Export all user memories for data portability.              |\n\n| Reusable skills      | Access | Purpose                                                            |\n| -------------------- | ------ | ------------------------------------------------------------------ |\n| `list_skills`        | Read   | Discover skills explicitly enabled by the user.                    |\n| `get_skill`          | Read   | Load an enabled skill and its resource index.                      |\n| `get_skill_resource` | Read   | Read one resource referenced by an enabled skill.                  |\n| `upload_skill`       | Write  | Upload a new immutable skill version after explicit authorization. |\n\n## Data Boundaries\n\n| Sutra does                                                            | Sutra does not                                      |\n| --------------------------------------------------------------------- | --------------------------------------------------- |\n| Stores observations deliberately saved by a user or authorized agent. | Copy every conversation from a connected client.    |\n| Isolates unrelated context in named project clusters.                 | Share one cluster with every request automatically. |\n| Shows the source agent, tags, and activity for stored memories.       | Hide writes inside an opaque client profile.        |\n| Supports revocable OAuth grants and per-client API keys.              | Require one permanent credential across all agents. |\n| Provides an explicit full export for portability.                     | Lock user memory to one AI vendor.                  |\n\nRead [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.\n\n## Repository Contents\n\n```text\n.\n|-- plugin.json             # Agent Plugins 1.0 manifest\n|-- mcp.json                # Portable Streamable HTTP connection\n|-- server.json             # Official MCP Registry metadata\n|-- clients/\n|   |-- cursor-mcp.json\n|   |-- opencode.json\n|   `-- vscode-mcp.json\n|-- docs/\n|   |-- client-support.md\n|   `-- security-and-data.md\n`-- assets/\n    |-- integration-grid.svg\n    |-- readme-hero.png       # Pixel-tested GitHub banner\n    |-- readme-hero.svg       # Editable banner source\n    `-- sutra-logo.png\n```\n\n## Open Integration Layer\n\nThis 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).\n\nThe 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).\n\n---\n\n<p align=\"center\">\n  <strong>Context should outlast the chat window.</strong><br>\n  <a href=\"https://sutra.shivnathtathe.com/login\">Create your private workspace</a>\n</p>\n",
  "bytes": 9637,
  "sha": "719ba0680a73da3576a57c4503da8a5dcf6b67ff8f44bd9658010112ebb7929c",
  "repo_slug": "shivnathtathe/sutra-mcp-integrations",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_shivnathtathe_sutra_7da4db99/readme"
}