Home · MCP servers · Bluesky

Bluesky MCP server

Posts on Bluesky. Add one address to your AI assistant and it can call the tool below itself, with your FoxAPIs key. It costs the same credits as the REST API, and an answer with no data is not charged.

Server address

https://foxapis.com/mcp/data/bluesky

Streamable HTTP, bearer key in the Authorization header. This address carries only the Bluesky tool; https://foxapis.com/mcp/data carries all of them, and ?source=bluesky,github picks several.

What you can ask

Five prompts to give your assistant once the server is added:

  1. How many likes and reposts did this Bluesky post get?
  2. Who wrote this Bluesky post and when?
  3. Summarize the text of this Bluesky post.
  4. Compare the engagement of two Bluesky posts I link.
  5. How many replies does this Bluesky post have?

The tool your assistant gets

ToolWhat it returnsInputsCredits a call
bluesky_postA Bluesky post: text, author, likes, reposts, replies, quotes and time, from its link.url (required)2

Credits come from the same file as the pricing page. Plans and top-ups are on pricing.

Set it up

Use your FoxAPIs key (it starts with fxp_) as the bearer token. Get one free at foxapis.com/trial.

Claude Code

Run in a terminal. Its docs.

claude mcp add --transport http foxapis-data https://foxapis.com/mcp/data/bluesky \
  --header "Authorization: Bearer YOUR_KEY"

The Claude Code docs show this form (--transport http, name, URL, --header) for a server that takes a bearer token.

Cursor

.cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project. Its docs.

{
  "mcpServers": {
    "foxapis-data": {
      "url": "https://foxapis.com/mcp/data/bluesky",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Cursor's remote-server example uses a url and a headers object.

VS Code (Copilot)

.mcp.json at the workspace root, or ~/.copilot/mcp-config.json. Its docs.

{
  "mcpServers": {
    "foxapis-data": {
      "type": "http",
      "url": "https://foxapis.com/mcp/data/bluesky",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      },
      "tools": [
        "*"
      ]
    }
  }
}

Do not store a real key in a file you share.

Cline

cline_mcp_settings.json (open it from Cline's MCP Servers panel). Its docs.

{
  "mcpServers": {
    "foxapis-data": {
      "type": "streamableHttp",
      "url": "https://foxapis.com/mcp/data/bluesky",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Cline's docs say that leaving type out selects the older SSE transport, so keep type.

Zed

settings.json (Zed: open settings). Its docs.

{
  "context_servers": {
    "foxapis-data": {
      "url": "https://foxapis.com/mcp/data/bluesky",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

n8n

an MCP Client Tool node in a workflow. Its docs.

Endpoint: https://foxapis.com/mcp/data/bluesky
Server transport: HTTP Streamable
Authentication: Header Auth
  Name: Authorization
  Value: Bearer YOUR_KEY

Not run by us: the fields are the ones n8n's MCP Client Tool documents. The server speaks Streamable HTTP.

Claude Desktop and ChatGPT

Not covered here: their custom-connector screens ask for sign-in (OAuth) or no authentication, and this server takes a bearer key in a header, so it works best in the clients above. We have not tested it in either.

A real answer

The bluesky_post tool called once through a real MCP client session on 20 November 2026 with the input {"url":"https://bsky.app/profile/bsky.app/post/3n2mkgfb4tk2d"}. Long text is cut and lists are cut to three items for display; it is not invented.

{
  "url": "https://bsky.app/profile/bsky.app/post/3n2mkgfb4tk2d",
  "platform": "bluesky",
  "extracted_at": "2026-11-20T11:13:51.821417+00:00",
  "text": "Read all about @germnetwork.com in @wired.com:",
  "title": "Read all about @germnetwork.com in @wired.com:",
  "author_name": "Bluesky",
  "author_handle": "bsky.app",
  "author_url": "https://bsky.app/profile/bsky.app",
  "author_avatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka",
  "published_at": "2026-11-18T21:57:26.111Z",
  "date_source": "bluesky_atproto_api",
  "likes": 494,
  "comments_count": 20,
  "shares": 1,
  "reposts": 33,
  "content_type": "post",
  "extras": {
    "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
    "at_uri": "at://bsky.app/app.bsky.feed.post/3n2mkgfb4tk2d",
    "cid": "bafyreif2sisjvqvshmnisis34mt6irs5ptxf3anfbg4qoruzjm6k6a5oim",
    "reply_count": 20,
    "quote_count": 1,
    "embed": {
      "$type": "app.bsky.embed.record",
      "record": "{...}"
    }
  },
  "credits_used": 2,
  "latency_ms": 92
}

Charged: 2 credits.

Try it free

Runs the bluesky_post call with the sample input below. No key and no sign-up; a few runs a day per visitor.

{
  "url": "https://bsky.app/profile/bsky.app/post/3n2mkgfb4tk2d"
}

Other data-source MCP servers

Mastodon · Twitch · SoundCloud · Last.fm · Podcasts · Academic papers · all of them

Free to start: 100 credits, no card. Then from $10. Credits you buy never expire.

Get my free key

The same data over REST: Bluesky post. More: all MCP servers · people and company tools