{"_id":"@caranguejo/mcp","name":"@caranguejo/mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@caranguejo/mcp","version":"1.0.0","description":"Model Context Protocol server for the Caranguejo Developer API.","type":"module","bin":{"caranguejo-mcp":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc -p tsconfig.build.json","dev":"tsx src/index.ts","start":"node dist/index.js","prepublishOnly":"npm run build"},"keywords":["caranguejo","mcp","model-context-protocol","ai","image-generation"],"license":"MIT","dependencies":{"@caranguejo/sdk":"^1.0.0","@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.12.0","tsx":"^4.19.2","typescript":"^5.7.3"},"gitHead":"27fa6226276011b999bb1db45d424090162bc435","_id":"@caranguejo/mcp@1.0.0","_nodeVersion":"24.16.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-YSRZN2sSVrM/btKQquu5u02ChPRsPIjILn5yuseMeQgqbRaJgr+q6Kdwhwin4EBbfoeQ9ss1Qc3UIMQOOBPt3A==","shasum":"a40555d9dc51a56ef2ea469fb582066118c671a0","tarball":"https://registry.npmjs.org/@caranguejo/mcp/-/mcp-1.0.0.tgz","fileCount":6,"unpackedSize":21172,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCZAtjsJ8VEt1JfO0iyxyhij4Y/m8M/xEnXpo158UIpjgIhAJrA/5nfZcD4IZubtE53AOmtldZYDEdvPdscKtZMUa7p"}]},"_npmUser":{"name":"caranguejo-art","email":"matheus@caranguejo.art"},"directories":{},"maintainers":[{"name":"caranguejo-art","email":"matheus@caranguejo.art"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.0_1783186484807_0.7442407785994771"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T17:34:44.673Z","1.0.0":"2026-07-04T17:34:44.944Z","modified":"2026-07-04T17:34:45.135Z"},"maintainers":[{"name":"caranguejo-art","email":"matheus@caranguejo.art"}],"description":"Model Context Protocol server for the Caranguejo Developer API.","keywords":["caranguejo","mcp","model-context-protocol","ai","image-generation"],"license":"MIT","readme":"# @caranguejo/mcp\n\n[Model Context Protocol](https://modelcontextprotocol.io) server for the\n[Caranguejo Developer API](https://docs.caranguejo.art). Lets MCP clients\n(Claude Desktop, Claude Code, Cursor, …) generate images through your Caranguejo\naccount.\n\n## Configure\n\nAdd it to your MCP client. Get a `ck_live_…` key from **Account → Apps & API**.\n\n**Claude Desktop / Cursor** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"caranguejo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@caranguejo/mcp\"],\n      \"env\": { \"CARANGUEJO_API_KEY\": \"ck_live_xxxxxxxx\" }\n    }\n  }\n}\n```\n\n**Claude Code** (`.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"caranguejo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@caranguejo/mcp\"],\n      \"env\": { \"CARANGUEJO_API_KEY\": \"ck_live_xxxxxxxx\" }\n    }\n  }\n}\n```\n\nOr: `claude mcp add caranguejo --env CARANGUEJO_API_KEY=ck_live_xxx -- npx -y @caranguejo/mcp`\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `generate_image` | Text→image or edit/reference; waits for the result by default |\n| `get_generation_status` | Poll a job and fetch output URLs |\n| `upload_file` | Host a local file, get a public URL for `image_urls` |\n| `list_generations` | Your API generations |\n| `get_balance` | Credit balance |\n| `list_models` | Model capabilities |\n\n## Resources\n\n- `caranguejo://models` — live model capabilities\n- `caranguejo://pricing` — credit cost matrix\n\nTransport is **stdio**. Set `CARANGUEJO_BASE_URL` to point at a non-default API.\n\nFull docs: **https://docs.caranguejo.art**\n","readmeFilename":"README.md","_rev":"1-c3d9cbe6508ae5ff3d48cc037d5f7e6f"}