Skip to main content
Glama

dcc-mcp-fpt

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

CI License: MIT Python

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

This is a fresh re-implementation of the shotgrid-mcp-server using the dcc-mcp framework — providing the same ShotGrid integration surface with gateway routing, skill-based progressive loading, and multi-DCC observability 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.

A
license - permissive license
-
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dcc-mcp/dcc-mcp-fpt'

If you have feedback or need assistance with the MCP directory API, please join our Discord server