@usewhisper/mcp-server 0.2.3 → 0.4.0

package/README.md

@@ -16,17 +16,9 @@ npm install -g @usewhisper/mcp-server
 
 ## Setup
 
-### 1. Get Environment Variables
+### 1. Get Your API Key
 
-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
-```
-
-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
 
@@ -41,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.
@@ -124,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
 
@@ -148,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