{"_id":"@addai/entity-browser-mcp","name":"@addai/entity-browser-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@addai/entity-browser-mcp","version":"0.1.0","description":"MCP server that gives a +Ai entity the browser credentials for its own user account, so it can sign into the +Ai apps as itself and look around.","license":"MIT","keywords":["addai","entity-studio","mcp","browser-login"],"repository":{"type":"git","url":"git+https://github.com/just-AddAi/addai-entity-studio.git","directory":"mcp/entity-browser-mcp"},"type":"module","main":"dist/index.js","bin":{"entity-browser-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-browser-mcp@0.1.0","gitHead":"64a52cefcc68b00f7d10ab789d90879a7481f5f8","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-Lr/a/LDrhZ4YjK7JnzmGUm0rgFwxTyHudZCN3B2fjQ/gL9WF4kXZRh9i6UAOsCwUkazLJfuVDdkRuWflMpaeBg==","shasum":"01392081219f5fc2bded931a02955bd5e3b24c87","tarball":"https://registry.npmjs.org/@addai/entity-browser-mcp/-/entity-browser-mcp-0.1.0.tgz","fileCount":4,"unpackedSize":8366,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICFVQ6/418uyhqIeHw2QrvfEjL3FYiWM1LE/lFKm4P4xAiEA8UgsR7xnYWBp3gahpbjAj2+JkEVbiW7FMHCDeJVarGg="}]},"_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-browser-mcp_0.1.0_1785754597756_0.28689436863490614"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-03T10:56:37.548Z","0.1.0":"2026-08-03T10:56:37.890Z","modified":"2026-08-03T10:56:38.102Z"},"maintainers":[{"name":"addai","email":"npm@add.ai"}],"description":"MCP server that gives a +Ai entity the browser credentials for its own user account, so it can sign into the +Ai apps as itself and look around.","homepage":"https://github.com/just-AddAi/addai-entity-studio#readme","keywords":["addai","entity-studio","mcp","browser-login"],"repository":{"type":"git","url":"git+https://github.com/just-AddAi/addai-entity-studio.git","directory":"mcp/entity-browser-mcp"},"bugs":{"url":"https://github.com/just-AddAi/addai-entity-studio/issues"},"license":"MIT","readme":"# @addai/entity-browser-mcp\n\nGives a +Ai entity the browser credentials for **its own user account**, so it\ncan sign into the +Ai apps and look around the way a person does.\n\nAuthenticates with a single env var, `ENTITY_API_KEY` — an `ait_ent_*` key that\nEntity Studio provisions automatically when **Browser Login** is switched on for\nan entity. The tool acts only on the entity that owns the key.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `get_my_login` | Returns the email and a freshly minted password for the entity's own account |\n\n## What this is, and isn't\n\nThis server is the **key**, not the hands. It does not drive a browser — pair it\nwith the Chrome DevTools or Playwright MCP, which do.\n\nEntities are real users: each has an `auth.users` row, a profile, and viewer\n(read-only) workspace membership. `get_my_login` returns credentials for that\naccount so the entity can sign in at `auth.add.ai/login`. One login covers every\n`*.add.ai` app — the session is shared domain-wide.\n\n## The password rotates on every call\n\nNothing is stored readable. The password exists only inside the response to a\nsingle call, and minting a new one **revokes the entity's existing sessions** —\nso exactly one live session exists per rotation. Consequences worth knowing:\n\n- Call it immediately before signing in, never in advance.\n- Calling it twice in one login kills the session the first call opened.\n- Every call is recorded in `entity_login_rotations` with the optional `reason`,\n  and the entity's owner sees that list on the Browser Login card in Studio.\n\n## Guards\n\nTwo independent locks, and both must be open:\n\n1. **The switch.** `entity_self_rotate_login` refuses unless the entity has\n   `browser_login_enabled` — returns `browser_login_disabled`. Attaching this\n   MCP by hand does not grant the ability.\n2. **Entity accounts only.** The RPC refuses to rotate any `auth.users` row\n   whose provider is not `entity`, so a stolen entity key cannot be aimed at a\n   human's account.\n\n## History\n\n`get_my_login` shipped inside `@addai/entity-self-mcp` (0.1.0–0.5.0). That tied\nbrowsing-as-yourself to self-editing — two unrelated abilities behind one app,\nso an entity with Browser Login switched on but no Self-Edit had a switch that\ngranted nothing. It moved here in `entity-self-mcp` 0.6.0.\n\n## Local run\n\n```bash\nnpm install\nENTITY_API_KEY=ait_ent_… npm run dev\n```\n","readmeFilename":"README.md","_rev":"1-4530fa5d38ce3c64adfed8856e60eaec"}