@usewhisper/mcp-server 0.1.0 → 0.3.0

package/README.md

@@ -2,9 +2,11 @@
 
 Model Context Protocol server for [Whisper Context API](https://usewhisper.dev) - Connect Claude Desktop to your knowledge base.
 
+**Version 0.2.0** - Now with 15 tools including SOTA Memory System, Oracle Research Mode, and Cost Optimization!
+
 ## What is MCP?
 
-The Model Context Protocol (MCP) allows Claude Desktop to connect directly to external knowledge sources and tools. This server gives Claude Desktop access to your Whisper Context projects, enabling seamless RAG-powered conversations.
+The Model Context Protocol (MCP) allows Claude Desktop to connect directly to external knowledge sources and tools. This server gives Claude Desktop access to your Whisper Context projects, enabling seamless RAG-powered conversations with advanced memory and research capabilities.
 
 ## Installation
 
@@ -14,17 +16,9 @@ npm install -g @usewhisper/mcp-server
 
 ## Setup
 
-### 1. Get Environment Variables
-
-You'll need these environment variables:
-
-```env
-DATABASE_URL=your_neon_postgres_url
-OPENAI_API_KEY=your_openai_key
-WHISPER_ORG_ID=your_organization_id
-```
+### 1. Get Your API Key
 
-Get your Whisper credentials from the [dashboard](https://usewhisper.dev/dashboard).
+Get your Whisper API key from the [dashboard](https://usewhisper.dev/dashboard).
 
 ### 2. Configure Claude Desktop
 
@@ -39,15 +33,17 @@ Add to your Claude Desktop config file:
     "whisper-context": {
       "command": "whisper-context-mcp",
       "env": {
-        "DATABASE_URL": "postgresql://user:pass@host/db",
-        "OPENAI_API_KEY": "sk-...",
-        "WHISPER_ORG_ID": "org_..."
+        "WHISPER_API_KEY": "wctx_...",
+        "WHISPER_PROJECT": "my-project"
       }
     }
   }
 }
 ```
 
+**Optional environment variables:**
+- `WHISPER_BASE_URL`: Custom API endpoint (defaults to `https://context.usewhisper.dev`)
+
 ### 3. Restart Claude Desktop
 
 After configuration, restart Claude Desktop. The MCP server will appear in the bottom-right corner.
@@ -122,18 +118,18 @@ Claude: [Uses list_projects to show all your context projects]
 
 ## Architecture
 
-The MCP server connects directly to your Whisper Context database using:
-- **PostgreSQL + pgvector** for vector search
-- **OpenAI Embeddings** for semantic understanding
+The MCP server connects to your Whisper Context API:
+- **Whisper Context API** for semantic search, memory, and knowledge graph
 - **Stdio Transport** for Claude Desktop communication
+- **Zero dependencies** on database or infrastructure
 
 ## Environment Variables
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `DATABASE_URL` | Yes | PostgreSQL connection string |
-| `OPENAI_API_KEY` | Yes | OpenAI API key for embeddings |
-| `WHISPER_ORG_ID` | Yes | Your Whisper organization ID |
+| `WHISPER_API_KEY` | Yes | Your Whisper API key (get from dashboard) |
+| `WHISPER_PROJECT` | Optional | Default project name/slug for all operations |
+| `WHISPER_BASE_URL` | Optional | Custom API endpoint (defaults to https://context.usewhisper.dev) |
 
 ## Troubleshooting
 
@@ -146,15 +142,21 @@ The MCP server connects directly to your Whisper Context database using:
 
 ### Connection errors
 
-- Verify your `DATABASE_URL` is correct and accessible
-- Ensure your `OPENAI_API_KEY` is valid
-- Check that `WHISPER_ORG_ID` matches your organization
+- Verify your `WHISPER_API_KEY` is valid (starts with `wctx_`)
+- Check that you have network connectivity to the API
+- Ensure your API key has the necessary permissions
+
+### "Project not found" errors
+
+- Make sure your project name/slug is correct
+- Set `WHISPER_PROJECT` in config for a default project
+- Use `list_projects` tool to see all available projects
 
 ### No results from queries
 
 - Make sure your project has data sources connected or documents ingested
 - Verify the project name/slug matches exactly
-- Check that sources have been synced successfully
+- Check that sources have been synced successfully in the dashboard
 
 ## Links