AI & Machine Learning
astria.ai
An MCP server for Astria that manages account access, image and video generations, saved references, local media uploads, and model listings.
ENDPOINT 1
https://www.astria.ai/mcp
MCP server metadata
- Name
- astria
- Version
- 1.0.0
Use list_models to discover model names. Generation tools return promptly; use get_prompt or subscribe to prompt.completed and prompt.failed. Reuse idempotency_key only for the same submission. For local media files, call create_upload and pass the returned HTTPS urls. Account closure and bulk deletion are unavailable; direct those requests to Astria account controls or support@astria.ai.
Known tools 30
search_astria_referencesSearch saved Astria people, products and garments for composer mentions.
Inferred read-onlycreate_uploadUse this when a media argument (input_image, mask_image, image_url, references, image_references, first_frame, last_frame, input_video, audio_reference) is a local file rather than an HTTPS URL.
Inferred read-onlylist_modelsUse this when choosing an Astria image, video or music model or checking supported media inputs, image resolutions, aspect ratios, lyrics limits, song prices, and defaults.
Inferred read-onlylist_workspacesUse this when finding an Astria workspace for a team or brand photoshoot.
Inferred read-onlylist_referencesUse this when finding a saved person, model, garment, product, or SKU for consistent photos, virtual try-on, headshots, or video.
Inferred read-onlyget_referenceUse this when inspecting a selected Astria identity or product reference and its training images before a photoshoot or try-on.
Inferred read-onlyupdate_referenceUpdate a selected reference title, subject class, short description or verified catalog source records.
Potential side effectscreate_referenceUse this when a supplied person or product needs one reusable Astria reference for consistent headshots, virtual try-on, product shots, or multiple scenes.
Inferred read-onlygenerate_imagesUse this when the user asks to create or edit images: product photography, ecommerce packshots, on-model fashion/virtual try-on, lookbooks, professional headshots from supplied photos, or consistent people/products across scenes.
Potential side effectsgenerate_videoUse this when the user requests an Astria video, animating a photo/product, or motion with consistent person/product references.
Inferred read-onlygenerate_musicUse this when the user asks for an Astria song, jingle, soundtrack, background music or instrumental track.
Inferred read-onlylist_promptsUse this when finding recent Astria images/videos, checking existing submissions after an uncertain response, or locating outputs from a saved photoshoot run.
Inferred read-onlyget_promptUse this when checking progress, finished images/videos, or errors for an existing Astria generation.
Inferred read-onlyupdate_promptAssign an existing prompt to a template, clear template membership, or move it to an authorized workspace.
Inferred read-onlylist_templatesUse this when finding an existing reusable Astria photoshoot/template (also called a pack) for product images, lookbooks, or headshots.
Inferred read-onlyget_templateUse this when resolving a selected Astria photoshoot template by slug or ID before running it or inspecting its prompts, reference slots, and baseline pricing.
Inferred read-onlycreate_templateCreate a reusable photoshoot template container in the selected workspace.
Potential side effectsupdate_templateUpdate an existing template title, subtitle or reference categories.
Potential side effectsget_workspaceInspect a selected workspace by ID, including its brand website and metadata.
Inferred read-onlyupdate_workspaceUpdate a selected workspace title, brand website URL or supplied landing page HTML.
Potential side effectsrun_templateUse this when the user asks to run a saved Astria photoshoot/template on their person or product, repeat an existing lookbook with a new SKU, or generate portraits from a selected pack.
Inferred read-onlystart_agent_runUse this when the user asks Astria to carry out a multi-step creative job end to end by running an Astria agent skill, such as /music-video (song, video and the final muxed MP4), rather than a single generation.
Inferred read-onlyget_agent_runUse this to follow a run started with start_agent_run; poll every 15-30 seconds while status.state is submitted or working.
Inferred read-onlycancel_agent_runUse this only when the user asks to stop a run started with start_agent_run.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.astria]
url = "https://www.astria.ai/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"astria": {
"type": "http",
"url": "https://www.astria.ai/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: astria
Remote MCP URL: https://www.astria.ai/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"astria": {
"url": "https://www.astria.ai/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"astria": {
"type": "http",
"url": "https://www.astria.ai/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "astria",
"transport": "streamable-http",
"url": "https://www.astria.ai/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
ENDPOINT 2
https://mcp.astria.ai/mcp
MCP server metadata
- Name
- astria
- Version
- 1.0.0
Use list_models to discover model names. Generation tools return promptly; use get_prompt or subscribe to prompt.completed and prompt.failed. Reuse idempotency_key only for the same submission. For local media files, call create_upload and pass the returned HTTPS urls. Account closure and bulk deletion are unavailable; direct those requests to Astria account controls or support@astria.ai.
Known tools 30
search_astria_referencesSearch saved Astria people, products and garments for composer mentions.
Inferred read-onlycreate_uploadUse this when a media argument (input_image, mask_image, image_url, references, image_references, first_frame, last_frame, input_video, audio_reference) is a local file rather than an HTTPS URL.
Inferred read-onlylist_modelsUse this when choosing an Astria image, video or music model or checking supported media inputs, image resolutions, aspect ratios, lyrics limits, song prices, and defaults.
Inferred read-onlylist_workspacesUse this when finding an Astria workspace for a team or brand photoshoot.
Inferred read-onlylist_referencesUse this when finding a saved person, model, garment, product, or SKU for consistent photos, virtual try-on, headshots, or video.
Inferred read-onlyget_referenceUse this when inspecting a selected Astria identity or product reference and its training images before a photoshoot or try-on.
Inferred read-onlyupdate_referenceUpdate a selected reference title, subject class, short description or verified catalog source records.
Potential side effectscreate_referenceUse this when a supplied person or product needs one reusable Astria reference for consistent headshots, virtual try-on, product shots, or multiple scenes.
Inferred read-onlygenerate_imagesUse this when the user asks to create or edit images: product photography, ecommerce packshots, on-model fashion/virtual try-on, lookbooks, professional headshots from supplied photos, or consistent people/products across scenes.
Potential side effectsgenerate_videoUse this when the user requests an Astria video, animating a photo/product, or motion with consistent person/product references.
Inferred read-onlygenerate_musicUse this when the user asks for an Astria song, jingle, soundtrack, background music or instrumental track.
Inferred read-onlylist_promptsUse this when finding recent Astria images/videos, checking existing submissions after an uncertain response, or locating outputs from a saved photoshoot run.
Inferred read-onlyget_promptUse this when checking progress, finished images/videos, or errors for an existing Astria generation.
Inferred read-onlyupdate_promptAssign an existing prompt to a template, clear template membership, or move it to an authorized workspace.
Inferred read-onlylist_templatesUse this when finding an existing reusable Astria photoshoot/template (also called a pack) for product images, lookbooks, or headshots.
Inferred read-onlyget_templateUse this when resolving a selected Astria photoshoot template by slug or ID before running it or inspecting its prompts, reference slots, and baseline pricing.
Inferred read-onlycreate_templateCreate a reusable photoshoot template container in the selected workspace.
Potential side effectsupdate_templateUpdate an existing template title, subtitle or reference categories.
Potential side effectsget_workspaceInspect a selected workspace by ID, including its brand website and metadata.
Inferred read-onlyupdate_workspaceUpdate a selected workspace title, brand website URL or supplied landing page HTML.
Potential side effectsrun_templateUse this when the user asks to run a saved Astria photoshoot/template on their person or product, repeat an existing lookbook with a new SKU, or generate portraits from a selected pack.
Inferred read-onlystart_agent_runUse this when the user asks Astria to carry out a multi-step creative job end to end by running an Astria agent skill, such as /music-video (song, video and the final muxed MP4), rather than a single generation.
Inferred read-onlyget_agent_runUse this to follow a run started with start_agent_run; poll every 15-30 seconds while status.state is submitted or working.
Inferred read-onlycancel_agent_runUse this only when the user asks to stop a run started with start_agent_run.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.astria]
url = "https://mcp.astria.ai/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"astria": {
"type": "http",
"url": "https://mcp.astria.ai/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: astria
Remote MCP URL: https://mcp.astria.ai/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"astria": {
"url": "https://mcp.astria.ai/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"astria": {
"type": "http",
"url": "https://mcp.astria.ai/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "astria",
"transport": "streamable-http",
"url": "https://mcp.astria.ai/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.