Sooveryn MCP server

Sooveryn MCP

Sooveryn is a hosted MCP server. Its code is not public: this repository only holds its documentation and configuration examples.

Lasting memory and an AI team for Claude Code.

Sooveryn gives Claude Code a team of AI personas that remembers your project. Soov, the partner and team lead, keeps your decisions and how you work in a lasting memory. He finds them again by words and by meaning, from one session to the next and on every machine.

On paid plans, he consults his teammates (Néo for security, Vera to challenge your ideas, Iris for design, Maria for SEO) or has them debate before deciding, and you can create your own personas and skills.

• Website: https://www.sooveryn.com
• Server: https://mcp.sooveryn.com/mcp (streamable HTTP, API key in a header)
• MCP Registry (registry.modelcontextprotocol.io): com.sooveryn/sooveryn
• Works with Claude Code, VS Code, Orca, Pi, and MCP clients that accept a remote HTTP server with a key

Get started

1. Create a free account at https://www.sooveryn.com and confirm your email address.
2. Create an API key on the API keys page (https://www.sooveryn.com/me/keys). One key per machine is best.
3. Add the configuration of your client, below. Your key acts for your account and reads your memory: keep it out of anything that goes to git.
4. In a session, say Soov Init. The agent writes a sooveryn.md file at the root of the project, keeps it out of git, and loads it at every session through an @sooveryn.md line in CLAUDE.md. From then on, each session starts with Soov and his memory of the project.

Claude Code and Orca

Put your key in an environment variable named SOOVERYNAPIKEY, set where Claude Code starts (your shell profile, for example). Then add .mcp.json at the root of the project (example). Claude Code replaces ${SOOVERYNAPIKEY} when it loads the file, so the file holds no secret:

{
  "mcpServers": {
    "sooveryn": {
      "type": "http",
      "url": "https://mcp.sooveryn.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SOOVERYN_API_KEY}"
      }
    }
  }
}

Orca runs Claude Code, which reads this file.

VS Code

.vscode/mcp.json (example). VS Code ignores the headers of a .mcp.json, so it needs its own file, under the servers key. It asks for your key once, hides it while you type, and stores it securely:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sooveryn-key",
      "description": "Sooveryn API key",
      "password": true
    }
  ],
  "servers": {
    "sooveryn": {
      "type": "http",
      "url": "https://mcp.sooveryn.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sooveryn-key}"
      }
    }
  }
}

Pi

Install its MCP extension. Pi then reads the same .mcp.json as Claude Code.

pi install npm:pi-mcp-adapter

If Pi does not pick the key up from the environment variable, write the key itself in the file, as below.

Other MCP clients

Without X-Project-Scope, the agent passes the project name on each call, as sooveryn.md tells it.

If the key is written in the file

The API keys page of the website gives these files with your key written in. Keep them out of git, in .gitignore:

.mcp.json
.vscode/mcp.json

A key committed once stays in the history, even after you delete the file: revoke it on the API keys page and create a new one.

Tools

Shortened. The full README is on GitHub.