Connecting io.github.nirholas/portfolio-mcp to Claude Code

First, install the @three-ws/portfolio-mcp package using npm. This package is required to connect the server. You can install it by running the command npm install @three-ws/portfolio-mcp. Make sure you have Node.js and npm installed on your system.

Paste this into your MCP client config, then restart the client.

{
  "mcpServers": {
    "portfolio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/portfolio-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<your SOLANA_SECRET_KEY>"
      }
    }
  }
}

Set the required environment variables. The SOLANA_SECRET_KEY variable is required and should be a Base58-encoded Solana secret key. The THREE_WS_SESSION variable is optional and required for account-scoped reads. You can set these variables in your system settings or in a .env file. The THREE_WS_BASE, THREE_WS_TIMEOUT_MS, SOLANA_RPC_URL, MAX_SOL_PER_TX, and RECIPIENT_ALLOWLIST variables are also optional and can be set according to your needs.

Check if the server appears in the client and its tools are callable. You can do this by checking the client's UI or by using the client's API to call the server's tools. Confirm that the server is working as expected and that you can retrieve the agent's trading state.

If the server does not appear in the client, check the environment variables and make sure they are set correctly. Also, check the client's logs for any error messages. You can try reinstalling the package or restarting the client to resolve the issue.

Set up the MCP client according to the standard procedure. This may involve creating a new project, installing dependencies, and configuring the client to connect to the server. Follow the client's documentation to complete the setup.