Reference

Connect a client

TuskPoint speaks the Model Context Protocol over stdio, so any MCP-capable client can use all eleven tools. Pick your client below — the config is the same shape everywhere; only the file location changes.

One block, every client

Most clients use the same { "mcpServers": { "tuskpoint": { … } } } block (VS Code uses servers, and Codex CLI uses TOML — both shown below). Set cwd to the absolute path of your cloned repo so mcp_server/server.py resolves. Or just call the tuskpoint_info tool and let the agent emit the right snippet for you.

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config) and add the server, then restart Claude Desktop.

claude_desktop_config.json

{
  "mcpServers": {
    "tuskpoint": {
      "command": "python",
      "args": ["mcp_server/server.py"],
      "cwd": "/absolute/path/to/tuskpoint",
      "env": {
        "WALRUS_AGGREGATOR_URL": "https://aggregator.walrus-testnet.walrus.space",
        "WALRUS_PUBLISHER_URL": "https://publisher.walrus-testnet.walrus.space"
      }
    }
  }
}

Claude Code

terminal

claude mcp add tuskpoint -- python mcp_server/server.py

Then confirm it is wired up:

terminal

claude mcp list

Cursor

Create .cursor/mcp.json in your project (or the global ~/.cursor/mcp.json) with the same block.

.cursor/mcp.json

{
  "mcpServers": {
    "tuskpoint": {
      "command": "python",
      "args": ["mcp_server/server.py"],
      "cwd": "/absolute/path/to/tuskpoint",
      "env": {
        "WALRUS_AGGREGATOR_URL": "https://aggregator.walrus-testnet.walrus.space",
        "WALRUS_PUBLISHER_URL": "https://publisher.walrus-testnet.walrus.space"
      }
    }
  }
}

Windsurf

Add the block to ~/.codeium/windsurf/mcp_config.json and reload the MCP servers from the Cascade panel.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tuskpoint": {
      "command": "python",
      "args": ["mcp_server/server.py"],
      "cwd": "/absolute/path/to/tuskpoint",
      "env": {
        "WALRUS_AGGREGATOR_URL": "https://aggregator.walrus-testnet.walrus.space",
        "WALRUS_PUBLISHER_URL": "https://publisher.walrus-testnet.walrus.space"
      }
    }
  }
}

VS Code (GitHub Copilot)

In Copilot agent mode, create .vscode/mcp.json in your workspace. VS Code uses a top-level servers key with an explicit type.

.vscode/mcp.json

{
  "servers": {
    "tuskpoint": {
      "type": "stdio",
      "command": "python",
      "args": ["mcp_server/server.py"],
      "cwd": "/absolute/path/to/tuskpoint"
    }
  }
}

OpenAI Codex CLI

Codex CLI is configured in TOML. Add a [mcp_servers.tuskpoint] table to ~/.codex/config.toml.

~/.codex/config.toml

[mcp_servers.tuskpoint]
command = "python"
args = ["mcp_server/server.py"]
cwd = "/absolute/path/to/tuskpoint"

Any other MCP client

A ready-to-use .mcp.json ships in the repo root. Point your client at it, or copy the block above. The transport is stdio and the command is always python mcp_server/server.py.

Optional: enable semantic search

To turn on checkpoint_search, add your MemWal credentials to the env block (or your .env):

env

MEMWAL_PRIVATE_KEY=your_ed25519_delegate_key_hex
MEMWAL_ACCOUNT_ID=your_walrus_memory_account_object_id

Free on testnet, funded on mainnet

The default is Walrus testnet, where checkpoint_save and checkpoint_fork work out of the box for free. To run on mainnet you need a publisher with a funded key — see the network guide for the switch.