{"_id":"@ambienceai/mcp-server","_rev":"5-2b0e2ffeb8120cd3a0e1137c35572ea9","name":"@ambienceai/mcp-server","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@ambienceai/mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","ambience-ai","image-generation","video-generation","audio-generation"],"author":{"name":"Ambience AI"},"license":"MIT","_id":"@ambienceai/mcp-server@1.0.0","maintainers":[{"name":"reaaz","email":"reaaz2@gmail.com"}],"homepage":"https://www.ambienceai.com/guides/connect-claude-mcp","bugs":{"url":"https://github.com/ambienceai/ambienceai-mcp/issues"},"bin":{"ambienceai-mcp":"dist/index.js"},"dist":{"shasum":"a2a887d19cca31770e0e2d0e41ec119c715a255e","tarball":"https://registry.npmjs.org/@ambienceai/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":27,"integrity":"sha512-9bgdG1VV0oFrjIS4AvD9uVppWDqNaTKH616KrjsPW3Twb+wd4tx7eWLRS2du5ed4g7xMzUWzyhzGdWT8shzX9Q==","signatures":[{"sig":"MEUCIQDf8oFl3KuT6zTtRwGyNUDT5Y9TtAgUi6zDVXBYb+u1pgIgRNrC8dobqSDb1MWN8WIIWAHJK7IIb7ud/LKdPl1lUJw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":131328},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"234ec22ab76f1669e4ca16fdb753cbd80fa96143","scripts":{"dev":"tsx watch src/index.ts","test":"NODE_OPTIONS='--experimental-vm-modules' jest","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","start":"node dist/index.js","typecheck":"tsc --noEmit","test:watch":"NODE_OPTIONS='--experimental-vm-modules' jest --watch","test:server":"node test-server.js","test:coverage":"NODE_OPTIONS='--experimental-vm-modules' jest --coverage","prepublishOnly":"npm run clean && npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"reaaz","email":"reaaz2@gmail.com"},"repository":{"url":"git+https://github.com/ambienceai/ambienceai-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Ambience AI MCP Server - Generate images, videos, and audio through Model Context Protocol","directories":{},"_nodeVersion":"22.6.0","dependencies":{"zod":"^3.25.76","axios":"^1.11.0","dotenv":"^17.2.1","@modelcontextprotocol/sdk":"^1.17.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.4","jest":"^30.2.0","ts-jest":"^29.4.6","typescript":"^5.9.2","@types/jest":"^30.0.0","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1783320145261_0.8932588772991397","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@ambienceai/mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","ambience-ai","image-generation","video-generation","audio-generation"],"author":{"name":"Ambience AI"},"license":"MIT","_id":"@ambienceai/mcp-server@1.0.1","maintainers":[{"name":"reaaz","email":"reaaz2@gmail.com"}],"homepage":"https://www.ambienceai.com/guides/connect-claude-mcp","bugs":{"url":"https://github.com/ambienceai/ambienceai-mcp/issues"},"bin":{"ambienceai-mcp":"dist/index.js"},"dist":{"shasum":"2507f92233c60f6a892cb59685f4ae03ce3016f3","tarball":"https://registry.npmjs.org/@ambienceai/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":27,"integrity":"sha512-ELTnzTsYucOC1jMh3YWaC74FDqYPfG8k8LAxGLyblDyrFSu0cepL6IndQ/ZO9YiAMCrRuV03jpqhoPe5t6Z7qA==","signatures":[{"sig":"MEYCIQCc/W/anU7wNtOjhdOC1oNa/LK5d8cb0QwGrJE4ABDCSQIhAJaPDTlw8dQehVYhwmcuiuf3pRaKxqupfeYsrMOPKxyh","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ambienceai%2fmcp-server@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":130009},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"afd816f203d5bd43c38824312481444b5553c899","scripts":{"dev":"tsx watch src/index.ts","test":"NODE_OPTIONS='--experimental-vm-modules' jest","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","start":"node dist/index.js","typecheck":"tsc --noEmit","test:watch":"NODE_OPTIONS='--experimental-vm-modules' jest --watch","test:server":"node test-server.js","test:coverage":"NODE_OPTIONS='--experimental-vm-modules' jest --coverage","prepublishOnly":"npm run clean && npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","approver":{"name":"reaaz","email":"reaaz2@gmail.com"},"trustedPublisher":{"id":"github","oidcConfigId":"oidc:b3882d43-ed06-48f1-9de1-be6b6a846cd8"}},"repository":{"url":"git+https://github.com/ambienceai/ambienceai-mcp.git","type":"git"},"_npmVersion":"11.18.0","description":"Ambience AI MCP Server - Generate images, videos, and audio through Model Context Protocol","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.25.76","axios":"^1.11.0","dotenv":"^17.2.1","@modelcontextprotocol/sdk":"^1.17.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.4","jest":"^30.2.0","ts-jest":"^29.4.6","typescript":"^5.9.2","@types/jest":"^30.0.0","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1783321913268_0.2770363583408648","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@ambienceai/mcp-server","version":"1.1.1","keywords":["mcp","model-context-protocol","ambience-ai","image-generation","video-generation","audio-generation"],"author":{"name":"Ambience AI"},"license":"MIT","_id":"@ambienceai/mcp-server@1.1.1","maintainers":[{"name":"reaaz","email":"reaaz2@gmail.com"}],"homepage":"https://www.ambienceai.com/guides/connect-claude-mcp","bugs":{"url":"https://github.com/ambienceai/ambienceai-mcp/issues"},"bin":{"ambienceai-mcp":"dist/index.js"},"dist":{"shasum":"b0187dd1672ced4f3ea96fbe62742b3ef2e27262","tarball":"https://registry.npmjs.org/@ambienceai/mcp-server/-/mcp-server-1.1.1.tgz","fileCount":27,"integrity":"sha512-aO7ybTNDdhKmFEEtaNmHTwPCZzcSJq5z37omskXe2lCdf1GW4mtfuUVbofMIT1QoZmgacty3BQK2/as1pSQZIg==","signatures":[{"sig":"MEYCIQCcZENae9cgiS5mqtIP60P74zxy2tfmZnvTY8+U8x0J8wIhALXlmFxnBqMgAaDL/ZHv6rTCxwNulRpkgmhMqy19nLKM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ambienceai%2fmcp-server@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":138884},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"1de08f9dfc1ce9e967db7843f16ffba93057a55d","scripts":{"dev":"tsx watch src/index.ts","test":"NODE_OPTIONS='--experimental-vm-modules' jest","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","start":"node dist/index.js","format":"prettier --write .","typecheck":"tsc --noEmit","test:watch":"NODE_OPTIONS='--experimental-vm-modules' jest --watch","test:server":"node test-server.js","format:check":"prettier --check .","test:coverage":"NODE_OPTIONS='--experimental-vm-modules' jest --coverage","prepublishOnly":"npm run clean && npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","approver":{"name":"reaaz","email":"reaaz2@gmail.com"},"trustedPublisher":{"id":"github","oidcConfigId":"oidc:b3882d43-ed06-48f1-9de1-be6b6a846cd8"}},"repository":{"url":"git+https://github.com/ambienceai/ambienceai-mcp.git","type":"git"},"_npmVersion":"12.0.1","description":"Ambience AI MCP Server - Generate images, videos, and audio through Model Context Protocol","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.25.76","axios":"^1.11.0","dotenv":"^17.2.1","@modelcontextprotocol/sdk":"^1.17.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.4","jest":"^30.2.0","ts-jest":"^29.4.6","prettier":"3.9.5","typescript":"^5.9.2","@types/jest":"^30.0.0","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.1.1_1784517472781_0.45960171416339524","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@ambienceai/mcp-server","version":"1.2.0","keywords":["mcp","model-context-protocol","ambience-ai","image-generation","video-generation","audio-generation"],"author":{"name":"Ambience AI"},"license":"MIT","_id":"@ambienceai/mcp-server@1.2.0","maintainers":[{"name":"reaaz","email":"reaaz2@gmail.com"}],"homepage":"https://www.ambienceai.com/guides/connect-claude-mcp","bugs":{"url":"https://github.com/ambienceai/ambienceai-mcp/issues"},"bin":{"ambienceai-mcp":"dist/index.js"},"dist":{"shasum":"c2fa34c73322a3016f91cff866458932a7f5e7cd","tarball":"https://registry.npmjs.org/@ambienceai/mcp-server/-/mcp-server-1.2.0.tgz","fileCount":27,"integrity":"sha512-CW/83lbuN16NlQ56irn28/jzSCu47O+zKlmt4SnmDq3hgbkIQVwf8T0TvHFCjBiQrtMJw10pkh46VCGwpQzQkA==","signatures":[{"sig":"MEUCIDqnXKUz6QW9oVOPI6cohxj4gV5wtbKxBGHtgXCGMvm+AiEA7p3ZD1fID5zV8vDLjcr5liRan7laeA6ss3B3mBw81XU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ambienceai%2fmcp-server@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":157684},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"0137c0d5d3a8858826ce298fdcbc1c0128d9fc4b","scripts":{"dev":"tsx watch src/index.ts","test":"NODE_OPTIONS='--experimental-vm-modules' jest","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","start":"node dist/index.js","format":"prettier --write .","typecheck":"tsc --noEmit","test:watch":"NODE_OPTIONS='--experimental-vm-modules' jest --watch","test:server":"node test-server.js","format:check":"prettier --check .","test:coverage":"NODE_OPTIONS='--experimental-vm-modules' jest --coverage","prepublishOnly":"npm run clean && npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","approver":{"name":"reaaz","email":"reaaz2@gmail.com"},"trustedPublisher":{"id":"github","oidcConfigId":"oidc:b3882d43-ed06-48f1-9de1-be6b6a846cd8"}},"repository":{"url":"git+https://github.com/ambienceai/ambienceai-mcp.git","type":"git"},"_npmVersion":"12.0.1","description":"Ambience AI MCP Server - Generate images, videos, and audio through Model Context Protocol","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.25.76","axios":"^1.11.0","dotenv":"^17.2.1","@modelcontextprotocol/sdk":"^1.17.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.4","jest":"^30.2.0","ts-jest":"^29.4.6","prettier":"3.9.5","typescript":"^5.9.2","@types/jest":"^30.0.0","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.2.0_1784866529544_0.19195431046003875","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"_id":"@ambienceai/mcp-server@1.3.0","bin":{"ambienceai-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/ambienceai/ambienceai-mcp/issues"},"dist":{"shasum":"ae73d5369eca4d9130d2bf0b1a8115567c46f652","tarball":"https://registry.npmjs.org/@ambienceai/mcp-server/-/mcp-server-1.3.0.tgz","integrity":"sha512-oI9nFwx9D+aK1dJ7hQWF+88dlnggsPxao21Blglbdy5YpKIqU+vOOrxizHDHhu8XbCCiFpcZRDDxfg0c9mJcdA==","fileCount":27,"unpackedSize":159309,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ambienceai%2fmcp-server@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID9FbLKRRxIU4Ou9ASR+KxaraX9f96bSZX35GzHT0PQnAiA2iNrCnPmmpFJhPtK2VXYtAC8c+LjW5DzPH/cXotthxQ=="}]},"main":"dist/index.js","name":"@ambienceai/mcp-server","type":"module","types":"./dist/index.d.ts","author":{"name":"Ambience AI"},"engines":{"node":">=18.0.0"},"gitHead":"9e4a83499c4638feca79de7ac87dd731d30bf9d4","license":"MIT","scripts":{"dev":"tsx watch src/index.ts","test":"NODE_OPTIONS='--experimental-vm-modules' jest","build":"tsc -p tsconfig.build.json","clean":"rm -rf dist","start":"node dist/index.js","format":"prettier --write .","typecheck":"tsc --noEmit","test:watch":"NODE_OPTIONS='--experimental-vm-modules' jest --watch","test:server":"node test-server.js","format:check":"prettier --check .","test:coverage":"NODE_OPTIONS='--experimental-vm-modules' jest --coverage","prepublishOnly":"npm run clean && npm run typecheck && npm test && npm run build"},"version":"1.3.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:b3882d43-ed06-48f1-9de1-be6b6a846cd8"},"approver":{"name":"reaaz","email":"reaaz2@gmail.com"}},"homepage":"https://www.ambienceai.com/guides/connect-claude-mcp","keywords":["mcp","model-context-protocol","ambience-ai","image-generation","video-generation","audio-generation"],"repository":{"url":"git+https://github.com/ambienceai/ambienceai-mcp.git","type":"git"},"_npmVersion":"12.0.2","description":"Ambience AI MCP Server - Generate images, videos, and audio through Model Context Protocol","directories":{},"maintainers":[{"name":"reaaz","email":"reaaz2@gmail.com"}],"_nodeVersion":"24.20.0","dependencies":{"zod":"^3.25.76","axios":"^1.11.0","dotenv":"^17.2.1","@modelcontextprotocol/sdk":"^1.17.4"},"publishConfig":{"access":"public"},"devDependencies":{"tsx":"^4.20.4","jest":"^30.2.0","ts-jest":"^29.4.6","prettier":"3.9.5","typescript":"^5.9.2","@types/jest":"^30.0.0","@types/node":"^24.3.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.3.0_1788550069691_0.36963592204573215"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-06T06:42:25.111Z","modified":"2026-09-04T19:27:50.113Z","1.0.0":"2026-07-06T06:42:25.385Z","1.0.1":"2026-07-06T07:11:53.350Z","1.1.1":"2026-07-20T03:17:52.853Z","1.2.0":"2026-07-24T04:15:29.650Z","1.3.0":"2026-09-04T19:27:49.788Z"},"bugs":{"url":"https://github.com/ambienceai/ambienceai-mcp/issues"},"author":{"name":"Ambience AI"},"license":"MIT","homepage":"https://www.ambienceai.com/guides/connect-claude-mcp","keywords":["mcp","model-context-protocol","ambience-ai","image-generation","video-generation","audio-generation"],"repository":{"url":"git+https://github.com/ambienceai/ambienceai-mcp.git","type":"git"},"description":"Ambience AI MCP Server - Generate images, videos, and audio through Model Context Protocol","maintainers":[{"name":"reaaz","email":"reaaz2@gmail.com"}],"readme":"# Ambience AI MCP Server\n\nA [Model Context Protocol](https://modelcontextprotocol.io/) server that connects Claude to [Ambience AI](https://www.ambienceai.com) for creating images, videos, music, and speech. Ask Claude for a cozy cabin scene or a custom soundtrack, and the creation lands in your Ambience AI library.\n\nNo API keys are stored in this server. It forwards your Ambience AI account token to the backend, which handles all authentication and billing.\n\n## Quick Start\n\n**What you need:**\n\n- An Ambience AI account on the [Premium, Team, or Business plan](https://www.ambienceai.com/pricing)\n- Node.js 18 or newer\n- Claude Desktop or Claude Code\n\nNew to Ambience AI? [Create an account](https://www.ambienceai.com/pricing) and pick the Premium, Team, or Business plan, then come back here. Plans start at $15/month and include monthly credits for images, videos, music, and speech.\n\n**1. Create your API token**\n\nSign in to Ambience AI, open Settings, find the API Tokens card, and select Create API Token. Copy the token right away; it is shown only once.\n\n**2. Add the server to Claude**\n\nFor Claude Code, run this in your terminal:\n\n```bash\nclaude mcp add ambience --env AMBIENCE_ACCESS_TOKEN=YOUR_TOKEN -- npx -y @ambienceai/mcp-server\n```\n\nFor Claude Desktop, add this to `claude_desktop_config.json` and restart the app:\n\n```json\n{\n  \"mcpServers\": {\n    \"ambience\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ambienceai/mcp-server\"],\n      \"env\": {\n        \"AMBIENCE_ACCESS_TOKEN\": \"YOUR_TOKEN\"\n      }\n    }\n  }\n}\n```\n\nConfig file locations:\n\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n**3. Create something**\n\nAsk Claude: _\"Create an image of a cozy cabin in a snowstorm, warm light glowing from the windows.\"_\n\nFor a full walkthrough with screenshots, see the [setup guide](https://www.ambienceai.com/guides/connect-claude-mcp).\n\n## Available Tools\n\n| Tool                   | What it does                                                                                |\n| ---------------------- | ------------------------------------------------------------------------------------------- |\n| `generate_image`       | Create an image from a text prompt                                                          |\n| `generate_image_multi` | Create an image from multiple input images for editing, composition, or style mixing        |\n| `generate_video`       | Create a video from a text prompt                                                           |\n| `generate_music`       | Create instrumental tracks, songs with lyrics, or ambient soundscapes                       |\n| `generate_speech`      | Convert written text into natural-sounding speech                                           |\n| `generate_chart`       | Create a bar, line, pie, or KPI counter chart from data, as an image or animated video      |\n| `generate_audio`       | Legacy speech and music tool (use `generate_music` or `generate_speech` for better control) |\n| `transcribe_audio`     | Convert speech to text, subtitles, or captions                                              |\n| `upscale_image`        | Increase image resolution up to 4x while preserving quality                                 |\n| `get_credits`          | Check your current credit balance                                                           |\n| `get_library`          | Browse your generated creations                                                             |\n| `get_creation_status`  | Check the status of a specific creation                                                     |\n\nAvailable models, credit costs, and default models are fetched live from the Ambience AI API, so tool descriptions stay current without a server update. Omitting the model parameter uses the server's current recommended default.\n\n## Configuration\n\n| Environment variable    | Required | Default                      | Purpose                                                                                 |\n| ----------------------- | -------- | ---------------------------- | --------------------------------------------------------------------------------------- |\n| `AMBIENCE_ACCESS_TOKEN` | Yes      | none                         | Your Ambience AI API token                                                              |\n| `AMBIENCE_API_URL`      | No       | `https://www.ambienceai.com` | Backend URL; set to `http://localhost:3000` for local development against a dev backend |\n\n## Troubleshooting\n\n- **`subscription_required` errors**: MCP access is included with the Premium, Team, and Business plans. Check that your account or organization is on one of those plans, and that your token was created from that account.\n- **Authentication errors**: tokens expire after 90 days, and deleted tokens stop working right away. Create a fresh token in your Ambience AI settings and update your Claude configuration.\n- **Server doesn't appear in Claude**: restart Claude Desktop after editing the config file, and confirm Node.js 18 or newer is installed so `npx` can run.\n- **Timeouts**: video and image generation can take a few minutes. Use `get_creation_status` to track long-running creations.\n\n## Contributing\n\nBug reports and pull requests are welcome on [GitHub](https://github.com/ambienceai/ambienceai-mcp). For development setup, testing, and release guidelines, see [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n## License\n\nMIT License. See [LICENSE](./LICENSE) for details.\n","readmeFilename":"README.md"}