{"_id":"@addai/entity-self-mcp","_rev":"7-348da46ddc0b41431a9140b075710ea8","name":"@addai/entity-self-mcp","dist-tags":{"latest":"0.6.0"},"versions":{"0.1.2":{"name":"@addai/entity-self-mcp","version":"0.1.2","keywords":["addai","entity-studio","mcp","self-edit"],"license":"MIT","_id":"@addai/entity-self-mcp@0.1.2","maintainers":[{"name":"addai","email":"npm@add.ai"}],"homepage":"https://github.com/just-AddAi/addai-entity-self-mcp#readme","bugs":{"url":"https://github.com/just-AddAi/addai-entity-self-mcp/issues"},"bin":{"entity-self-mcp":"dist/index.js"},"dist":{"shasum":"aecc21291d2a03c7e71bb21535e90fc0ba6b497b","tarball":"https://registry.npmjs.org/@addai/entity-self-mcp/-/entity-self-mcp-0.1.2.tgz","fileCount":3,"integrity":"sha512-VTi+1tAmbg3KPAB+Q4V1Z4HApzECXiw2gcNBrSp9DI0u4l+2KUShMBI6gsl7fM04vGJR1zE2DtrUMWHuliaxMQ==","signatures":[{"sig":"MEQCIA5y4vqHlCdRbQxcgVQ5KUMG97Mnermw7vGwIDECA7KAAiBOW2vFzMhEmnx8/clwxZjgaSczcSIDps4HTxnL/RJq8Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10648},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc -p tsconfig.json && node dist/index.js","build":"tsc -p tsconfig.json","clean":"rm -rf dist"},"_npmUser":{"name":"addai","email":"npm@add.ai"},"repository":{"url":"git+https://github.com/just-AddAi/addai-entity-self-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server that lets a +Ai entity read and update its own config and schedules.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/entity-self-mcp_0.1.2_1783383912581_0.7054177820679219","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@addai/entity-self-mcp","version":"0.1.3","keywords":["addai","entity-studio","mcp","self-edit"],"license":"MIT","_id":"@addai/entity-self-mcp@0.1.3","maintainers":[{"name":"addai","email":"npm@add.ai"}],"homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"bin":{"entity-self-mcp":"dist/index.js"},"dist":{"shasum":"67c159ca04fc6dbe25f7d3dbfd8754f05bf26ef3","tarball":"https://registry.npmjs.org/@addai/entity-self-mcp/-/entity-self-mcp-0.1.3.tgz","fileCount":4,"integrity":"sha512-yTqASKMBRkFUJa/da3nYw9FBLoFqN0YlLLvZXSATGPvZIX6Py5q4Ukle3/qeg5A0mzIFqtEYYfre/0PjAmH6hw==","signatures":[{"sig":"MEUCIQCFv08Hq2LsGfJfEKez54peiNrJ+GyC9qhEXE5RPEyCHgIgX/LAdvD7BFKNkL5ROrppcZJscxHw2q38yTNedFT04ak=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14170},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc -p tsconfig.json && node dist/index.js","build":"tsc -p tsconfig.json && chmod +x dist/index.js","clean":"rm -rf dist"},"_npmUser":{"name":"addai","email":"npm@add.ai"},"repository":{"url":"git+https://github.com/just-AddAi/addai-entity-studio.git","type":"git","directory":"mcp/entity-self-mcp"},"_npmVersion":"10.9.2","description":"MCP server that lets a +Ai entity read and update its own config, skills and schedules, and obtain its own browser login.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/entity-self-mcp_0.1.3_1785340999034_0.26384758631792393","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@addai/entity-self-mcp","version":"0.2.0","keywords":["addai","entity-studio","mcp","self-edit"],"license":"MIT","_id":"@addai/entity-self-mcp@0.2.0","maintainers":[{"name":"addai","email":"npm@add.ai"}],"homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"bin":{"entity-self-mcp":"dist/index.js"},"dist":{"shasum":"99fcbaa25b8d98210868067852e565b2b738e883","tarball":"https://registry.npmjs.org/@addai/entity-self-mcp/-/entity-self-mcp-0.2.0.tgz","fileCount":4,"integrity":"sha512-AxDDr5VCuGoz6xIv6B5HZT9vX/RUPlFCYA5ooaoecp4zV1v5jFBHL3YOOfJHeJgmfmMY2WgN9nqo2KeOrCrkTw==","signatures":[{"sig":"MEUCIAvpNZB7X+cJFqTMIg6mtkRu7E/WR1DXm1C5mNOF6FGuAiEAlMyL6dfts6NeMijOfxTHhQz3qcEs7t3BHKhVHjuz9II=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16133},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc -p tsconfig.json && node dist/index.js","build":"tsc -p tsconfig.json && chmod +x dist/index.js","clean":"rm -rf dist"},"_npmUser":{"name":"addai","email":"npm@add.ai"},"repository":{"url":"git+https://github.com/just-AddAi/addai-entity-studio.git","type":"git","directory":"mcp/entity-self-mcp"},"_npmVersion":"10.9.2","description":"MCP server that lets a +Ai entity read and update its own config, skills and schedules, and obtain its own browser login.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/entity-self-mcp_0.2.0_1785426046420_0.4865031497086332","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@addai/entity-self-mcp","version":"0.2.1","keywords":["addai","entity-studio","mcp","self-edit"],"license":"MIT","_id":"@addai/entity-self-mcp@0.2.1","maintainers":[{"name":"addai","email":"npm@add.ai"}],"homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"bin":{"entity-self-mcp":"dist/index.js"},"dist":{"shasum":"289ab7a724270e5b8e49ec77aa1c38b61d9e748f","tarball":"https://registry.npmjs.org/@addai/entity-self-mcp/-/entity-self-mcp-0.2.1.tgz","fileCount":4,"integrity":"sha512-/6zXg9gsGzQbzXJhszti6hhHghDA1gEhPA+CHjkSnRBaLXl1u5ThFBxauJibzbvL9HVkQL3tuOjnWgwfBt2yYg==","signatures":[{"sig":"MEUCIAEFlRvbBGR3W4bb3aY2xKGd514oR0rM0NOYlgQkZX5QAiEAlMHvpN0VkDWMOZTH6vQ5dK1HV0C9dYN1JUJmrMdywKg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":16155},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"scripts":{"dev":"tsc -p tsconfig.json && node dist/index.js","build":"tsc -p tsconfig.json && chmod +x dist/index.js","clean":"rm -rf dist"},"_npmUser":{"name":"addai","email":"npm@add.ai"},"repository":{"url":"git+https://github.com/just-AddAi/addai-entity-studio.git","type":"git","directory":"mcp/entity-self-mcp"},"_npmVersion":"10.9.2","description":"MCP server that lets a +Ai entity read and update its own config, skills and schedules, and obtain its own browser login.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/entity-self-mcp_0.2.1_1785498579804_0.5410161515285081","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@addai/entity-self-mcp","version":"0.4.0","keywords":["addai","entity-studio","mcp","self-edit"],"license":"MIT","_id":"@addai/entity-self-mcp@0.4.0","maintainers":[{"name":"addai","email":"npm@add.ai"}],"homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"bin":{"entity-self-mcp":"dist/index.js"},"dist":{"shasum":"e3d5480b50ce6e71570b424210470ff66087f81c","tarball":"https://registry.npmjs.org/@addai/entity-self-mcp/-/entity-self-mcp-0.4.0.tgz","fileCount":4,"integrity":"sha512-ih3QAheG3Emum8npwkCxFHCdSFzs34HuKQVl2CqxzHG6psXWPsJ08+admCkT5654cgvlySh2k/SxWeBaLOMdUA==","signatures":[{"sig":"MEQCIGVCLoxrY88HzlLaoht8cvlPm6ltxMI7NKBaX2KcuOnoAiA80LoK6+EqNgIT3wywCkQ8bjiPuwrCXpL1GIUFX8sQ2Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23350},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"8c64df54c82dab5685eba576b44636726187b140","scripts":{"dev":"tsc -p tsconfig.json && node dist/index.js","build":"tsc -p tsconfig.json && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"","clean":"rm -rf dist"},"_npmUser":{"name":"addai","email":"npm@add.ai"},"repository":{"url":"git+https://github.com/just-AddAi/addai-entity-studio.git","type":"git","directory":"mcp/entity-self-mcp"},"_npmVersion":"10.9.2","description":"MCP server that lets a +Ai entity read and update its own config, avatar and live status/progress, manage its skills and schedules, propose learnings to the entity it is an instance of, and obtain its own browser login.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/entity-self-mcp_0.4.0_1785506097329_0.602145434922728","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@addai/entity-self-mcp","version":"0.5.0","keywords":["addai","entity-studio","mcp","self-edit"],"license":"MIT","_id":"@addai/entity-self-mcp@0.5.0","maintainers":[{"name":"addai","email":"npm@add.ai"}],"homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"bin":{"entity-self-mcp":"dist/index.js"},"dist":{"shasum":"a317fcf8289a516b043f46c965ee5fe5f6e490a1","tarball":"https://registry.npmjs.org/@addai/entity-self-mcp/-/entity-self-mcp-0.5.0.tgz","fileCount":4,"integrity":"sha512-Am4B3kq42BPsTphbcae8+4cteYg2lGn9I3g9rb/WDR4OfgGNc3Q6mTxbIWfqVeXzy17xbtJq6S62J3ZKD2Q5/w==","signatures":[{"sig":"MEYCIQCHb6kc75KioVu5O4jLsFkNt5hxWv76Rhv0WGlPOu+/8QIhALHMGrbJDoeoS4Fnq657Hleazwque87+ZjLhlSQjrQUW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24977},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"7aa9c5faee2ec29757422d4d33e4be7c6fd501db","scripts":{"dev":"tsc -p tsconfig.json && node dist/index.js","build":"tsc -p tsconfig.json && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"","clean":"rm -rf dist"},"_npmUser":{"name":"addai","email":"npm@add.ai"},"repository":{"url":"git+https://github.com/just-AddAi/addai-entity-studio.git","type":"git","directory":"mcp/entity-self-mcp"},"_npmVersion":"10.9.2","description":"MCP server that lets a +Ai entity read and update its own config, avatar and live status/progress (with a built-in Living Presence directive), manage its skills and schedules, propose learnings to the entity it is an instance of, and obtain its own browse","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/entity-self-mcp_0.5.0_1785507417150_0.9623886946375706","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@addai/entity-self-mcp","version":"0.6.0","description":"MCP server that lets a +Ai entity read and update its own config, avatar and live status/progress (with a built-in Living Presence directive), manage its skills and schedules, propose learnings to the entity it is an instance of.","license":"MIT","keywords":["addai","entity-studio","mcp","self-edit"],"repository":{"type":"git","url":"git+https://github.com/just-AddAi/addai-entity-studio.git","directory":"mcp/entity-self-mcp"},"type":"module","main":"dist/index.js","bin":{"entity-self-mcp":"dist/index.js"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"","dev":"tsc -p tsconfig.json && node dist/index.js","clean":"rm -rf dist","prepublishOnly":"npm run build"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.6.0"},"_id":"@addai/entity-self-mcp@0.6.0","gitHead":"a92a3c71918bcd92096fb9152d04d2ead72c18f2","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-7I+GyQD/SER8CZ/egs0w0XsngOhe+94eh24uqJa8Kmbs7doXy0cHlNlVziZFzTUGMqg+X8+jWGUUuOHsxEZXhg==","shasum":"d700acbf46b82a51cc1d66de989485f6c194cb02","tarball":"https://registry.npmjs.org/@addai/entity-self-mcp/-/entity-self-mcp-0.6.0.tgz","fileCount":4,"unpackedSize":23228,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIH8M51pw105DKAawdzfjWD5Vmq+psL4hl72CW++FVRKQAiBssoekthGWibCGYjp5wJtpdyQVP4vRNQwg5wJZmsHjIw=="}]},"_npmUser":{"name":"addai","email":"npm@add.ai"},"directories":{},"maintainers":[{"name":"addai","email":"npm@add.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/entity-self-mcp_0.6.0_1785764866620_0.32794735904057615"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-07T00:25:12.432Z","modified":"2026-08-03T13:47:46.951Z","0.1.2":"2026-07-07T00:25:12.719Z","0.1.3":"2026-07-29T16:03:19.192Z","0.2.0":"2026-07-30T15:40:46.585Z","0.2.1":"2026-07-31T11:49:39.928Z","0.4.0":"2026-07-31T13:54:57.482Z","0.5.0":"2026-07-31T14:16:57.322Z","0.6.0":"2026-08-03T13:47:46.782Z"},"bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"license":"MIT","homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","keywords":["addai","entity-studio","mcp","self-edit"],"repository":{"type":"git","url":"git+https://github.com/just-AddAi/addai-entity-studio.git","directory":"mcp/entity-self-mcp"},"description":"MCP server that lets a +Ai entity read and update its own config, avatar and live status/progress (with a built-in Living Presence directive), manage its skills and schedules, propose learnings to the entity it is an instance of.","maintainers":[{"name":"addai","email":"npm@add.ai"}],"readme":"# @addai/entity-self-mcp\n\nMCP server that lets a +Ai entity manage **itself**: its own config, skills and\nschedules.\n\nAuthenticates with a single env var, `ENTITY_API_KEY` — an `ait_ent_*` key that\nEntity Studio provisions automatically when this MCP is attached to an entity.\nEvery tool acts only on the entity that owns the key.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `get_config` | Read own name, description, system prompt, model, effort |\n| `update_system_prompt` / `update_description` / `rename` | Edit own identity |\n| `update_model` / `update_effort` | Change own model / reasoning effort |\n| `set_avatar` / `clear_avatar` | Set own avatar/profile picture from an image URL (re-hosted), or revert to the default |\n| `generate_avatar` | Generate a new avatar from a text prompt and set it (when image-gen is configured) |\n| `list_skills` / `create_skill` / `update_skill` | Manage own persistent skills |\n| `list_schedules` / `create_schedule` / `update_schedule` / `delete_schedule` | Manage own cron schedules |\n\n## Browser login moved out\n\n`get_my_login` shipped here through 0.5.0. Browsing as yourself and editing\nyourself are unrelated abilities, and pairing them meant an entity with Browser\nLogin switched on but no Self-Edit had a switch that granted nothing. It lives\nin [`@addai/entity-browser-mcp`](../entity-browser-mcp) as of 0.6.0.\n\n## set_avatar / clear_avatar / generate_avatar\n\nAn entity can set its own picture without a human opening Entity Studio.\n\n`set_avatar({ image_url })` takes a link to an image the entity already has (a\nDrive image, a generated image URL, any public image). The `entity-self-avatar`\nedge function **fetches and re-hosts** it into GCS (`storage.add.ai/entity-avatars/…`,\nthe same bucket + path the human upload path uses), so the picture is permanent\nand never breaks if the original link expires or is access-controlled. Supported:\npng / jpeg / webp / gif, up to 15MB. `generate_avatar({ prompt })` makes a new\npicture from text and sets it the same way (returns `image_gen_not_configured`\nwhen no image-gen key is set — fall back to `set_avatar`). `clear_avatar()`\nreverts to the default.\n\nWrites go to `entity_studio_entities.avatar_url` (+ the `avatar_set` bundle's\n`still_url` / `poses.default`); the existing `entity_sync_profile` trigger\npropagates `avatar_url` to `user_profiles`, so the new picture shows consistently\nin chat, DMs, mentions, schedules, People columns, the Studio and people pickers —\nidentical to a human upload. An entity can only ever change **its own** avatar\n(resolved from its key); admins still override via the Studio UI, which writes the\nsame columns.\n\n## Development\n\nSource lives in `addai-entity-studio/mcp/entity-self-mcp` (versions ≤ 0.1.2 were\npublished from a repo that no longer exists and were reconstructed from the\npublished `dist`).\n\n```bash\nnpm install\nnpm run build\nnpm publish\n```\n\nThe MCP catalog entry (`codeflows_mcps`, slug `entity-self-mcp`) runs\n`npx -y @addai/entity-self-mcp@latest`, so a published version reaches entities\non their next run.\n","readmeFilename":"README.md"}