Get Bluesky Profile
bsky_get_profileFetch a Bluesky actor's public profile by handle (e.g. "bsky.app") or DID (e.g. "did:plc:z72i7hdynmk6r22z27h6tvur"). Returns displayName, handle, DID, bio, pronouns, website, ordered profile links, follower/following/post counts, associated list/feed/starter-pack counts and labeler status when supplied, avatar URL, moderation labels, pinned post AT-URI, and Bluesky verification — whether the account is verified or a trusted verifier, and who verified it. Use this as the first step to resolve a handle to a DID before calling tools that require a DID or AT-URI. Handles and DIDs are interchangeable as input, and "@bsky.app" or the account's bsky.app page (https://bsky.app/profile/bsky.app) work as-is.
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": {
"actor": "<actor>"
},
"name": "bsky_get_profile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | Yes | Handle (e.g. "bsky.app", "alice.bsky.social") or DID (e.g. "did:plc:z72i7hdynmk6r22z27h6tvur") of the actor to look up. A leading "@" ("@bsky.app") and the account's bsky.app page ("https://bsky.app/profile/bsky.app") are accepted and read as the handle or DID they carry. A bare name without a dot is not a handle — use bsky_search_actors to resolve one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| did | No | Decentralized Identifier — the permanent, portable identity key for this account. | |
| error | No | Present when the call failed. Absent on success. | |
| links | No | Profile links in upstream display order. Omitted when not supplied; an explicit empty array stays empty. | |
| avatar | No | URL of the profile avatar image. | |
| handle | No | Human-readable username, e.g. "alice.bsky.social". | |
| labels | No | Moderation labels applied to this profile. | |
| website | No | URL the account set as its website, in the profile field of that name rather than in the bio. Absent when it set none. Independent of the ordered profile links. | |
| pronouns | No | Free-form pronouns the account set, e.g. "they/he". Absent when it set none. Account-authored text bounded only by length, not a fixed vocabulary — read it as written rather than parsing it. | |
| createdAt | No | ISO 8601 timestamp of account creation. | |
| indexedAt | No | ISO 8601 timestamp when the AppView last indexed this profile. | |
| associated | No | Selected associated profile metadata. Only supplied fields appear; an empty object is distinct from absent. | |
| postsCount | No | Total posts authored by this actor. | |
| description | No | Biography / about text. | |
| displayName | No | Display name set by the user. May differ from the handle. | |
| followsCount | No | Number of accounts this actor follows. | |
| verification | No | Bluesky verification state — what tells a verified account from a look-alike handle. Absent when Bluesky sent none, which it does for an account neither verified nor a trusted verifier. | |
| pinnedPostUri | No | AT-URI of the pinned post, if any. Pass to bsky_get_post_thread to read it. | |
| followersCount | No | Number of accounts following this actor. |