# Cosmic

Connects AI assistants to the Cosmic headless CMS to query content, update schema types, and upload media directly from editor chats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: cosmicjs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cosmicjs/mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/cosmic

## What it does

This server bridges AI agents with Cosmic CMS buckets. It exposes tools to inspect and mutate content objects, fetch schema definitions, and configure metadata fields. The server also handles media operations, allowing assistants to upload files directly or trigger Cosmic AI text and video generation.

Cosmic offers a hosted HTTP endpoint at `https://mcp.cosmicjs.com/v1/buckets/{bucket-slug}`, avoiding local dependency installations. Teams working without remote server support can run the package locally via `npx -y @cosmicjs/mcp`. Local execution requires setting `COSMIC_BUCKET_SLUG` alongside access keys.

Read access and write operations rely on distinct credentials. Supplying only `COSMIC_READ_KEY` blocks all mutations. To modify records, alter schema types, or publish generated assets, you must provide `COSMIC_WRITE_KEY`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}`
- Environment variables: `COSMIC_BUCKET_SLUG`, `COSMIC_READ_KEY`, `COSMIC_WRITE_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -e COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> -e COSMIC_READ_KEY=<COSMIC_READ_KEY> -e COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> -- npx -y @cosmicjs/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http cosmic https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}
```

### Codex

1. **Platform CLI**
```bash
codex mcp add cosmic --env COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> --env COSMIC_READ_KEY=<COSMIC_READ_KEY> --env COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> -- npx -y @cosmicjs/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add cosmic --url https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}
```

### Cursor

1. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cosmic": {
            "command": "npx",
            "args": [
                "-y",
                "@cosmicjs/mcp"
            ],
            "env": {
                "COSMIC_BUCKET_SLUG": "<COSMIC_BUCKET_SLUG>",
                "COSMIC_READ_KEY": "<COSMIC_READ_KEY>",
                "COSMIC_WRITE_KEY": "<COSMIC_WRITE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cosmic": {
            "url": "https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}"
        }
    }
}
```

### GitHub Copilot

1. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cosmic": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cosmicjs/mcp"
            ],
            "env": {
                "COSMIC_BUCKET_SLUG": "<COSMIC_BUCKET_SLUG>",
                "COSMIC_READ_KEY": "<COSMIC_READ_KEY>",
                "COSMIC_WRITE_KEY": "<COSMIC_WRITE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cosmic": {
            "type": "http",
            "url": "https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}"
        }
    }
}
```

### Gemini CLI

1. **Platform CLI**
```bash
gemini mcp add -e COSMIC_BUCKET_SLUG=<COSMIC_BUCKET_SLUG> -e COSMIC_READ_KEY=<COSMIC_READ_KEY> -e COSMIC_WRITE_KEY=<COSMIC_WRITE_KEY> cosmic npx -y @cosmicjs/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http cosmic https://mcp.cosmicjs.com/v1/buckets/{bucket_slug}
```

## When to use it
- update and delete entries inside Cosmic content buckets
- upload images and assets directly into the media library
- define object types with custom metafield structures
- trigger media generation through Cosmic AI utilities

## Example prompts
- List all blog post objects currently stored in the Cosmic bucket.
- Create a new object type named Products with price and description fields.
- Upload this image URL into the blog media folder.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md