BaseGrid MCP Server

Give Claude Desktop, Cursor, Cline, and other MCP-compatible AI tools persistent memory powered by BaseGrid.

Your AI tools forget everything when you close them. BaseGrid MCP Server fixes that.

What This Does

• store_memory — Save anything your AI should remember long-term
• recall_memories — Hybrid semantic + keyword search across all stored memories
• list_memories — Browse your stored memories in reverse chronological order
• forget_memory — Permanently delete a specific memory by ID

All memories are stored securely on BaseGrid's infrastructure with sub-200ms retrieval.

Quick Start

Step 1 — Get your API key

Sign up free at basegrid.io/mcp — no credit card required.

Step 2 — Add to Claude Desktop

Open your Claude Desktop config (claude_desktop_config.json) and add:

{
  "mcpServers": {
    "basegrid": {
      "command": "npx",
      "args": ["-y", "@basegrid-io/mcp-server"],
      "env": {
        "BASEGRID_API_KEY": "your_api_key_here"
      }
    }
  }
}

Config file locations:

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

Step 3 — Restart Claude Desktop

That's it. Claude now has persistent memory.

Cursor Setup

Add to your Cursor MCP settings:

{
  "basegrid": {
    "command": "npx",
    "args": ["-y", "@basegrid-io/mcp-server"],
    "env": {
      "BASEGRID_API_KEY": "your_api_key_here"
    }
  }
}

Cline (VS Code) Setup

In Cline settings → MCP Servers → Add Server:

{
  "basegrid": {
    "command": "npx",
    "args": ["-y", "@basegrid-io/mcp-server"],
    "env": {
      "BASEGRID_API_KEY": "your_api_key_here"
    }
  }
}

Remote / Streamable HTTP Transport

v1.2.0+ — For self-hosted deployments and the Anthropic Connectors Directory.

By default the server uses stdio (for Claude Desktop, Cursor, Cline). If you need a remotely accessible HTTP endpoint, set TRANSPORT=http:

# Start in HTTP mode (defaults to port 3100)
TRANSPORT=http BASEGRID_API_KEY=your_key npx @basegrid-io/mcp-server

# Custom port
TRANSPORT=http PORT=8080 BASEGRID_API_KEY=your_key npx @basegrid-io/mcp-server

Endpoints: | Endpoint | Method | Description | |---|---|---| | /mcp | POST | MCP Streamable HTTP endpoint (for AI clients) | | /health | GET | Health check — returns {"status":"ok","version":"1.2.0"} |

Self-hosting on Railway / Fly.io / any server

Set these environment variables on your host:

TRANSPORT=http
PORT=3100
BASEGRID_API_KEY=your_api_key

Then point your MCP client to https://your-host.com/mcp.

Tools Reference

| Tool | Description | Parameters | |------|-------------|------------| | store_memory | Save a memory | content (required), agentId, metadata, importance | | recall_memories | Search memories | query (required), agentId, limit (max 20) | | list_memories | List recent memories | agentId, limit (max 50) | | forget_memory | Permanently delete a memory | memoryId (required) |

Agent Namespacing (agentId)

Every memory belongs to an agent namespace — an isolated bucket identified by agentId. Use this to separate memories for different users, projects, or contexts:

agentId: "personal"        → your personal assistant memories (default)
agentId: "work-project-x"  → memories for a specific project
agentId: "user-abc123"     → memories for a specific user (multi-tenant apps)

Different agentId values cannot see each other's memories, ensuring complete isolation.

Pricing

| Plan | Memories | Search | Price | |------|----------|--------|-------| | Free Trial | 1,000 | Semantic | Free for 2 months | | Free | 500 | Keyword | Free forever | | MCP Pro | Unlimited | Semantic + Hybrid | $10/month |

Get your key at basegrid.io/mcp

Requirements

• Node.js 18+
• A BaseGrid API key (get one free)

Changelog

v1.2.0

• ✨ Added Streamable HTTP transport for remote/self-hosted deployments
• ✨ Added tool annotations (readOnlyHint, destructiveHint) for Anthropic Connectors Directory compliance
• ✨ Enriched tool descriptions for better Claude integration
• 🔧 SDK pinned to ^1.26.0 for stability
• 🔧 Added TRANSPORT, PORT, BASEGRID_API_URL environment variables

v1.0.0

• Initial release with stdio transport
• store_memory, recall_memories, list_memories, forget_memory tools

Contributing

We welcome contributions. Please open an issue first to discuss what you'd like to change.

License

Apache 2.0 — see LICENSE

Built by BaseGrid · Docs · Discord