profile_create
Creates a new browser identity with a self-consistent fingerprint frozen on creation and preserved across restarts. Define its name, engine, proxy, OS, and startup tabs.
Instructions
Create a new identity. Its fingerprint is generated and frozen on the spot.
You do not choose the fingerprint — the point of the product is that every identity gets one self-consistent, frozen set of traits that stays byte-identical across restarts. Do not create identities speculatively: they count against the installation's quota.
Args:
name: the new identity's name. Must be unique — creating a name that
already exists fails rather than overwriting it.
engine: which browser core backs the identity. Leave unset to use this
installation's default; an unknown value is rejected with the list
of accepted ones. The engine field in profiles_list shows what
existing identities use.
proxy: exit proxy URL, e.g. "http://user:pass@host:port" or
"socks5://host:port" — any vendor, bring your own. Omit it and the
identity runs on a direct connection. Test a URL with proxy_check
before binding it here.
group, tags, note: the local ledger — which account, email, or purpose
this identity is bound to. Free text, searchable in the app, and
returned under meta by profiles_list.
urls: startup tabs — pages opened automatically when the identity starts.
force_dark: personal display preference, OFF by default. True inverts
web pages that have no dark theme of their own (Google Ads and the
like) to dark; sites may notice the changed colors, so use it only
on identities the user manages for themselves, never on accounts
being built up. Leave unset to keep pages exactly as the sites
render them. Chrome-engine identities only.
os: which operating system the identity presents as: "windows",
"macos", "linux", "android" or "ios". Leave unset for this
computer's own OS. "android" and "ios" are phone identities: Chrome
engine only, and they need a recent Chrome kernel (an older one is
rejected with os_needs_kernel). "ios" is simulated: it sets the
browser identity, screen and touch to match an iPhone, suited to
mobile web pages.
mobile_model: the phone model for an "android" / "ios" identity, as an
id. If you leave it unset and the OS has no default model yet, the
call is rejected with mobile_model_required and the message lists
the accepted ids — pick one and call again. Ignored for desktop OSes
(passing it there is rejected).
Returns {name, os, created}. Fails with a readable message if the name is taken (409), if the quota is reached or the installation is unauthorized (403), or if an argument is rejected (422).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "profile_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| os | No | ||
| name | Yes | ||
| note | No | ||
| tags | No | ||
| urls | No | ||
| group | No | ||
| proxy | No | ||
| engine | No | ||
| force_dark | No | ||
| mobile_model | No |