Media
Data source: Bluesky (AT Protocol)
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/bluesky/
claude_desktop_config.json
{
"mcpServers": {
"gnist-bluesky": {
"url": "https://context.gnist.ai/mcp/bluesky/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/bluesky/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_posts", "arguments": {"query": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/bluesky/
6 endpoints available:
GET /rest/bluesky/search_postsGET /rest/bluesky/get_profileGET /rest/bluesky/get_author_feedGET /rest/bluesky/get_post_threadGET /rest/bluesky/search_actorsGET /rest/bluesky/report_feedback
Shell
curl "https://context.gnist.ai/rest/bluesky/search_posts?query=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/bluesky/search_posts",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"query": "example"
},
)
print(resp.json())
Command Line
Command
gc bluesky
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (6)
search_postsSearch Bluesky posts by keyword.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search query for Bluesky posts (e.g. "AI agents", "climate change"). |
limit | integer | optional | Max results to return (1-100). Default 10. (default: 10) |
sort | string | optional | Sort order: "latest" or "top". Default "latest". (default: "latest") |
get_profileGet a Bluesky user profile by handle or DID.
| Parameter | Type | Required | Description |
|---|---|---|---|
actor | string | required | Bluesky handle (e.g. "bsky.app") or DID (e.g. "did:plc:z72i7hdynmk6r22z27h6tvur"). |
get_author_feedGet recent posts from a Bluesky user.
| Parameter | Type | Required | Description |
|---|---|---|---|
actor | string | required | Bluesky handle (e.g. "bsky.app") or DID. |
limit | integer | optional | Max posts to return (1-100). Default 10. (default: 10) |
get_post_threadGet a post thread by AT URI, including replies.
| Parameter | Type | Required | Description |
|---|---|---|---|
uri | string | required | AT Protocol URI of the post (e.g. "at://did:plc:.../app.bsky.feed.post/abc123"). |
depth | integer | optional | Max reply depth to fetch (0-100). Default 6. (default: 6) |
search_actorsSearch Bluesky users by name or handle.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search query for Bluesky users (e.g. "bluesky", "journalist"). |
limit | integer | optional | Max results to return (1-100). Default 10. (default: 10) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |