Bluesky AT Protocol API

Open decentralized social network API based on the AT Protocol (ATP), enabling posting, reading feeds, managing follows, and building custom feed algorithms on the Bluesky platform.

Evaluated Mar 07, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Social Media bluesky atproto at-protocol decentralized social-media open-protocol python typescript
⚙ Agent Friendliness
64
/ 100
Can an agent use this?
🔒 Security
76
/ 100
Is it safe for agents?
⚡ Reliability
67
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
62
Documentation
72
Error Messages
70
Auth Simplicity
78
Rate Limits
72

🔒 Security

TLS Enforcement
100
Auth Strength
72
Scope Granularity
60
Dep. Hygiene
75
Secret Handling
72

TLS enforced. App passwords provide credential isolation — compromise of an app password doesn't expose the main account password. DPoP-bound OAuth 2.0 tokens (in rollout) provide strong token binding. The open protocol means anyone can read public data without auth, which is by design but requires agents to avoid leaking private data by assuming all posts are public by default.

⚡ Reliability

Uptime/SLA
65
Version Stability
68
Breaking Changes
65
Error Recovery
70
AF Security Reliability

Best When

An agent needs to post content, monitor conversations, or build social tools without approval processes, partnership requirements, or per-post fees — especially for developer-focused or tech-savvy audiences.

Avoid When

Your audience is primarily on Twitter/X and hasn't migrated, or you need the reach scale that only incumbent platforms offer.

Use Cases

  • Automated posting of announcements, updates, or content from agent workflows without per-message fees
  • Building custom feed generators that curate content based on algorithmic criteria
  • Reading public posts and timelines for social listening and sentiment analysis
  • Running a personal bot account that participates in open protocol conversations
  • Labeling and content moderation workflows using the Labeler service protocol

Not For

  • Commercial social listening at enterprise scale — user base smaller than Twitter/LinkedIn
  • B2B professional network use cases — Bluesky is primarily consumer social
  • Guaranteed uptime SLAs — platform is still maturing; infrastructure reliability is improving but not enterprise-grade
  • Mass marketing automation — community norms reject spam; accounts can be blocked at the instance level

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
Yes
Webhooks
No

Authentication

Methods: app_password oauth2
OAuth: Yes Scopes: No

App passwords (username + dedicated app password) are the simplest auth path for agents — no browser flow required. OAuth 2.0 (DPoP-based) is being rolled out for third-party apps. App passwords can be created with reduced scope (e.g., no DMs) and revoked independently of the main account password. This is far more agent-friendly than Twitter or LinkedIn's mandatory browser-redirect OAuth flows.

Pricing

Model: free
Free tier: Yes
Requires CC: No

Bluesky charges nothing for API access. The open protocol means you can also self-host a PDS for full data sovereignty. No approval process, no partnership requirements, no developer account tiers. This is the most accessible social API for developers and agents.

Agent Metadata

Pagination
cursor
Idempotent
No
Retry Guidance
Not documented

Known Gotchas

  • AT Protocol uses DIDs (Decentralized Identifiers) and ATURIs throughout — agents must resolve handle-to-DID before most record operations
  • App passwords do not support DM scoping until OAuth 2.0 is fully deployed — store app passwords as secrets, not in code
  • Feed generator building requires running an external HTTP service that Bluesky's appview queries — it's not a simple API call
  • Lexicon versioning: record types are versioned (e.g., app.bsky.feed.post) — agents embedding records must use correct schema versions
  • Firehose (com.atproto.sync.subscribeRepos) is a WebSocket stream, not REST — requires persistent connection handling
  • bsky.social is one PDS instance; users on other PDS instances are federated but API routing may differ
  • Community bots are common and norms around bot behavior are still forming — clearly marking bot accounts is expected

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for Bluesky AT Protocol API.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-07.

6470
Packages Evaluated
26150
Need Evaluation
173
Need Re-evaluation
Community Powered