MCP Integration

Fresh

Source: docs.hindsight.vectorize.io/mcp

Overview

Hindsight Cloud integrates with MCP-compatible AI clients through the Model Context Protocol, an open standard for connecting AI applications to external tools over HTTP.

Compatible clients: Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, VS Code, and custom clients.

Authentication Methods

OAuth (Recommended)

Supported by Claude Code, Claude Desktop, ChatGPT, Cursor, and Windsurf. Uses the MCP Authorization spec (RFC 9728) with PKCE for secure browser-based authentication.

API Key

For clients lacking OAuth support (VS Code) or as fallback. Generate key on Connect page and embed in configuration.

Connection Modes

Single-Bank Mode (Recommended)

Agent connects to a specific memory bank via URL path:

https://api.hindsight.vectorize.io/mcp/{bank_id}/

• 27 available tools
• Automatic bank scoping
• Ideal for dedicated agents and project isolation

Multi-Bank Mode

Agent connects to root endpoint:

https://api.hindsight.vectorize.io/mcp
Header: X-Bank-Id: {bank_id}

• 30 total tools (includes bank management)
• Cross-bank operations capability

Client Configurations

Claude Code

OAuth:

claude mcp add --transport http hindsight \
  https://api.hindsight.vectorize.io/mcp/YOUR_BANK/

Type /mcp in Claude Code to initiate connection.

API Key Fallback:

claude mcp add --transport http hindsight \
  https://api.hindsight.vectorize.io/mcp/YOUR_BANK/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Or .mcp.json:

{
  "mcpServers": {
    "hindsight": {
      "type": "http",
      "url": "https://api.hindsight.vectorize.io/mcp/YOUR_BANK/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

OAuth (Connectors UI):

1. Settings > Connectors > Add custom connector
2. Enter: https://api.hindsight.vectorize.io/mcp/YOUR_BANK/
3. Click Connect — browser opens for authentication

mcp-remote (JSON):

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

{
  "mcpServers": {
    "hindsight": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.hindsight.vectorize.io/mcp/YOUR_BANK/"
      ]
    }
  }
}

Cursor

{
  "mcpServers": {
    "hindsight": {
      "type": "http",
      "url": "https://api.hindsight.vectorize.io/mcp/YOUR_BANK/"
    }
  }
}

Save to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global).

Windsurf

{
  "mcpServers": {
    "hindsight": {
      "serverUrl": "https://api.hindsight.vectorize.io/mcp/YOUR_BANK/"
    }
  }
}

Save to ~/.codeium/windsurf/mcp_config.json. Note: Windsurf uses serverUrl instead of url.

VS Code

{
  "servers": {
    "hindsight": {
      "type": "http",
      "url": "https://api.hindsight.vectorize.io/mcp/YOUR_BANK/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Save to .vscode/mcp.json. Note: VS Code uses servers instead of mcpServers and does not support OAuth.

ChatGPT

OAuth only:

1. Settings > Apps & Connectors > Advanced settings > Enable Developer Mode
2. Settings > Connectors > Create
3. Enter URL: https://api.hindsight.vectorize.io/mcp/YOUR_BANK/
4. Click Create — browser opens for authentication
5. In chat: Click + > More > select Hindsight

Available Tools

Single-Bank Mode (27 tools)

Category	Tools
Core Memory	retain, recall, reflect
Mental Models	create_mental_model, list_mental_models, get_mental_model, update_mental_model, delete_mental_model, refresh_mental_model
Directives	list_directives, create_directive, delete_directive
Memory Browsing	list_memories, get_memory, delete_memory
Documents	list_documents, get_document, delete_document
Operations	list_operations, get_operation, cancel_operation
Tags & Bank	list_tags, get_bank, update_bank, delete_bank, clear_memories
Cloud	search_docs

Multi-Bank Mode (30 tools)

All single-bank tools plus: list_banks, create_bank, get_bank_stats

Billing

Operation	Billing
retain	Input tokens
recall	Query + output tokens
reflect	Query + context + output tokens
get_mental_model	Output tokens
refresh_mental_model	Query + context + output tokens

Troubleshooting

Issue	Solution
OAuth login page does not open	Ensure client supports OAuth; verify Node.js installed for Claude Desktop
Failed to connect / no tools	Check key validity; verify Bearer prefix with space; alphanumeric bank names only
Tools appear but operations fail	Check credits; verify bank name
Memories not appearing after retain	Processing is async — wait a few seconds before recalling
0 tools discovered	Auth failed silently — remove and re-add MCP server