Convolut MCP Server

Official Model Context Protocol (MCP) server for Convolut Context Bank, enabling seamless integration with Claude Desktop and other MCP clients.

Features

🚀 11 Powerful Tools for context management and AI-powered operations:

Context Management

• list_contexts - Search and filter contexts with advanced options

• get_context - Retrieve specific context by ID

• create_context - Create new context with content and metadata

• update_context - Update existing contexts

• delete_context - Delete contexts by ID

AI-Powered Operations

• search_contexts - Semantic search across your contexts

• consolidate_contexts - AI-powered context consolidation and summarization

• plan_from_contexts - Generate actionable plans from multiple contexts

Export & Integration

• export_contexts - Export to JSON, XML, TXT, or Markdown formats

• get_raw_url - Generate temporary shareable URLs

• get_context_stats - Statistical analysis of your contexts

Quick Start

Installation

Claude Desktop Setup

1. Get your Convolut API key from https://convolut.app

2. Add to your Claude Desktop configuration file:

Windows: %APPDATA%\\Claude\\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Restart Claude Desktop

4. Start using Convolut tools in your conversations! 🎉

Usage Examples

Search Your Contexts

Claude will use the search_contexts tool to find relevant contexts in your Convolut library.

Create New Context

Claude will use create_context to save the conversation to your Convolut account.

Generate Plans

Claude will use consolidate_contexts and plan_from_contexts to analyze multiple contexts and generate structured plans.

Manual Installation

If you prefer to install locally:

Then use the full path in your Claude Desktop config:

API Key Setup

Get Your API Key

1. Sign up at https://convolut.app

2. Navigate to Settings → API Keys

3. Generate a new API key

4. Copy the key (format: convolut_sk_...)

Environment Variables

You can also set the API key as an environment variable:

Architecture

This MCP server provides a direct, efficient bridge between Claude Desktop and the Convolut API, with no intermediate servers required.

Requirements

• Node.js 18.0.0 or higher

• Convolut API key

• Claude Desktop (or any MCP-compatible client)

Supported Platforms

• ✅ Windows 10/11

• ✅ macOS 12+

• ✅ Linux (Ubuntu 20.04+)

Troubleshooting

Claude Desktop Not Seeing Tools

1. Verify your claude_desktop_config.json syntax is correct

2. Check that your API key is valid

3. Restart Claude Desktop completely

4. Check Claude Desktop logs for errors

API Key Issues

• Ensure your API key is set in the Claude Desktop config

• Verify the API key format starts with conair_sk_

• Check for typos in the configuration file

Connection Issues

• Verify internet connectivity

• Check if your firewall blocks HTTPS requests

• Ensure Node.js version is 18.0.0 or higher

Development

Project Structure

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Test thoroughly

5. Submit a pull request

License

MIT License - see LICENSE file for details.

Support

• Documentation: https://docs.convolut.app/mcp

• Issues: https://github.com/expdal3/convolut-mcp/issues

• Discord: https://discord.gg/convolut-ai

Related Projects

• Convolut Web App - Main context management platform

• Convolut API Documentation - REST API reference

• MCP Specification - Model Context Protocol standard

Made with ❤️ by the Convolut team