Skip to content
MCP server

three.ws Vision

Image understanding for AI agents — analyze and describe any image via the three.ws…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
5 days ago

About three.ws Vision

three.ws Vision is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Image understanding for AI agents — analyze and describe any image via the three.ws pipeline.

Install

Run in a terminal

claude mcp add vision-mcp -- npx -y @three-ws/vision-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "vision-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "vision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/vision-mcp"
      ]
    }
  }
}

Configuration

  • THREE_WS_BASEBase URL of the three.ws API that serves the vision endpoint. Override only when self-hosting or targeting a preview deployment.
  • THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds for the vision call (the VLM may chain across free lanes before answering).
  • THREE_WS_API_KEYOptional three.ws API key (bearer token). Not required — the vision endpoint serves anonymous callers on a free per-IP rate limit. Set it to raise your rate limit to the per-user tier. Never needed to access the free model.

Pricing

Open source

Prices change. Check three.ws before you buy.

three.ws Vision FAQ

Is three.ws Vision free?

Yes. three.ws Vision is open source, so you can use and self-host it for free.

How do I add three.ws Vision to Claude Code?

Run this command in your terminal: claude mcp add vision-mcp -- npx -y @three-ws/vision-mcp