@aeriox-co/mcp

Package name: @aeriox-co/mcp. CLI command: aeriox-mcp (resolved by npx/npm from the package's bin).

Local MCP (Model Context Protocol) server for the AERIOX public API. Run from any MCP-compatible client — Claude Desktop, Cursor, Continue, VS Code, etc. — to generate images, video, audio, and stitched compositions from your agent.

Install

npm install -g @aeriox-co/mcp
# or use directly without install
npx -y aeriox-mcp

Requires Node.js 20+.

Configuration

aeriox-mcp authenticates via an API key. Get one at https://create.aeriox.co/settings/api-keys.

Set the key in your MCP client config:

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "aeriox": {
      "command": "npx",
      "args": ["-y", "aeriox-mcp"],
      "env": {
        "AERIOX_API_KEY": "sk_live_..."
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aeriox": {
      "command": "npx",
      "args": ["-y", "aeriox-mcp"],
      "env": {
        "AERIOX_API_KEY": "sk_live_..."
      }
    }
  }
}

Continue (~/.continue/config.json)

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "aeriox-mcp"]
        }
      }
    ]
  }
}

(Set AERIOX_API_KEY in the parent shell's environment.)

Environment variables

| Var | Required | Default | Purpose | |-----|----------|---------|---------| | AERIOX_API_KEY | yes | — | Your AERIOX API key (sk_live_...) | | AERIOX_BASE_URL | no | https://api.aeriox.co | Override for staging or self-hosted |

Tools (13)

| Tool | Description | |------|-------------| | list_models | List available image/video/audio models with pricing | | get_pricing | Fetch live rate-card pricing | | generate_image | Generate an image from a prompt | | generate_video | Generate a video from a prompt or image | | generate_voice | Synthesize speech from text | | compose_video | Stitch multiple video segments into a single output | | create_character | Train a new character from reference images | | list_characters | List trained characters in your workspace | | list_prisms | List available prism transforms | | apply_prism | Apply a prism to an asset or generation | | get_job_status | Check the status of a queued/running job | | cancel_job | Cancel a running job (refunds reservation) | | get_wallet | Show wallet balance + recent transactions |

Resources (3)

• aeriox://prisms — Live prism catalog
• aeriox://characters — Workspace character inventory
• aeriox://models — Model registry with capabilities

Security notes

• Never commit your API key to version control. Use environment-variable indirection in your client config where possible.
• This package transmits your key over HTTPS only (default: https://api.aeriox.co). Override AERIOX_BASE_URL only for staging or self-hosted deployments.
• All log/error output goes to stderr; stdout is reserved for the MCP JSON-RPC channel.
• OAuth bearer support and remote SSE transport ship in Phase 5.5.

Development

git clone https://github.com/aeriox/sdk-mcp
cd sdk-mcp
npm install
npm run build
npm test

Links

• AERIOX API docs: https://api.aeriox.co/openapi.json
• TypeScript SDK: https://www.npmjs.com/package/@aeriox-co/api
• CLI: https://www.npmjs.com/package/@aeriox-co/cli

License

MIT © AERIOX LLC