@coppermind/mcp

The published MCP package for Coppermind's managed cloud route family.

Coppermind's default product posture is local runtime first. This package exists for the current direct cloud-connected MCP path.

Before You Start

For this package, you need:

1. a Coppermind account
2. a Coppermind API key
3. an MCP-capable client

If you want no-login local-first behavior, start with the coppermind runtime package instead.

Local-first default

The default free MCP path is:

coppermind mcp serve

Typical local MCP config:

{
  "mcpServers": {
    "coppermind": {
      "command": "coppermind",
      "args": ["mcp", "serve"]
    }
  }
}

That path talks to the local Coppermind runtime and does not require a Coppermind API key.

Usage

Published Cloud MCP target:

{
  "mcpServers": {
    "coppermind": {
      "command": "npx",
      "args": ["-y", "@coppermind/mcp"],
      "env": {
        "COPPERMIND_API_KEY": "cm_live_xxx"
      }
    }
  }
}

You can also smoke-test the server directly:

COPPERMIND_API_KEY="cm_live_xxx" npx -y @coppermind/mcp

After registration, verify that your client exposes these tools:

• memory_search
• memory_ingest
• memory_get
• memory_stats
• memory_delete

Local development from this repo:

cd mcp-server
npm install
npm run build
COPPERMIND_API_KEY="cm_live_xxx" COPPERMIND_BASE_URL="http://127.0.0.1:4000" node dist/index.js

Tools

| Tool | Managed route | |------|---------------| | memory_search | GET /v1/memory/search | | memory_ingest | POST /v1/ingest | | memory_get | GET /v1/memory | | memory_stats | GET /v1/stats | | memory_delete | DELETE /v1/memory/delete |

Configuration

| Variable | Required | Default | |----------|----------|---------| | COPPERMIND_API_KEY | yes | none | | COPPERMIND_BASE_URL | no | https://api.coppermindapi.com | | COPPERMIND_USER_ID | no | default |

Notes

• coppermind mcp serve is Local Coppermind MCP
• @coppermind/mcp is Published Cloud MCP
• this package talks to the managed cloud route family directly
• the logical memory operations stay stable even though the bootstrap contract differs from local-first runtime installs
• local node dist/index.js is for contributors and smoke tests; public users should prefer the published package