@spokest/mcp-server

MCP server for the Spokest Brain API. Exposes memory storage, semantic recall, chat, knowledge graph traversal, and story reconstruction as tools for AI assistants.

Tools

| Tool | Description | |------|-------------| | spokest_store | Store a memory (text, importance, topics, emotion, ttl) | | spokest_recall | Semantic search over memories | | spokest_chat | Send a message with memory-augmented context | | spokest_connect | Create a relationship between two memories | | spokest_story | Reconstruct a narrative from related memories | | spokest_graph | Traverse the knowledge graph from a starting node |

Resources

| URI | Description | |-----|-------------| | spokest://memories/recent | Last 10 memories | | spokest://profile | Personality/cognitive profile | | spokest://status | API health status |

Installation

cd mcp-server
npm install

Configuration

Claude Code

Add to ~/.claude/claude_desktop_config.json (or project-level .claude/settings.json):

{
  "mcpServers": {
    "spokest": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/bin/spokest-mcp.mjs"],
      "env": {
        "SPOKEST_API_KEY": "your-api-key",
        "SPOKEST_API_BASE": "https://brain-api.spokest.com"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "spokest": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/bin/spokest-mcp.mjs"],
      "env": {
        "SPOKEST_API_KEY": "your-api-key",
        "SPOKEST_API_BASE": "https://brain-api.spokest.com"
      }
    }
  }
}

CLI flags

You can also pass credentials as CLI arguments:

node bin/spokest-mcp.mjs --api-key "your-key" --base-url "https://brain-api.spokest.com"

Environment variables

| Variable | Description | Default | |----------|-------------|---------| | SPOKEST_API_KEY | API key for authentication | (required) | | SPOKEST_API_BASE | Brain API base URL | https://brain-api.spokest.com |

Requirements

• Node.js >= 18