Bluesky MCP server

Short answer

ScrapeIO runs a hosted MCP server that gives Claude, Cursor, Codex and other AI agents 3 read-only Bluesky tools, such as bluesky_profile, bluesky_user_posts, bluesky_post. Add https://scrapeio.com/mcp with your API key; there is nothing to install or run. Calls cost the same credits as the API and new accounts get 100 free credits.

Server URL	`https://scrapeio.com/mcp`
Transport	Streamable HTTP, hosted. Nothing to install.
Auth	`x-api-key` header or Bearer token
Bluesky tools	3 (3 listed directly)
Access	Read-only public data
Price	Same credits as the API. 100 free on signup.

Tools

Tool	What it returns	Credits
`bluesky_profile`	Bluesky profile: bio, avatar, followers, following, post count.	1
`bluesky_user_posts`	A profile's posts, newest first, with likes, replies and reposts.	1
`bluesky_post`	One Bluesky post with its stats and direct replies.	1

Set it up

Get a key at scrapeio.com/login and put it in your shell profile as export SCRAPEIO_API_KEY=sk_.... Then add the server to your agent:

Claude Code

Run once in a terminal. Or install the plugin, which adds the skill too: /plugin marketplace add xhoantran/scrapeio-agent, then /plugin install scrapeio@scrapeio.

claude mcp add --transport http scrapeio https://scrapeio.com/mcp \
  --header "x-api-key: $SCRAPEIO_API_KEY"

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).

{
  "mcpServers": {
    "scrapeio": {
      "url": "https://scrapeio.com/mcp",
      "headers": { "x-api-key": "${env:SCRAPEIO_API_KEY}" }
    }
  }
}

Codex

Add to ~/.codex/config.toml. Codex sends the key as a Bearer token, which the server accepts.

[mcp_servers.scrapeio]
url = "https://scrapeio.com/mcp"
bearer_token_env_var = "SCRAPEIO_API_KEY"

Gemini CLI, VS Code, Windsurf, Hermes and other clients are on the agents page. All 33 platforms come with the same server, so one setup covers Bluesky and the rest.

Prompts to try

Look up a Bluesky account or page I name and summarize it: audience size, how often it posts, and its three best recent posts with numbers.
Get the last 30 posts from an account I name on Bluesky and tell me which formats and topics get the most engagement.

The agent picks the tools, pages through results when it needs more, and reports the numbers it got back. Each answer uses the same field names on every platform, so a prompt that mixes Bluesky with TikTok or YouTube works the same way.

Why a hosted MCP server

No scraping inside the agent. Browsing Bluesky from an agent runs into login walls and changing pages. A tool call returns clean JSON in seconds.
One schema. handle, followers, plays, likes and created_at mean the same thing on every platform, so the model does not have to translate.
Pay per call. No monthly plan for an agent that runs now and then. Failed and cached calls are free.

Questions

Is the Bluesky MCP server free?

Connecting is free and new accounts get 100 free credits. After that you buy credit packs ($47 for 25,000 or $497 for 500,000). Credits never expire, and failed or cached calls cost nothing.

Do I need a Bluesky account or developer key?

No. The server returns public Bluesky data with your ScrapeIO key only. There is no Bluesky app to register and no OAuth.

Can the agent post, like or send messages?

No. Every tool is read-only and marked readOnlyHint, so clients can run them without a write warning.

Which clients work?

Any client that speaks Streamable HTTP: Claude Code, Cursor, Codex, Gemini CLI, VS Code agent mode, Windsurf, Hermes and others. It is also in the official MCP registry as com.scrapeio/scrapeio.

Prefer code? The same data is on the Bluesky API page.

100 free credits, no card. Credits never expire.

Get API key