Bluesky data API
14 endpoints for Bluesky: profile, profile posts, post, post comments, search, trending, trending topics, followers, follows, profile lists, list, starter pack, feed generator, profile feeds. One API key, one JSON schema, as MCP tools or REST.
Endpoints
Call any of them over MCP with call_endpoint and its path, or over REST.
| Endpoint | Returns | Credits | Cache |
|---|---|---|---|
| profileGET /v1/bluesky/profile | A Bluesky account by handle: display name, bio, avatar, join date, and follower, following and post counts. | 1 | 15 min |
| profile/postsGET /v1/bluesky/profile/posts | The latest posts, replies and reposts in a Bluesky account's feed, newest first, with like, reply and repost counts. | 1 | 10 min |
| postGET /v1/bluesky/post | One Bluesky post by URL, with its engagement counts. | 1 | 10 min |
| post/commentsGET /v1/bluesky/post/comments | Comments on one Bluesky post, replies included. | 1 | 5 min |
| searchGET /v1/bluesky/search | Bluesky posts matching a keyword. | 1 | 2 min |
| trendingGET /v1/bluesky/trending | Posts from a popular Bluesky discovery feed. | 1 | 30 min |
| trending/topicsGET /v1/bluesky/trending/topics | Named news and culture topics trending on Bluesky, each with the feed that collects it. | 1 | 30 min |
| followersGET /v1/bluesky/followers | Follower list for a Bluesky account. | 5 | 30 min |
| followsGET /v1/bluesky/follows | Accounts a Bluesky profile follows, in follow order. | 5 | 30 min |
| profile/listsGET /v1/bluesky/profile/lists | Curated and moderation lists a Bluesky account owns, with item counts. | 5 | 15 min |
| listGET /v1/bluesky/list | One Bluesky list and its member accounts, with the list purpose and total size. | 5 | 15 min |
| starter-packGET /v1/bluesky/starter-pack | One Bluesky starter pack: creator, join counts, backing list and a sample of its members. | 1 | 15 min |
| feed-generatorGET /v1/bluesky/feed-generator | One custom Bluesky feed: its publisher, description, likes, and whether the ranking service still serves it. | 1 | 15 min |
| profile/feedsGET /v1/bluesky/profile/feeds | Custom feeds a Bluesky account published, with subscriber likes and the ranking service behind each. | 5 | 15 min |
Connect your agent over MCP
Remote MCP server: https://data.openkrill.app/mcp with your key in the x-api-key header.
claude mcp add --transport http krilldata \
https://data.openkrill.app/mcp \
--header "x-api-key: YOUR_API_KEY"{
"mcpServers": {
"krilldata": {
"url": "https://data.openkrill.app/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}{
"mcpServers": {
"krilldata": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://data.openkrill.app/mcp",
"--header",
"x-api-key:${API_KEY}"
],
"env": {
"API_KEY": "YOUR_API_KEY"
}
}
}
}