# descriptinc/descript-mcp architecture

> Architecture diagram of the GitHub repository descriptinc/descript-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/descriptinc/descript-mcp
- Repository: https://github.com/descriptinc/descript-mcp

## Overview

Descript MCP is a plugin bundle that gives AI-agent clients access to Descript’s remote MCP service, alongside workflow guidance and task-specific skills. The principal workflow is to discover and inspect Drive content, import media or edit a project, track asynchronous work, then publish or export results. The repository configures and documents that service; it does not contain its server implementation, so the tool capabilities below are documented external capabilities. Relationships are based on the README; source excerpts cover validation utilities, not runtime behavior.

Main entry points: [`rules/descript-workflows.mdc`](https://github.com/descriptinc/descript-mcp/blob/main/rules/descript-workflows.mdc) (Workflow rule), [`skills/create-video/SKILL.md`](https://github.com/descriptinc/descript-mcp/blob/main/skills/create-video/SKILL.md) (Create video skill), [`skills/edit-project/SKILL.md`](https://github.com/descriptinc/descript-mcp/blob/main/skills/edit-project/SKILL.md) (Edit project skill), [`skills/publish-project/SKILL.md`](https://github.com/descriptinc/descript-mcp/blob/main/skills/publish-project/SKILL.md) (Publish project skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_connection["MCP connection"]
  node_client["MCP client"]
  node_server["Descript MCP service"]
  node_drive[("Connected Drive")]
  node_config["Server configuration<br/>[mcp.json]"]
end

subgraph group_workflows["Editing workflows"]
  node_guidance["Workflow rule"]
  node_create["Create video skill<br/>[SKILL.md]"]
  node_edit["Edit project skill<br/>[SKILL.md]"]
  node_discover["Discover content"]
  node_import["Import media"]
  node_ai_edit["AI project editing"]
  node_jobs["Async job management"]
end

subgraph group_outputs["Publishing and exports"]
  node_publish_skill["Publish project skill<br/>[SKILL.md]"]
  node_transcript_skill["Export transcript skill<br/>[SKILL.md]"]
  node_timeline_skill["Export timeline skill<br/>[SKILL.md]"]
  node_publish["Publish composition"]
  node_transcript["Export transcript"]
  node_timeline["Export timeline"]
end

node_agent(("AI agent user"))

node_agent -->|"uses"| node_client
node_client -->|"loads connection"| node_config
node_client -->|"connects to"| node_server
node_server -->|"accesses"| node_drive
node_agent -->|"follows guidance"| node_guidance
node_agent -->|"uses skill"| node_create
node_agent -->|"uses skill"| node_edit
node_agent -->|"uses skill"| node_publish_skill
node_agent -->|"uses skill"| node_transcript_skill
node_agent -->|"uses skill"| node_timeline_skill
node_server -->|"provides tools"| node_discover
node_server -->|"provides tools"| node_import
node_server -->|"provides tools"| node_ai_edit
node_server -->|"provides tools"| node_jobs
node_server -->|"provides tool"| node_publish
node_server -->|"provides tool"| node_transcript
node_server -->|"provides tool"| node_timeline
node_guidance -->|"recommends first"| node_discover
node_guidance -->|"recommends editing"| node_ai_edit
node_guidance -->|"recommends waiting"| node_jobs
node_create -->|"guides creation"| node_import
node_edit -->|"guides editing"| node_ai_edit
node_publish_skill -->|"guides publishing"| node_publish
node_transcript_skill -->|"guides export"| node_transcript
node_timeline_skill -->|"guides export"| node_timeline

click node_config "https://github.com/descriptinc/descript-mcp/blob/main/mcp.json"
click node_guidance "https://github.com/descriptinc/descript-mcp/blob/main/rules/descript-workflows.mdc"
click node_create "https://github.com/descriptinc/descript-mcp/blob/main/skills/create-video/SKILL.md"
click node_edit "https://github.com/descriptinc/descript-mcp/blob/main/skills/edit-project/SKILL.md"
click node_publish_skill "https://github.com/descriptinc/descript-mcp/blob/main/skills/publish-project/SKILL.md"
click node_transcript_skill "https://github.com/descriptinc/descript-mcp/blob/main/skills/export-transcript/SKILL.md"
click node_timeline_skill "https://github.com/descriptinc/descript-mcp/blob/main/skills/export-timeline/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_client,node_server,node_drive,node_config,node_agent toneBlue
class node_guidance,node_create,node_edit,node_discover,node_import,node_ai_edit,node_jobs toneAmber
class node_publish_skill,node_transcript_skill,node_timeline_skill,node_publish,node_transcript,node_timeline toneMint
```

## Components

### MCP connection

- **MCP client**
- **Descript MCP service**
- **Connected Drive**
- [Server configuration](https://github.com/descriptinc/descript-mcp/blob/main/mcp.json): `mcp.json`

### Editing workflows

- [Workflow rule](https://github.com/descriptinc/descript-mcp/blob/main/rules/descript-workflows.mdc): `rules/descript-workflows.mdc`
- [Create video skill](https://github.com/descriptinc/descript-mcp/blob/main/skills/create-video/SKILL.md): `skills/create-video/SKILL.md`
- [Edit project skill](https://github.com/descriptinc/descript-mcp/blob/main/skills/edit-project/SKILL.md): `skills/edit-project/SKILL.md`
- **Discover content**
- **Import media**
- **AI project editing**
- **Async job management**

### Publishing and exports

- [Publish project skill](https://github.com/descriptinc/descript-mcp/blob/main/skills/publish-project/SKILL.md): `skills/publish-project/SKILL.md`
- [Export transcript skill](https://github.com/descriptinc/descript-mcp/blob/main/skills/export-transcript/SKILL.md): `skills/export-transcript/SKILL.md`
- [Export timeline skill](https://github.com/descriptinc/descript-mcp/blob/main/skills/export-timeline/SKILL.md): `skills/export-timeline/SKILL.md`
- **Publish composition**
- **Export transcript**
- **Export timeline**

### Other components

- **AI agent user**

## Connections

- AI agent user → MCP client: uses (evidence: `README.md`)
- MCP client → Server configuration: loads connection (evidence: `README.md`)
- MCP client → Descript MCP service: connects to (evidence: `README.md`)
- Descript MCP service → Connected Drive: accesses (evidence: `README.md`)
- AI agent user → Workflow rule: follows guidance (evidence: `README.md`)
- AI agent user → Create video skill: uses skill (evidence: `README.md`)
- AI agent user → Edit project skill: uses skill (evidence: `README.md`)
- AI agent user → Publish project skill: uses skill (evidence: `README.md`)
- AI agent user → Export transcript skill: uses skill (evidence: `README.md`)
- AI agent user → Export timeline skill: uses skill (evidence: `README.md`)
- Descript MCP service → Discover content: provides tools (evidence: `README.md`)
- Descript MCP service → Import media: provides tools (evidence: `README.md`)
- Descript MCP service → AI project editing: provides tools (evidence: `README.md`)
- Descript MCP service → Async job management: provides tools (evidence: `README.md`)
- Descript MCP service → Publish composition: provides tool (evidence: `README.md`)
- Descript MCP service → Export transcript: provides tool (evidence: `README.md`)
- Descript MCP service → Export timeline: provides tool (evidence: `README.md`)
- Workflow rule → Discover content: recommends first (evidence: `README.md`)
- Workflow rule → AI project editing: recommends editing (evidence: `README.md`)
- Workflow rule → Async job management: recommends waiting (evidence: `README.md`)
- Create video skill → Import media: guides creation (evidence: `README.md`)
- Edit project skill → AI project editing: guides editing (evidence: `README.md`)
- Publish project skill → Publish composition: guides publishing (evidence: `README.md`)
- Export transcript skill → Export transcript: guides export (evidence: `README.md`)
- Export timeline skill → Export timeline: guides export (evidence: `README.md`)