AT Protocol Interaction Engine (bluesky-mcp)

This Model Context Protocol (MCP) backend furnishes capabilities for automated interaction across the Bluesky platform utilizing the underlying AT Protocol specification.

Deployment Guidance

Automated Installation via Smithery

To seamlessly deploy atproto-interface-service for use with Claude Desktop via Smithery:

bash npx -y @smithery/cli install @semioz/bluesky-mcp --client claude

Manual Configuration

Modify the configuration file for your local Claude Desktop instance located at ~/Library/Application Support/Claude/claude_desktop_config.json by inserting the following definition:

{ "mcpServers": { "atproto-interface-service": { "command": "npx", "args": ["-y", "@semihberkay/bluesky-mcp"], "env": { "BLUESKY_IDENTIFIER": "your.handle.bsky.social", "BLUESKY_PASSWORD": "your-app-password" } } } }

Essential Environment Variables

Access credentials must be supplied via these environment variables: - BLUESKY_IDENTIFIER: Your Bluesky unique handle or registered email address. - BLUESKY_PASSWORD: Your Bluesky-generated application access key.

Exposed MCP Functionality

Credential Management

typescript tool: "login" params: { identifier?: string, // Bluesky handle/email (Optional if configured in environment) password?: string // App-specific password (Optional if configured in environment) }

Upon initialization, the service attempts automated authentication using established environment variables. Invoking the login function is necessary only under scenarios where environment variables are absent, when overriding existing credentials, or if the preliminary automated logon attempt fails.

Content Publication & Retrieval

typescript // Artifact creation tool: "create-post" params: { text: string, // Primary textual payload for the publication images?: { // Optional collection of visual media attachments data: string, // Image data encoded in Base64 format encoding: string // The corresponding MIME media type (e.g., image/png) }[] }

// Single artifact fetch tool: "get-post" params: { uri: string // The unique Resource Identifier (URI) of the target artifact }

// Batch artifact fetch tool: "get-posts" params: { uris: string[] // A collection of artifact URIs designated for retrieval }

// Artifact removal tool: "delete-post" params: { uri: string // The URI designating the artifact slated for deletion }

Social Interactions

typescript // Endorse (Like) an artifact tool: "like-post" params: { uri: string, // URI of the artifact being endorsed cid: string // Content Identifier (CID) associated with the artifact's state }

// Revoke an endorsement tool: "unlike-post" params: { likeUri: string // The specific URI pointing to the existing endorsement record }

// Syndicate (Repost) an artifact tool: "repost" params: { uri: string, // URI of the source artifact for syndication cid: string // CID of the artifact state being syndicated }

// Cancel syndication tool: "unrepost" params: { repostUri: string // URI reference to the syndication record to be nullified }

Profile Data & Feed Aggregation

typescript // Retrieve authenticated user's profile metadata tool: "get-profile" params: {}

// Fetch aggregated content stream tool: "get-timeline" params: { limit?: number // Maximum cardinality of artifacts to retrieve (capped at 100) }

Auxiliary Formatting Routines

Timeline Rendering

typescript prompt: "format-timeline" params: { timeline: any // Raw data structure representing the fetched chronological stream }

This routine transforms the raw timeline data into a presentation optimized for human consumption, detailing: - Author identity (display name and handle) - The artifact's textual content - Interaction statistics (reply count, repost count, endorsement count) - Temporal markers - Inlined media references (hyperlinks, video pointers) - Attribution details for syndicated content

Distinctive Capabilities

• ✅ Complete AT Protocol credential validation support.
• ✅ Capacity to generate pure textual publications.
• ✅ Native handling and inclusion of image assets.
• ✅ Retrieval of individual user identity manifests.
• ✅ Functionality for accessing personalized content streams.
• ✅ Mechanisms for applying and removing endorsements (likes).
• ✅ Mechanisms for syndicating and retracting syndication (reposts).
• ✅ Automated processing of rich text elements, including URL and mention resolution.
• ✅ Full compliance with the Model Context Protocol (MCP) specification for integration with Claude environments.

WIKIPEDIA: Business management tools encompass all frameworks, computational solutions, prescriptive methods, and applied systems utilized by organizations to successfully navigate evolving market conditions, secure a sustainable competitive footing, and enhance overall organizational efficiency.

== Conceptual Framework == Tools are departmentalized based on functional areas, enabling classification across key management dimensions such as strategic planning, operational control, record-keeping, personnel administration, decision support, and performance oversight. A generalized functional taxonomy includes:

Instruments for initial data acquisition and integrity verification across all divisions. Systems dedicated to the monitoring and refinement of core operational workflows. Platforms facilitating data aggregation and evidence-based executive decision-making. The rapid technological evolution of the past decade has dramatically altered the landscape of business tooling, creating complexity in selecting optimal solutions. This difficulty stems from persistent pressures to reduce operational expenditure, increase revenue realization, deeply understand consumer requirements, and deliver products precisely matching specified demand. Consequently, managerial focus should shift toward adopting a strategic, adaptive posture regarding business tools, selecting and tailoring them precisely to organizational imperatives rather than defaulting to the newest available technology, which often results in systemic instability.

== Dominant Instruments (2013 Benchmark) == A 2013 analysis by Bain & Company documented global usage patterns for business instruments, reflecting regional requirements shaped by prevailing economic climates. The top ten identified instruments included:

Strategic planning methodologies Customer relationship management suites Personnel sentiment assessment Comparative performance analysis (Benchmarking) Balanced scorecard systems Core competency identification Strategic outsourcing management Organizational change protocols Supply chain orchestration Foundational statement definition (Mission/Vision) Market segment definition Total Quality Management frameworks

== Enterprise Software Applications == Software designed for corporate users to execute various operational tasks is termed business software or an application. These applications are engineered to maximize productivity, quantitatively measure output, and perform necessary functions with high accuracy. The progression moved from initial Management Information Systems (MIS) to expansive Enterprise Resource Planning (ERP) systems, subsequently incorporating Customer Relationship Management (CRM), culminating in the current trend toward cloud-native business management solutions. While organizational performance correlates with IT investment, two factors critically amplify value realization: the efficacy of the implementation process and the judicious selection and customization of the chosen tools.

== Focused Solutions for Small and Medium Enterprises (SMEs) == Tools specifically engineered for SMEs are crucial as they offer vital pathways for resource optimization...