---
title: "Cosmos MCP Server"
canonical: "https://documentation.chaos.com/space/COSMOS/1440940082/Cosmos+MCP+Server"
format: markdown
---
This page provides information about the Cosmos MCP server, how to set it up, and how to use it with an AI assistant to search, download, and import Cosmos assets.


## **Overview**

---

The Cosmos MCP connects Cosmos to an AI assistant or agent, such as Claude or ChatGPT. Once connected, the assistant finds 3D assets in Cosmos and brings them into the scene, with no need to browse the library manually. The connected assistant:

- Searches for assets by name, keyword, category, description, or reference image.
- Downloads assets.
- Imports downloaded assets into the host application.

> ⚠️ Currently, the Cosmos MCP supports V-Ray and Corona.


## **MCP Setup**

---

The Cosmos MCP requires no complex manual setup. Install the latest version of Cosmos, then ask the AI assistant (such as Claude or ChatGPT) to configure the Cosmos MCP server globally. For example:

`I want you to configure the Cosmos MCP server globally. The HTTP endpoint is: http://localhost:30305/mcp`

The assistant handles the configuration and reports any additional settings that need attention.


Some assistants require the server to be added to their configuration file manually. For example, to add the Cosmos MCP server to the Claude desktop app:

- Go to **Settings > Developer > Edit Config** and add the following code to the *claude_desktop_config* JSON file:

```
"mcpServers": {
    "cosmos": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:30305/mcp"]
    }
 },
```

If the file already contains an `mcpServers` section, add only the `cosmos` entry to that section. 

Note that the `npx` command requires Node.js to be installed.

- Then restart Claude.


## **MCP Example Workflows**

---

The following example shows the assistant furnishing an empty room in Blender with V-Ray and Cosmos, using only prompts. During the session, the assistant:

- Adds architectural elements, such as French doors.
- Applies Cosmos materials, such as oak material to floor.
- Finds, downloads, imports and arranges assets, such as a group of related assets for a coffee corner.
- Rearranges assets to fit the layout.
- Matches assets to a reference image.
- Renders the scene.

> ⚠️ Many Cosmos assets import as V-Ray proxies. The viewport shows a simplified preview, and the full geometry and materials appear only at render time. Ask the assistant for a V-Ray render to check the result.