Skip to main content
Glama
picselliahq

picsellia-mcp

Official
by picselliahq
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

picsellia-mcp

An MCP server that wraps the Picsellia Python SDK, giving AI assistants access to your computer vision platform — datasets, experiments, models, deployments, and monitoring.

Prerequisites

  • Python 3.10+

  • uv

  • A Picsellia account with an API token

Related MCP server: Langflow MCP Server

Installation

git clone <repo-url>
cd picsellia-mcp
uv sync

Configuration

Copy the example env file and fill in your credentials:

cp .env.example .env

Variable

Required

Default

Description

PICSELLIA_API_TOKEN

Yes

—

Your Picsellia API token

PICSELLIA_ORGANIZATION_NAME

No

None

Organization to connect to

PICSELLIA_HOST

No

https://app.picsellia.com

Picsellia API host

MCP_TRANSPORT

No

stdio

Transport protocol (stdio or streamable-http)

Usage

Claude Desktop

Add the following to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "picsellia": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/picsellia-mcp",
        "picsellia-mcp"
      ],
      "env": {
        "PICSELLIA_API_TOKEN": "<your-token>",
        "PICSELLIA_ORGANIZATION_NAME":"",
        "PICSELLIA_HOST":"https://app.picsellia.com",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

If uv is not on your PATH, use the absolute path (e.g. ~/.local/bin/uv).

Claude Code

Add the server from the project directory:

claude mcp add picsellia -- uv run --directory /absolute/path/to/picsellia-mcp picsellia-mcp

Or add it to .claude/settings.json directly:

{
  "mcpServers": {
    "picsellia": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/picsellia-mcp",
        "picsellia-mcp"
      ],
      "env": {
        "PICSELLIA_API_TOKEN": "<your-token>",
        "PICSELLIA_ORGANIZATION_NAME":"",
        "PICSELLIA_HOST":"https://app.picsellia.com",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Cursor

Open Settings > MCP and add a new server:

{
  "mcpServers": {
    "picsellia": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/picsellia-mcp",
        "picsellia-mcp"
      ],
      "env": {
        "PICSELLIA_API_TOKEN": "<your-token>",
        "PICSELLIA_ORGANIZATION_NAME":"",
        "PICSELLIA_HOST":"https://app.picsellia.com",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Standalone (stdio)

uv run picsellia-mcp

Standalone (HTTP)

MCP_TRANSPORT=streamable-http uv run picsellia-mcp

Available Tools

53 tools organized by domain:

Category

Tools

Description

Datasets

9

List, get, browse versions, assets, labels, stats

Projects

8

List, create, get projects; list experiments

Models

6

List, get models and versions; list files

Experiments

6

Create, launch, attach/detach datasets, set base model

Datalakes

4

List datalakes, browse data items and tags

Deployments

9

List, get deployments; monitoring stats; predicted assets

Logs

4

List, get, filter, and compare experiment logs

Annotations

3

Get annotations, search assets with query language

Evaluations

4

List evaluations and artifacts

Most tools are read-only. Write operations are limited to experiment management (create, launch, attach datasets, set base model).

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers