Submit
dcc-mcp

dcc-mcp-fpt

Community dcc-mcp
Updated

Autodesk Flow Production Tracking (FPT, formerly ShotGrid) adapter for the DCC-MCP ecosystem — typed MCP tools bridging AI assistants to FPT data.

dcc-mcp-fpt

ShotGrid (Flow Production Tracking) adapter for the DCC-MCP ecosystem.

CILicense: MITPython

Bridges AI assistants (Claude, Cursor, VS Code Copilot) to ShotGrid data throughtyped, progressively-loaded MCP tools built on dcc-mcp-core.

This is a fresh re-implementation of the shotgrid-mcp-serverusing the dcc-mcp framework — providing the same ShotGrid integration surfacewith gateway routing, skill-based progressive loading, and multi-DCCobservability built in.

Why Use It

Feature Description
20+ Typed Tools CRUD, search, batch, notes, schema — all with validated schemas
Progressive Loading Bootstrap tools eager-loaded; advanced tools loaded on demand
Gateway Ready Plugs into the dcc-mcp gateway for unified multi-service routing
Skill-First Every tool is a typed skill with tools.yaml, schemas, and annotations
Connection Pooling Reuses authenticated sessions for performance
Schema Caching Entity field schemas cached with configurable TTL
Multi-Transport stdio, HTTP, and ASGI — works anywhere
Docker Ready Single-command container deployment

Quick Start

Install

pip install dcc-mcp-fpt

Or with uv:

uv pip install dcc-mcp-fpt

Configure

Set your ShotGrid credentials:

export SHOTGRID_URL="https://mysite.shotgrid.autodesk.com"
export SHOTGRID_SCRIPT_NAME="my_script_name"
export SHOTGRID_SCRIPT_KEY="my_script_key"

Run

HTTP mode:

dcc-mcp-fpt http --host 0.0.0.0 --port 8765
# MCP endpoint: http://localhost:8765/mcp

stdio mode (for Claude Desktop):

dcc-mcp-fpt stdio

ASGI mode (for uvicorn/gunicorn):

uvicorn dcc_mcp_fpt.asgi:app --host 0.0.0.0 --port 8000

Docker:

docker run --rm -p 8765:8765 \
    -e SHOTGRID_URL="$SHOTGRID_URL" \
    -e SHOTGRID_SCRIPT_NAME="$SHOTGRID_SCRIPT_NAME" \
    -e SHOTGRID_SCRIPT_KEY="$SHOTGRID_SCRIPT_KEY" \
    dcc-mcp-fpt

Claude Desktop Config

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "shotgrid": {
      "command": "uvx",
      "args": ["dcc-mcp-fpt", "stdio"],
      "env": {
        "SHOTGRID_URL": "https://mysite.shotgrid.autodesk.com",
        "SHOTGRID_SCRIPT_NAME": "my_script_name",
        "SHOTGRID_SCRIPT_KEY": "my_script_key"
      }
    }
  }
}

Tool Surface

Bootstrap (eager-loaded)

Skill Tools
shotgrid-discovery check_connection, list_entity_types, get_server_info
shotgrid-schema get_schema, get_field_schema, list_entity_types

Scene (loaded on demand)

Skill Tools
shotgrid-crud find_entities, find_one_entity, create_entity, update_entity, delete_entity
shotgrid-search search_entities, search_by_name

Authoring

Skill Tools
shotgrid-note create_note, find_notes, update_note

Pipeline

Skill Tools
shotgrid-batch batch_operations

Architecture

AI Agent (Claude, Cursor, Copilot)
        │
        │ MCP Protocol (stdio / HTTP / ASGI)
        ▼
┌───────────────────────────────┐
│     ShotGridMcpServer         │
│   (DccServerBase adapter)     │
│                               │
│  ┌─────────────────────────┐  │
│  │   Skill Catalog          │  │
│  │  (progressive loading)   │  │
│  └───────────┬─────────────┘  │
│              │                │
│  ┌───────────▼─────────────┐  │
│  │   HostExecutionBridge    │  │
│  │   → ShotGridClient       │  │
│  └───────────┬─────────────┘  │
│              │                │
│  ┌───────────▼─────────────┐  │
│  │  ConnectionPool          │  │
│  │  SchemaCache             │  │
│  └───────────┬─────────────┘  │
└──────────────┼────────────────┘
               │
               │ shotgun_api3 (REST)
               ▼
     ┌─────────────────┐
     │  ShotGrid API    │
     │  (Autodesk FPT)  │
     └─────────────────┘

Configuration

Variable Required Description
SHOTGRID_URL Yes ShotGrid server URL
SHOTGRID_SCRIPT_NAME Yes Script/API user name
SHOTGRID_SCRIPT_KEY Yes Script/API user key
DCC_MCP_SHOTGRID_MINIMAL No Comma-separated minimal mode skill list
DCC_MCP_SHOTGRID_DEFAULT_TOOLS No Comma-separated default tools to activate

Development

git clone https://github.com/dcc-mcp/dcc-mcp-fpt.git
cd dcc-mcp-fpt

# Install with dev deps
uv pip install -e ".[dev]"

# Run tests
pytest --cov=src/dcc_mcp_fpt --cov-report=term

# Lint
ruff check src/ tests/

# Format
ruff format src/ tests/

Requirements

License

MIT — see LICENSE.

Related

MCP Server · Populars

MCP Server · New