{"_id":"@convolut/convolut-mcp","_rev":"7-9bba173e9de966648216fbd06eb4c552","name":"@convolut/convolut-mcp","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.1":{"name":"@convolut/convolut-mcp","version":"1.0.1","keywords":["mcp","server","convolut","context","ai","claude","claude-desktop","anthropic","mcp-server","context-management"],"author":{"name":"Convolut Team"},"license":"MIT","_id":"@convolut/convolut-mcp@1.0.1","maintainers":[{"name":"andre_le_tech","email":"expdal3@gmail.com"}],"homepage":"https://convolut.app","bugs":{"url":"https://github.com/expdal3/convolut-mcp/issues"},"bin":{"convolut-mcp":"stdio-client.cjs"},"dist":{"shasum":"574426d9a86513675e55e1525cbaa0277b8f2ae8","tarball":"https://registry.npmjs.org/@convolut/convolut-mcp/-/convolut-mcp-1.0.1.tgz","fileCount":9,"integrity":"sha512-h4Z2vtDu8pemhQTAZUx7dT7IyhsBtALmMscifBY8VRZ6+oau58bF/gMStSRKCA/2R4HhmzjET1/wYdl5C07gjw==","signatures":[{"sig":"MEQCIBzNdqQRVSlggjP57in11SHlVVcP74IfWKAIAlx+lVoCAiAF5XrftR1c2coykwBAGe25rf05wwJZiyslivZwCSHE6A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42522},"main":"stdio-client.cjs","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"ee19c22ba5076bc5b1c90f8b71cbcd8e4532a7a8","scripts":{"start":"node stdio-client.cjs"},"_npmUser":{"name":"andre_le_tech","email":"expdal3@gmail.com"},"repository":{"url":"git+https://github.com/expdal3/convolut-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Official MCP server for Convolut Context Bank integration with Claude Desktop and other MCP clients","directories":{},"_nodeVersion":"22.17.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/convolut-mcp_1.0.1_1756113281008_0.20785618900028768","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@convolut/convolut-mcp","version":"1.0.2","keywords":["mcp","server","convolut","context","ai","claude","claude-desktop","anthropic","mcp-server","context-management"],"author":{"name":"Convolut Team"},"license":"MIT","_id":"@convolut/convolut-mcp@1.0.2","maintainers":[{"name":"andre_le_tech","email":"expdal3@gmail.com"}],"homepage":"https://convolut.app","bugs":{"url":"https://github.com/expdal3/convolut-mcp/issues"},"bin":{"convolut-mcp":"stdio-client.cjs"},"dist":{"shasum":"dd43870983b2e031647f4927a6e4ef5f7cf7bcc0","tarball":"https://registry.npmjs.org/@convolut/convolut-mcp/-/convolut-mcp-1.0.2.tgz","fileCount":9,"integrity":"sha512-0gf/Pr1lBlGh05laN5DJ7ZxM3WjgSbKDeY1q4NgOhY4VCdzh2bmYaj4yQSslRZPKjdeGgj9sfNEKvNYPE7bj7Q==","signatures":[{"sig":"MEUCIEzo2XJ+f+Zc3WBhUkNlaMQgfwz66g5UcTVq1x0wmp+pAiEAne5VL1WcjIvwLwVbBHxCTwOgH3+HY3/D+7eSsNn8gi8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45862},"main":"stdio-client.cjs","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"fc4b168f170d2d703913ec30f744f536bdbe4b58","scripts":{"start":"node stdio-client.cjs"},"_npmUser":{"name":"andre_le_tech","email":"expdal3@gmail.com"},"repository":{"url":"git+https://github.com/expdal3/convolut-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Official MCP server for Convolut Context Bank integration with Claude Desktop and other MCP clients","directories":{},"_nodeVersion":"22.17.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/convolut-mcp_1.0.2_1756724139033_0.3901991445755211","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@convolut/convolut-mcp","version":"1.0.3","keywords":["mcp","server","convolut","context","ai","claude","claude-desktop","anthropic","mcp-server","context-management"],"author":{"name":"Convolut Team"},"license":"MIT","_id":"@convolut/convolut-mcp@1.0.3","maintainers":[{"name":"andre_le_tech","email":"expdal3@gmail.com"}],"homepage":"https://convolut.app","bugs":{"url":"https://github.com/expdal3/convolut-mcp/issues"},"bin":{"convolut-mcp":"stdio-client.cjs"},"dist":{"shasum":"5d08c974bfb37a5d288b48a45c943bb725c55217","tarball":"https://registry.npmjs.org/@convolut/convolut-mcp/-/convolut-mcp-1.0.3.tgz","fileCount":9,"integrity":"sha512-LzHtcUq2pDafjYsS4J7SbD2iweVdxZSzJbzVIm/maucMhEaIs+YIh4eHPAD3gc80cVfXLpBG5GEk50afRW7auw==","signatures":[{"sig":"MEUCIBL77AFMkHEwxvwmX/gS+SHqicgDWJLaPj3m4eYWzDQeAiEAmtYqWbyR6ILl2hXYWfiquxq9hbKYcsyUWSKxvuM+p1E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46282},"main":"stdio-client.cjs","type":"commonjs","engines":{"node":">=18.0.0"},"gitHead":"d1f7f39c152a5e3a22311a21c0b56de20e6955d7","scripts":{"start":"node stdio-client.cjs"},"_npmUser":{"name":"andre_le_tech","email":"expdal3@gmail.com"},"repository":{"url":"git+https://github.com/expdal3/convolut-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Official MCP server for Convolut Context Bank integration with Claude Desktop and other MCP clients","directories":{},"_nodeVersion":"22.17.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/convolut-mcp_1.0.3_1758972329064_0.4226329792836958","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@convolut/convolut-mcp","version":"1.0.4","description":"Official MCP server for Convolut Context Bank integration with Claude Desktop and other MCP clients","main":"stdio-client.cjs","type":"commonjs","bin":{"convolut-mcp":"stdio-client.cjs"},"scripts":{"start":"node stdio-client.cjs"},"keywords":["mcp","server","convolut","context","ai","claude","claude-desktop","anthropic","mcp-server","context-management"],"author":{"name":"Convolut Team"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/expdal3/convolut-mcp.git"},"bugs":{"url":"https://github.com/expdal3/convolut-mcp/issues"},"homepage":"https://convolut.app","engines":{"node":">=18.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_id":"@convolut/convolut-mcp@1.0.4","gitHead":"abdda3e494fd7e8ab195e657c8cc83f1d9b7ac88","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-/o8lBT2VQlwencXkzH85RdRCAdmI1DaKi+Pl1CzBnzFUpyBHnvi4FpiaNGtYasouzKAM0ZjiSWkkczEaqSSvsg==","shasum":"7e9768b2f02b0754cbe78fca6308ff96f0832b1d","tarball":"https://registry.npmjs.org/@convolut/convolut-mcp/-/convolut-mcp-1.0.4.tgz","fileCount":9,"unpackedSize":47199,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBPnpbYzbNAKo8pLGW7ubFtBH+AVJTt1DhFVsp3aG3pbAiEA/ox+KfQUKzGypToY5oH6ZcOqkcwJnnvasJyVfLlqVJ0="}]},"_npmUser":{"name":"andre_le_tech","email":"expdal3@gmail.com"},"directories":{},"maintainers":[{"name":"andre_le_tech","email":"expdal3@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/convolut-mcp_1.0.4_1759033540628_0.5301149792787896"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-25T09:14:40.912Z","modified":"2025-09-28T04:25:41.048Z","1.0.0":"2025-08-25T09:05:26.983Z","1.0.1":"2025-08-25T09:14:41.187Z","1.0.2":"2025-09-01T10:55:39.217Z","1.0.3":"2025-09-27T11:25:29.251Z","1.0.4":"2025-09-28T04:25:40.816Z"},"bugs":{"url":"https://github.com/expdal3/convolut-mcp/issues"},"author":{"name":"Convolut Team"},"license":"MIT","homepage":"https://convolut.app","keywords":["mcp","server","convolut","context","ai","claude","claude-desktop","anthropic","mcp-server","context-management"],"repository":{"type":"git","url":"git+https://github.com/expdal3/convolut-mcp.git"},"description":"Official MCP server for Convolut Context Bank integration with Claude Desktop and other MCP clients","maintainers":[{"name":"andre_le_tech","email":"expdal3@gmail.com"}],"readme":"# Convolut MCP Server\n\n[![npm version](https://badge.fury.io/js/@convolut%2Fconvolut-mcp.svg)](https://www.npmjs.com/package/@convolut/convolut-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nOfficial Model Context Protocol (MCP) server for [Convolut Context Bank](https://convolut.app), enabling seamless integration with Claude Desktop and other MCP clients.\n\n## Features\n\n🚀 **11 Powerful Tools** for context management and AI-powered operations:\n\n### Context Management\n- **`list_contexts`** - Search and filter contexts with advanced options\n- **`get_context`** - Retrieve specific context by ID  \n- **`create_context`** - Create new context with content and metadata\n- **`update_context`** - Update existing contexts\n- **`delete_context`** - Delete contexts by ID\n\n### AI-Powered Operations  \n- **`search_contexts`** - Semantic search across your contexts\n- **`consolidate_contexts`** - AI-powered context consolidation and summarization\n- **`plan_from_contexts`** - Generate actionable plans from multiple contexts\n\n### Export & Integration\n- **`export_contexts`** - Export to JSON, XML, TXT, or Markdown formats\n- **`get_raw_url`** - Generate temporary shareable URLs\n- **`get_context_stats`** - Statistical analysis of your contexts\n\n## Quick Start\n\n### Installation\n\n```bash\nnpm install -g @convolut/convolut-mcp\n```\n\n### Claude Desktop Setup\n\n1. Get your Convolut API key from [https://convolut.app](https://convolut.app)\n\n2. Add to your Claude Desktop configuration file:\n\n**Windows:** `%APPDATA%\\\\Claude\\\\claude_desktop_config.json`\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"convolut\": {\n      \"command\": \"npx\",\n      \"args\": [\"@convolut/convolut-mcp\"],\n      \"env\": {\n        \"CONVOLUT_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n3. Restart Claude Desktop\n\n4. Start using Convolut tools in your conversations! 🎉\n\n## Usage Examples\n\n### Search Your Contexts\n```\n\"Search for contexts about machine learning\"\n```\nClaude will use the `search_contexts` tool to find relevant contexts in your Convolut library.\n\n### Create New Context  \n```\n\"Save this conversation as a new context titled 'API Integration Discussion'\"\n```\nClaude will use `create_context` to save the conversation to your Convolut account.\n\n### Generate Plans\n```\n\"Analyze these project contexts and create an actionable plan\"\n```\nClaude will use `consolidate_contexts` and `plan_from_contexts` to analyze multiple contexts and generate structured plans.\n\n## Manual Installation\n\nIf you prefer to install locally:\n\n```bash\n# Clone or download the package\ngit clone https://github.com/expdal3/convolut-mcp.git\ncd convolut-mcp\n\n# Install dependencies (none required - pure Node.js!)\nnpm install\n\n# Test the installation\nCONVOLUT_API_KEY=your_key_here node stdio-client.cjs\n```\n\nThen use the full path in your Claude Desktop config:\n```json\n{\n  \"mcpServers\": {\n    \"convolut\": {\n      \"command\": \"node\", \n      \"args\": [\"/full/path/to/convolut-mcp/stdio-client.cjs\"],\n      \"env\": {\n        \"CONVOLUT_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## API Key Setup\n\n### Get Your API Key\n1. Sign up at [https://convolut.app](https://convolut.app)\n2. Navigate to Settings → API Keys  \n3. Generate a new API key\n4. Copy the key (format: `convolut_sk_...`)\n\n### Environment Variables\nYou can also set the API key as an environment variable:\n\n```bash\n# Windows\nset CONVOLUT_API_KEY=your_api_key_here\n\n# macOS/Linux  \nexport CONVOLUT_API_KEY=your_api_key_here\n```\n\n## Architecture\n\n```\nClaude Desktop (or other MCP Client) → stdio → convolut-mcp (MCP Server) → HTTPS → api.convolut.app\n```\n\nThis MCP server provides a direct, efficient bridge between Claude Desktop and the Convolut API, with no intermediate servers required.\n\n## Requirements\n\n- Node.js 18.0.0 or higher\n- Convolut API key\n- Claude Desktop (or any MCP-compatible client)\n\n## Supported Platforms\n\n- ✅ Windows 10/11\n- ✅ macOS 12+  \n- ✅ Linux (Ubuntu 20.04+)\n\n## Troubleshooting\n\n### Claude Desktop Not Seeing Tools\n1. Verify your `claude_desktop_config.json` syntax is correct\n2. Check that your API key is valid\n3. Restart Claude Desktop completely\n4. Check Claude Desktop logs for errors\n\n### API Key Issues\n```\nError: CONVOLUT_API_KEY environment variable is required\n```\n- Ensure your API key is set in the Claude Desktop config\n- Verify the API key format starts with `conair_sk_`\n- Check for typos in the configuration file\n\n### Connection Issues\n- Verify internet connectivity\n- Check if your firewall blocks HTTPS requests\n- Ensure Node.js version is 18.0.0 or higher\n\n## Development\n\n### Project Structure\n```\nconvolut-mcp/\n├── stdio-client.cjs       # Main MCP server entry point\n├── utils/\n│   └── api-client.cjs     # Convolut API client\n├── tools/\n│   ├── contexts.cjs       # Context management tools\n│   ├── ai-tools.cjs       # AI-powered operations  \n│   └── export.cjs         # Export and statistics\n├── types/\n│   └── convolut.cjs       # Type definitions\n└── README.md\n```\n\n### Contributing\n1. Fork the repository\n2. Create a feature branch  \n3. Make your changes\n4. Test thoroughly\n5. Submit a pull request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- **Documentation:** [https://docs.convolut.app/mcp](https://convolut.app/mcp)\n- **Issues:** [https://github.com/expdal3/convolut-mcp/issues](https://github.com/expdal3/convolut-mcp/issues)\n- **Discord:** [https://discord.gg/convolut-ai](https://discord.gg/nptmrvEE)\n\n## Related Projects\n\n- [Convolut Web App](https://convolut.app) - Main context management platform\n- [Convolut API Documentation](https://convolut.app/apis-mcp) - REST API reference\n- [MCP Specification](https://modelcontextprotocol.io) - Model Context Protocol standard\n\n---\n\n**Made with ❤️ by the Convolut team**","readmeFilename":"README.md"}