# Submitator MCP server

> Launch client products on up to 100 directories using AI assistants like Claude, ChatGPT, or Cursor.

- Repository: https://github.com/submitator/submitator-mcp
- Page: https://hostedmcp.org/servers/submitator/submitator-mcp
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.1.4

## Install

### Claude Code

```sh
claude mcp add --env 'SUBMITATOR_API_KEY=<YOUR_SUBMITATOR_API_KEY>' submitator-mcp -- npx -y submitator-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "submitator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "submitator-mcp"
      ],
      "env": {
        "SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "submitator-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "submitator-mcp"
      ],
      "env": {
        "SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"submitator-mcp","type":"stdio","command":"npx","args":["-y","submitator-mcp"],"env":{"SUBMITATOR_API_KEY":"<YOUR_SUBMITATOR_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "submitator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "submitator-mcp"
      ],
      "env": {
        "SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add submitator-mcp --env 'SUBMITATOR_API_KEY=<YOUR_SUBMITATOR_API_KEY>' -- npx -y submitator-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.submitator-mcp]
command = "npx"
args = ["-y", "submitator-mcp"]

[mcp_servers.submitator-mcp.env]
SUBMITATOR_API_KEY = "<YOUR_SUBMITATOR_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'SUBMITATOR_API_KEY=<YOUR_SUBMITATOR_API_KEY>' submitator-mcp npx -- -y submitator-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "submitator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "submitator-mcp"
      ],
      "env": {
        "SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SUBMITATOR_API_KEY` | yes | yes | Agency API key from the Submitator agency console (sbm_live_ or sbm_test_) |
| `SUBMITATOR_FILES_DIR` | no | no |  |

## Tools (4)

- `whoami`
- `preview_launch`
- `launch_project`
- `add_directories`

## FAQ

### What is the difference between sbm_test and sbm_live keys?

A sbm_test_ key is free and runs in test mode where projects and listings use test data without actual submissions. A sbm_live_ key is used for real launches and is acquired with your first purchase.

### Can I upload local images to my projects?

Yes, but you must use the npx package rather than the remote server to handle local file paths.

### How do I prevent accidental spending during a launch?

You can keep the client approval prompt enabled for tools like launch_project, which carry a destructive hint to ensure confirmation before spending a launch.
