AT Protocol MCP Server

Appearance

Profile Resource ​

MCP resource that exposes the authenticated user's profile information and statistics.

Resource URI ​

atproto://profile

Authentication ​

Required: Yes

This resource requires authentication to access the user's profile data.

Resource Information ​

  • Name: User Profile
  • Description: Current user's profile information and statistics
  • MIME Type: application/json

Data Structure ​

typescript
{
  uri: string;              // Resource URI
  timestamp: string;        // ISO 8601 timestamp when data was fetched
  profile: {
    did: string;            // User's DID
    handle: string;         // User's handle
    displayName?: string;   // Display name
    description?: string;   // Bio/description
    avatar?: string;        // Avatar image URL
    banner?: string;        // Banner image URL
    followersCount: number; // Number of followers
    followsCount: number;   // Number of users followed
    postsCount: number;     // Number of posts
    indexedAt?: string;     // When profile was indexed
    createdAt?: string;     // Account creation date
    labels?: Array<{        // Moderation labels
      src: string;
      uri: string;
      cid: string;
      val: string;
      cts: string;
    }>;
  };
  session: {
    did: string;            // Session DID
    handle: string;         // Session handle
    active: boolean;        // Session active status
  };
}

Example Response ​

json
{
  "uri": "atproto://profile",
  "timestamp": "2026-01-15T10:30:00.000Z",
  "profile": {
    "did": "did:plc:abc123xyz789",
    "handle": "alice.bsky.social",
    "displayName": "Alice Smith",
    "description": "Software engineer and coffee enthusiast ☕\nBuilding cool things with AT Protocol",
    "avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:abc123xyz789/...",
    "banner": "https://cdn.bsky.app/img/banner/plain/did:plc:abc123xyz789/...",
    "followersCount": 1234,
    "followsCount": 567,
    "postsCount": 890,
    "indexedAt": "2026-01-15T10:29:00.000Z",
    "createdAt": "2025-06-15T08:00:00.000Z",
    "labels": []
  },
  "session": {
    "did": "did:plc:abc123xyz789",
    "handle": "alice.bsky.social",
    "active": true
  }
}

Usage in MCP ​

Accessing the Resource ​

javascript
// Request the profile resource
const resource = await mcpClient.readResource('atproto://profile');
const profileData = JSON.parse(resource.text);

console.log(`User: ${profileData.profile.displayName}`);
console.log(`Followers: ${profileData.profile.followersCount}`);
console.log(`Posts: ${profileData.profile.postsCount}`);

Monitoring Profile Changes ​

Each read returns a fresh snapshot. The interval below is a client-side suggestion — the server does not poll or push profile updates.

javascript
// Re-read the profile periodically (client-side choice, not server behavior)
let lastProfileUpdate = null;

setInterval(async () => {
  const resource = await mcpClient.readResource('atproto://profile');
  const profile = JSON.parse(resource.text);

  if (profile.timestamp !== lastProfileUpdate) {
    console.log('Profile re-read');
    await handleProfileUpdate(profile);
    lastProfileUpdate = profile.timestamp;
  }
}, 60000); // Check every minute

Use Cases ​

  • Display the authenticated user's own profile and statistics
  • Track follower growth and posting activity over time
  • Verify the active session and confirm the logged-in user

Best Practices ​

These are suggestions for client applications; none are enforced by this server.

  • Treat each read as a point-in-time snapshot; statistics may be slightly stale
  • Re-read after the user edits their profile to reflect changes
  • Parse the JSON defensively and handle missing optional fields

Profile Fields ​

Required Fields ​

  • did - Permanent user identifier
  • handle - User's handle (can change)
  • followersCount - Number of followers
  • followsCount - Number of follows
  • postsCount - Number of posts

Optional Fields ​

  • displayName - User's display name
  • description - Bio text (supports line breaks)
  • avatar - Avatar image URL
  • banner - Banner image URL
  • indexedAt - Last index timestamp
  • createdAt - Account creation date
  • labels - Moderation labels

Session Information ​

Session Fields ​

  • did - Session DID (matches profile DID)
  • handle - Session handle (matches profile handle)
  • active - Whether session is active

Session Status ​

  • active: true - Valid authenticated session
  • active: false - Session expired or invalid

Limitations ​

  • Data is a snapshot at fetch time; statistics may be slightly stale and profile edits may take time to reflect
  • This resource only exposes the authenticated user's own profile — use the get_user_profile tool for other users
  • Calls share the per-tool rate limit (100 requests per minute per tool), so avoid re-reading more often than you need

See Also ​