{"_id":"@aeriox-co/mcp","name":"@aeriox-co/mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aeriox-co/mcp","version":"1.0.0","description":"AERIOX MCP server — generate images, video, audio, and stitched compositions from any MCP-compatible agent (Claude Desktop, Cursor, Continue, etc.).","author":{"name":"AERIOX LLC"},"license":"MIT","homepage":"https://github.com/aeriox/sdk-mcp","repository":{"type":"git","url":"git+https://github.com/aeriox/sdk-mcp.git"},"bugs":{"url":"https://github.com/aeriox/sdk-mcp/issues"},"keywords":["mcp","model-context-protocol","aeriox","image-generation","video-generation","claude","claude-desktop","cursor"],"type":"module","engines":{"node":">=20.0.0"},"bin":{"aeriox-mcp":"bin/run.js"},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","lint":"tsc --noEmit","test":"vitest run","test:watch":"vitest","prepack":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","@aeriox-co/api":"^1.0.0","zod":"^3.23.0","zod-to-json-schema":"^3.23.0"},"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.12.0","vitest":"^2.1.0","tsx":"^4.16.0"},"gitHead":"6eb3efd8e81857f3a945697eeaaf932560f9c1d5","_id":"@aeriox-co/mcp@1.0.0","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-x7PneR8fYqcSQrFBHPzoCY8yP0epcFOw5WH2/4Tc66OkJJY45XjRFpFyzC7bdQww3Im9faOdzbihluwqk9jZjA==","shasum":"ee952d026a3034c46133c3f3668579278bdee072","tarball":"https://registry.npmjs.org/@aeriox-co/mcp/-/mcp-1.0.0.tgz","fileCount":88,"unpackedSize":86271,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCID2qlZK2xpIePpiGEEqc/19jW79aZRSl/Yv9rc7QmSC9AiEA0Ivdi6cHk1agnAMcacNOFI1ro+0zTBocS+8Aws6WbD4="}]},"_npmUser":{"name":"aeriox","email":"joshua@aeriox.co"},"directories":{},"maintainers":[{"name":"aeriox","email":"joshua@aeriox.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.0_1778170124319_0.14171428634512684"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-07T16:08:44.267Z","1.0.0":"2026-05-07T16:08:44.463Z","modified":"2026-05-07T16:08:44.959Z"},"maintainers":[{"name":"aeriox","email":"joshua@aeriox.co"}],"description":"AERIOX MCP server — generate images, video, audio, and stitched compositions from any MCP-compatible agent (Claude Desktop, Cursor, Continue, etc.).","homepage":"https://github.com/aeriox/sdk-mcp","keywords":["mcp","model-context-protocol","aeriox","image-generation","video-generation","claude","claude-desktop","cursor"],"repository":{"type":"git","url":"git+https://github.com/aeriox/sdk-mcp.git"},"author":{"name":"AERIOX LLC"},"bugs":{"url":"https://github.com/aeriox/sdk-mcp/issues"},"license":"MIT","readme":"# @aeriox-co/mcp\n\n> Package name: `@aeriox-co/mcp`. CLI command: `aeriox-mcp` (resolved by `npx`/`npm` from the package's `bin`).\n\nLocal 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.\n\n## Install\n\n```bash\nnpm install -g @aeriox-co/mcp\n# or use directly without install\nnpx -y aeriox-mcp\n```\n\nRequires Node.js 20+.\n\n## Configuration\n\n`aeriox-mcp` authenticates via an API key. Get one at <https://create.aeriox.co/settings/api-keys>.\n\nSet the key in your MCP client config:\n\n### Claude Desktop (`claude_desktop_config.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"aeriox\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"aeriox-mcp\"],\n      \"env\": {\n        \"AERIOX_API_KEY\": \"sk_live_...\"\n      }\n    }\n  }\n}\n```\n\n### Cursor (`~/.cursor/mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"aeriox\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"aeriox-mcp\"],\n      \"env\": {\n        \"AERIOX_API_KEY\": \"sk_live_...\"\n      }\n    }\n  }\n}\n```\n\n### Continue (`~/.continue/config.json`)\n\n```json\n{\n  \"experimental\": {\n    \"modelContextProtocolServers\": [\n      {\n        \"transport\": {\n          \"type\": \"stdio\",\n          \"command\": \"npx\",\n          \"args\": [\"-y\", \"aeriox-mcp\"]\n        }\n      }\n    ]\n  }\n}\n```\n\n(Set `AERIOX_API_KEY` in the parent shell's environment.)\n\n## Environment variables\n\n| Var | Required | Default | Purpose |\n|-----|----------|---------|---------|\n| `AERIOX_API_KEY` | yes | — | Your AERIOX API key (`sk_live_...`) |\n| `AERIOX_BASE_URL` | no | `https://api.aeriox.co` | Override for staging or self-hosted |\n\n## Tools (13)\n\n| Tool | Description |\n|------|-------------|\n| `list_models` | List available image/video/audio models with pricing |\n| `get_pricing` | Fetch live rate-card pricing |\n| `generate_image` | Generate an image from a prompt |\n| `generate_video` | Generate a video from a prompt or image |\n| `generate_voice` | Synthesize speech from text |\n| `compose_video` | Stitch multiple video segments into a single output |\n| `create_character` | Train a new character from reference images |\n| `list_characters` | List trained characters in your workspace |\n| `list_prisms` | List available prism transforms |\n| `apply_prism` | Apply a prism to an asset or generation |\n| `get_job_status` | Check the status of a queued/running job |\n| `cancel_job` | Cancel a running job (refunds reservation) |\n| `get_wallet` | Show wallet balance + recent transactions |\n\n## Resources (3)\n\n- `aeriox://prisms` — Live prism catalog\n- `aeriox://characters` — Workspace character inventory\n- `aeriox://models` — Model registry with capabilities\n\n## Security notes\n\n- **Never commit your API key to version control.** Use environment-variable indirection in your client config where possible.\n- This package transmits your key over HTTPS only (default: `https://api.aeriox.co`). Override `AERIOX_BASE_URL` only for staging or self-hosted deployments.\n- All log/error output goes to stderr; stdout is reserved for the MCP JSON-RPC channel.\n- OAuth bearer support and remote SSE transport ship in Phase 5.5.\n\n## Development\n\n```bash\ngit clone https://github.com/aeriox/sdk-mcp\ncd sdk-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n## Links\n\n- AERIOX API docs: <https://api.aeriox.co/openapi.json>\n- TypeScript SDK: <https://www.npmjs.com/package/@aeriox-co/api>\n- CLI: <https://www.npmjs.com/package/@aeriox-co/cli>\n\n## License\n\nMIT © AERIOX LLC\n","readmeFilename":"README.md","_rev":"1-a2934a3c82b5968f5f7dc2e87e5b1303"}