Start free

Platforms MCP server

MCP server · 5 tools · 3 endpoints

Bluesky MCP server

Profiles, an account's posts and keyword search across public Bluesky, one credit a call, for Claude and Cursor.

Get a free key Connect in a minute

100 credits on signup · No card · Sign in with OAuth or paste a key

scrapersocial-bluesky mcp.scrapersocial.com/blueskyconnected
you

Who is <handle.bsky.social>? Give me the bio and follower count.

agent
calls get_profile 1 credit / profile
{ "handle": "<handle>" }
server
returns
followers number subscribers number bio string
Shape only. Keys follow the tool's summary; a real call returns the full record. 1 call · 1 credit

Connect

One URL. Your client already knows what to do with it.

The first call opens a sign-in. New accounts get 100 credits, no card. Every client below shares one account and one balance.

Get a free key
server url https://mcp.scrapersocial.com/bluesky
claude.aiOAuth

Settings → Connectors → Add custom connector, then paste the server URL.

mcp.scrapersocial.com/bluesky

Web, desktop and mobile. Nothing else to paste.

Claude Codeone command

Run this in a terminal.

$ claude mcp add --transport http scrapersocial-bluesky https://mcp.scrapersocial.com/bluesky

Approve the sign-in prompt on first use.

Cursorone click

Installs the server and opens the MCP panel.

Add to Cursor
or paste the JSON into .cursor/mcp.json
{ "mcpServers": { "scrapersocial-bluesky": { "url": "https://mcp.scrapersocial.com/bluesky", "headers": { "Authorization": "Bearer sk_live_..." } } } }
Other clients · VS Code, Windsurf, Gemini CLI, anything that speaks MCP
VS Codeone click or JSON
Add to VS Codeor run MCP: Add Server, choose HTTP and use:
{ "name": "scrapersocial-bluesky", "type": "http", "url": "https://mcp.scrapersocial.com/bluesky" }
Windsurf~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "scrapersocial-bluesky": { "serverUrl": "https://mcp.scrapersocial.com/bluesky", "headers": { "Authorization": "Bearer sk_live_..." } } } }
Gemini CLI~/.gemini/settings.json
{ "mcpServers": { "scrapersocial-bluesky": { "httpUrl": "https://mcp.scrapersocial.com/bluesky", "headers": { "Authorization": "Bearer sk_live_..." } } } }
Any clientStreamable HTTP · OAuth 2.1 or Bearer
$ npx add-mcp https://mcp.scrapersocial.com/bluesky

One account and one balance across every client and the every-platform hub at mcp.scrapersocial.com.

What it does

What your agent can do with Bluesky

Every Bluesky call here costs 1 credit. The whole catalog is three endpoints, a profile, an account’s posts and keyword search, and the 100 credits you get free at signup will fetch a hundred posts or a hundred profiles before you’ve paid anything.

Give get_profile a handle and you get the public record back: follower count, bio and totals. get_channel_posts lists what that account has posted lately, metrics included, one credit per post and up to 50 in a page. search runs a keyword query across public posts at one credit per result. That’s the full tool list apart from list_endpoints, which is free, and call_endpoint, which on Bluesky reaches the same three paths and exists so an agent can call by path if it prefers.

Bluesky publishes its own open protocol, and if you need to write, follow, or drink from the firehose that’s the right place to go. This server is for the simpler case: an agent inside Claude or Cursor that wants to know what an account said this week, or who’s talking about a topic, without you standing up a client, keeping a session alive or watching a rate limit. One key, one credit, JSON back. It also makes Bluesky cheap to include in a cross-network watch alongside X and Threads, where the same three questions cost more.

Four jobs it finishes on its own

01

Daily digest of a few accounts

get_channel_posts for each handle, keep what's new, summarise. Ten accounts at twenty posts each is 200 credits a day at most, and far less once you only fetch what's changed.

02

Topic monitoring on an open network

search for a product, a person or a phrase. One credit per result means an agent can afford to check several queries an hour and only tell you when something moves.

03

Verify a handle

People migrate to Bluesky under new names. get_profile confirms the handle exists and shows the bio and follower count, so your agent can tell the real account from a parody.

04

Add Bluesky to a cross-platform report

Same three questions you'd ask of X or Threads, same JSON shape, at the lowest price on the service. Easy to include without blowing the budget.

Limits · read before you connect

What this does not do

Written by a person, not generated. If something here is wrong, tell us.

Public Bluesky only; blocked or deleted accounts resolve to not found, which is free. Three endpoints means no post stats tool, no comments or reply threads, no transcripts, no media download. Posts and search results are capped at 50 per call, billed one credit per item returned, and an empty result still costs the 1-credit minimum. These are point-in-time reads, not a stream: for real-time ingestion at volume, connect to the protocol directly. The server doesn’t post, like, follow or send messages on your behalf.

Tools

5 tools, same names as the every-platform hub

Three do one Bluesky thing each. The last two reach all 3 endpoints by path, so nothing in the catalog is out of an agent's reach.

Full credit table →

Get an account profile

get_profile

Profile, page or channel record for a public account: follower and subscriber counts, bio, and totals.

1 credit / profile

List an account's posts

get_channel_posts

Recent public posts or videos from one account, with per-item metrics.

1 credit / post

Search a platform

search

Keyword search over one platform's public content.

1 credit / post
Reaches every endpoint by path

List every Bluesky endpoint

list_endpoints

Browse every Bluesky endpoint, its input and its credit cost. Free, and calls nothing upstream.

free

Call any Bluesky endpoint by path

call_endpoint

Run any Bluesky endpoint by its path, so nothing Bluesky offers is out of reach of an agent.

endpoint's own cost

Pricing

100 free credits is 100 profile reads.

Then $5 a month for 1,000 credits, or $4 per 1,000 as a top-up. No card to start. Every call costs 1 credit.

100 profile readsget_profile · 1 each
Get a free key 100 credits on signup · $5 for 1,000 · full credit table

Prompts

Things to ask once it is connected

Copy one, swap the placeholder, paste it into your client.

Show me everything <handle.bsky.social> has posted since Monday.

Who is <handle.bsky.social>? Give me the bio and follower count.

Search Bluesky for "<topic>" and list the 20 most recent posts with their like counts.

Compare the posting frequency of <handle-1> and <handle-2> on Bluesky.

Is anyone on Bluesky talking about <product name> today?

Questions

Before you connect

Do I need a Bluesky account? #

No. The server reads public data and authenticates against your ScraperSocial key, not against Bluesky.

Why would I use this instead of the AT Protocol directly? #

Convenience. The protocol is open and free, and the better choice for writes or the firehose. This gives an agent the three common reads as tool calls with no client to run.

Is this an official Bluesky product? #

No. ScraperSocial has no connection to Bluesky Social PBC; it's independent and reads only what the network makes public.

What does a profile lookup cost? #

One credit. Posts and search results are also one credit each, so a 50-post page is 50 credits.

Can it read a blocked or private account? #

Only what's public. An account a logged-out viewer can't see gives not found, costing nothing.