Deep Art MCP server tools reference
This page describes all tools exposed by the Deep Art MCP server.
The server uses synchronous Streamable HTTP at https://api.deepart.ai/mcp.
Authentication
Every MCP request requires one of these HTTP headers:
X-API-Key: <api-key>
or:
Authorization: Bearer <access-token>
The server validates the credential against the Deep Art account service before processing the request. Missing or invalid credentials are rejected. Operations that require more credits than the account balance are rejected with the message:
Your account has insufficient credits to perform this operation.
Available tools
| Category | Tool | Description |
|---|---|---|
| Images | create_image | Generate an image from a text prompt |
| Images | edit_image | Edit an existing image |
| Videos | create_video | Submit an asynchronous video generation job |
| Videos | get_video_status | Poll a video generation job |
| Credits | get_credit_balance | Return the current credit balance |
The credit balance is checked before a generation request. Credits are consumed only after Deep Art successfully generates the image or accepts the video job.
Image generation
create_image
Creates an AI-generated image from a text prompt and returns a hosted image URL.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | Text prompt for image generation | |
aspectRatio | string | No | Provider default | Image aspect ratio. One of: "1:1", "4:5", "9:16", "16:9" |
Output
The tool returns text content and structured content with these fields:
| Field | Type | Description |
|---|---|---|
url | string | Hosted URL of the generated PNG image |
prompt | string | The prompt used to generate the image |
aspectRatio | string | Requested aspect ratio. Present only when the caller supplied it |
The text content has the form Generated image: <url>.
Notes
- The tool is declared as non-read-only, non-destructive, and closed-world.
- The generated output is associated with the
image-cardMCP App resource.
edit_image
Edits an existing image according to a text instruction and returns a hosted image URL.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Text instruction describing the image edit |
sourceImage | string | Yes | Absolute HTTP(S) URL or supported Base64 data URL of the source image |
Supported Base64 data URL media types are PNG, JPEG, WebP, and GIF. The data URL must contain valid, non-empty Base64 data.
Output
The tool returns text content and structured content with these fields:
| Field | Type | Description |
|---|---|---|
url | string | Hosted URL of the edited PNG image |
prompt | string | The edit instruction applied to the image |
The text content has the form Edited image: <url>.
Notes
- The output does not repeat
sourceImage. - Blank prompts, blank source images, relative URLs, unsupported URL schemes, and invalid data URLs are rejected.
- The tool is declared as non-read-only, non-destructive, and closed-world.
- The generated output is associated with the
image-cardMCP App resource.
Video generation
create_video
Submits an asynchronous video generation job from a text prompt. The call returns after Deep Art accepts the job; use get_video_status to retrieve its current state and final video URL.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | Text prompt for video generation | |
duration | integer | No | 4 | Duration in seconds. One of: 4, 6, 8 |
resolution | string | No | Provider default | Video resolution. One of: "720p", "1080p" |
aspectRatio | string | No | Provider default | Video aspect ratio. One of: "16:9", "9:16" |
generateAudio | boolean | No | Provider default | Whether the generated video should include audio |
Output
The tool returns text content and structured content with these fields:
| Field | Type | Description |
|---|---|---|
type | string | Always "video" |
id | string | Video generation job ID |
jobId | string | Alias of id, used for subsequent status calls |
status | string | Initial provider status, such as "queued" |
done | boolean | Whether the job is already in a terminal state |
videoUrls | string[] | Empty for a newly submitted job |
prompt | string | The prompt submitted for generation |
duration | integer | Requested duration. Present only when the caller supplied it |
resolution | string | Requested resolution. Present only when the caller supplied it |
aspectRatio | string | Requested aspect ratio. Present only when the caller supplied it |
generateAudio | boolean | Requested audio setting. Present only when the caller supplied it |
The text content has the form Submitted video generation job: <jobId> (<status>).
Notes
- The tool is declared as non-read-only, non-destructive, and closed-world.
- The generated output is associated with the
video-cardMCP App resource.
get_video_status
Returns the status of a previously submitted video generation job.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
jobId | string | Yes | Video generation job ID returned by create_video |
Output
The tool returns text content and structured content with these fields:
| Field | Type | Description |
|---|---|---|
type | string | Always "video" |
id | string | Provider job ID |
jobId | string | Alias of id |
status | string | Current provider status |
done | boolean | true for completed, failed, cancelled, or canceled; otherwise false |
videoUrls | string[] | Available video URLs, or an empty array when no URL is available |
The text content has the form Video status: <status>.
Notes
- This read-only call does not consume credits.
- When a job is completed, the server returns the hosted URL.
- The tool is declared as read-only, non-destructive, and closed-world.
- The video card can call this tool repeatedly to refresh job progress.
Credit balance
get_credit_balance
Returns the current credit balance for the authenticated account.
Parameters
This tool has no parameters.
Output
| Field | Type | Description |
|---|---|---|
creditsBalance | integer | Current number of credits available to the authenticated account |
Notes
- This read-only call does not consume credits.
- The tool is declared as read-only, non-destructive, and closed-world.
MCP App resources
Generation tools expose HTML resources that compatible MCP clients can use to render their structured output.
image-card
| Property | Value |
|---|---|
| URI | ui://deepart/image-card/v1.html |
| MIME type | text/html;profile=mcp-app |
| Used by | create_image, edit_image |
video-card
| Property | Value |
|---|---|
| URI | ui://deepart/video-card/v1.html |
| MIME type | text/html;profile=mcp-app |
| Used by | create_video |