@cyanheads/bluesky-mcp-server 0.1.1

package/README.md

@@ -0,0 +1,307 @@
+<div align="center">
+  <h1>@cyanheads/bluesky-mcp-server</h1>
+  <p><b>Search posts, profiles, feeds, threads, and trending topics on Bluesky via MCP. STDIO or Streamable HTTP.</b>
+  <div>7 Tools • 1 Resource</div>
+  </p>
+</div>
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/Version-0.1.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/bluesky-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/bluesky-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/bluesky-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.11-blueviolet.svg?style=flat-square)](https://bun.sh/)
+
+</div>
+
+<div align="center">
+
+[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/bluesky-mcp-server/releases/latest/download/bluesky-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=bluesky-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvYmx1ZXNreS1tY3Atc2VydmVyIl19) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22bluesky-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fbluesky-mcp-server%22%5D%7D)
+
+[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
+
+</div>
+
+---
+
+## Tools
+
+Seven tools for read-only access to the public Bluesky/AT Protocol AppView — no authentication required:
+
+| Tool | Description |
+|:-----|:------------|
+| `bsky_search_posts` | Full-text search across public Bluesky posts, with author, language, tag, domain, date, and sort filters |
+| `bsky_get_profile` | Fetch a Bluesky actor's public profile by handle or DID — the handle↔DID resolver |
+| `bsky_get_author_feed` | A user's recent posts ordered newest-first, filterable by post type |
+| `bsky_get_post_thread` | Fetch the full conversation for a post by AT-URI — parent chain upward and reply tree downward |
+| `bsky_search_actors` | Find Bluesky accounts by name or handle fragment |
+| `bsky_get_follows` | Paginated social graph edges — who a user follows or who follows them |
+| `bsky_get_trending` | Real-time trending topics on Bluesky with post count, category, and status |
+
+### `bsky_search_posts`
+
+Full-text search across public Bluesky posts.
+
+- Filters: author handle, language (BCP-47), hashtag, domain, date range (`since`/`until`), and sort order (`top` or `latest`)
+- Returns posts with text, author, engagement counts (likes/reposts/replies/quotes), embeds, AT-URIs, and timestamps
+- `hitsTotal` when available — total matching posts, not just the current page
+- Pagination via opaque cursor; up to 100 results per call
+- Embeds normalized into a flat union: `images`, `external` (link cards), `record` (quoted posts), `video`, `unknown`
+- Moderation labels surfaced as-is — not filtered
+
+---
+
+### `bsky_get_profile`
+
+Fetch a Bluesky actor's public profile by handle or DID.
+
+- Returns displayName, handle, DID, description, follower/following/post counts, avatar URL, moderation labels, and pinned post AT-URI
+- The resolution step for handle↔DID — use before tools that require a DID or AT-URI when you only have a handle
+
+---
+
+### `bsky_get_author_feed`
+
+A user's recent posts ordered newest-first.
+
+- Filter by post type: `posts_with_replies`, `posts_no_replies`, `posts_with_media`, or `posts_and_author_threads`
+- Returns posts with full text, engagement counts, embeds, and AT-URIs for thread drilling
+- Pagination via cursor
+
+---
+
+### `bsky_get_post_thread`
+
+Fetch the full conversation for a post by AT-URI.
+
+- Returns the root post, parent chain (upward), and nested reply tree (downward)
+- Configurable `depth` (reply tree depth, default 6) and `parent_height` (parent chain height, default 80)
+- Truncated subtrees surface `truncated: true`; deleted posts surface as `not_found`
+- AT-URIs come from `bsky_search_posts` or `bsky_get_author_feed`
+
+---
+
+### `bsky_get_follows`
+
+Fetch social graph edges for an account.
+
+- `direction`: `followers` (who follows the actor) or `following` (who the actor follows)
+- Returns paginated profiles with handle, DID, displayName, description, and follower count
+- Includes the subject's profile summary at the top level
+
+---
+
+### `bsky_get_trending`
+
+Fetch real-time trending topics on Bluesky.
+
+- Returns topics with display name, post count, category (politics, sports, pop-culture, etc.), status (hot/rising), and start time
+- No cursor — returns the current snapshot up to `limit`
+- Uses `app.bsky.unspecced.getTrends` — Bluesky may change this endpoint without notice
+
+## Resource
+
+| Type | Name | Description |
+|:-----|:-----|:------------|
+| Resource | `bsky://profile/{actor}` | A Bluesky actor's public profile, addressable by handle or DID |
+
+All resource data is also reachable via tools. Use `bsky_get_profile` for programmatic access or `bsky://profile/{actor}` to inject profile context directly.
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core):
+
+- Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
+- Unified error handling — handlers throw, framework catches, classifies, and formats
+- Pluggable auth: `none`, `jwt`, `oauth`
+- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
+- Structured logging with optional OpenTelemetry tracing
+- STDIO and Streamable HTTP transports
+
+Bluesky-specific:
+
+- No authentication required — all seven tools operate against `api.bsky.app` without credentials
+- Single `BlueskyService` wrapping the AT Protocol public AppView with retry (3 attempts, 500ms base), 15s timeout, and a versioned `User-Agent`
+- Embed normalization — raw nested AT Protocol embed objects flattened to a clean `type`-discriminated union
+- Moderation labels surfaced verbatim — the agent and its human decide what to do
+- AT Protocol identifier types (handle, DID, AT-URI) explained at first encounter in every tool description
+
+Agent-friendly output:
+
+- AT-URIs on every post and resource — chain `bsky_search_posts` → `bsky_get_post_thread` without extra steps
+- Discriminated embed union (`type: "images" | "external" | "record" | "video" | "unknown"`) — branch on data, not `$type` strings
+- `hitsTotal` on search results — communicate result scale to users without extra round trips
+- Truncation signals (`truncated: true`) on thread nodes — agents know where the tree ends and why
+
+## Getting started
+
+Add the following to your MCP client configuration file. No API key required.
+
+```json
+{
+  "mcpServers": {
+    "bluesky-mcp-server": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": ["@cyanheads/bluesky-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+Or with npx (no Bun required):
+
+```json
+{
+  "mcpServers": {
+    "bluesky-mcp-server": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@cyanheads/bluesky-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
+Or with Docker:
+
+```json
+{
+  "mcpServers": {
+    "bluesky-mcp-server": {
+      "type": "stdio",
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "-e", "MCP_TRANSPORT_TYPE=stdio",
+        "ghcr.io/cyanheads/bluesky-mcp-server:latest"
+      ]
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
+### Prerequisites
+
+- [Bun v1.3.0](https://bun.sh/) or higher (or Node.js v24+).
+- No API key or account required — all tools call `api.bsky.app` without credentials.
+
+### Installation
+
+1. **Clone the repository:**
+
+```sh
+git clone https://github.com/cyanheads/bluesky-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+
+```sh
+cd bluesky-mcp-server
+```
+
+3. **Install dependencies:**
+
+```sh
+bun install
+```
+
+4. **Configure environment (optional):**
+
+```sh
+cp .env.example .env
+# edit .env to override any framework defaults
+```
+
+## Configuration
+
+This server requires no API keys. All framework configuration is optional.
+
+| Variable | Description | Default |
+|:---------|:------------|:--------|
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |
+| `MCP_HTTP_PORT` | Port for HTTP server | `3010` |
+| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth` | `none` |
+| `MCP_LOG_LEVEL` | Log level (RFC 5424) | `info` |
+| `LOGS_DIR` | Directory for log files (Node.js only) | `<project-root>/logs` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend | `in-memory` |
+| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) | `false` |
+
+See [`.env.example`](./.env.example) for the full list of optional overrides.
+
+## Running the server
+
+### Local development
+
+- **Build and run:**
+
+  ```sh
+  # One-time build
+  bun run rebuild
+
+  # Run the built server
+  bun run start:stdio
+  # or
+  bun run start:http
+  ```
+
+- **Run checks and tests:**
+
+  ```sh
+  bun run devcheck   # Lint, format, typecheck, security
+  bun run test       # Vitest test suite
+  bun run lint:mcp   # Validate MCP definitions against spec
+  ```
+
+### Docker
+
+```sh
+docker build -t bluesky-mcp-server .
+docker run --rm -p 3010:3010 bluesky-mcp-server
+```
+
+The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/bluesky-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.
+
+## Project structure
+
+| Directory | Purpose |
+|:----------|:--------|
+| `src/index.ts` | `createApp()` entry point — registers tools, resource, and inits service. |
+| `src/services/bluesky` | AT Protocol AppView HTTP client with retry, timeout, and `User-Agent`. |
+| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`) — seven read-only Bluesky tools. |
+| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`) — `bsky://profile/{actor}`. |
+| `tests/` | Unit and integration tests mirroring `src/`. |
+
+## Development guide
+
+See [`CLAUDE.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage
+- Register new tools and resources via the arrays in `src/index.ts`
+- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields
+
+## Contributing
+
+Issues and pull requests are welcome. Run checks and tests before submitting:
+
+```sh
+bun run devcheck
+bun run test
+```
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE) for details.

package/changelog/0.1.x/0.1.1.md

@@ -0,0 +1,24 @@
+---
+summary: "Initial public release — 7 tools and 1 resource over the Bluesky/AT Protocol public AppView API; input-length bounds on all free-text fields"
+breaking: false
+security: true
+---
+
+# 0.1.1 — 2026-06-05
+
+Initial public release of `@cyanheads/bluesky-mcp-server`. Provides read-only MCP access to the [Bluesky AT Protocol AppView API](https://docs.bsky.app/docs/category/http-reference) — no authentication required.
+
+## Added
+
+- **`bsky_search_posts`** — full-text post search with author, language, tag, domain, `since`/`until`, and sort filters; returns posts with text, engagement counts, embeds, AT-URIs, and timestamps
+- **`bsky_get_profile`** — actor profile lookup by handle or DID; returns displayName, handle, DID, description, follower/following/post counts, avatar URL, moderation labels, and pinned post AT-URI
+- **`bsky_get_author_feed`** — user's recent posts newest-first, filterable by `posts_with_replies`, `posts_no_replies`, `posts_with_media`, or `posts_and_author_threads`; returns posts with full text, engagement counts, embeds, and AT-URIs
+- **`bsky_get_post_thread`** — full conversation for a post by AT-URI; returns root post, parent chain (upward), and nested reply tree (downward); configurable `depth` and `parent_height`
+- **`bsky_search_actors`** — actor discovery by name or handle fragment; returns handle, DID, and display name
+- **`bsky_get_follows`** — paginated social graph edges; `direction` selects followers or following
+- **`bsky_get_trending`** — real-time trending topics with post count, category, and status
+- **`bsky://profile/{actor}`** resource — actor profile addressable by handle or DID via `bsky_profile`
+
+## Security
+
+- **Input-length bounds** added to all free-text Zod fields across tools and the resource — actor handles capped at `.max(253)` (max DNS label length), search queries at `.max(500)`, pagination cursors at `.max(2048)`, AT-URIs at `.max(2048)`, date strings at `.max(32)`, language codes at `.max(10)`, and hashtags at `.max(100)` — prevents unbounded string forwarding to the upstream API

package/changelog/template.md

@@ -0,0 +1,127 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+
+# Optional free-form notes for maintenance agents processing this release.
+# Not rendered in CHANGELOG — consumed by agents running `maintenance` on
+# downstream servers. Use for adoption instructions that don't fit the
+# human-facing sections: new files to create, fields to populate, one-time
+# migration steps. Omit the field entirely when there's nothing to say.
+# agent-notes: |
+#   <instructions for downstream maintenance agents>
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, CLAUDE.md/AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview bluesky-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview bluesky-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { bskyProfileResource } from './mcp-server/resources/definitions/bsky-profile.resource.js';
+import { bskyGetAuthorFeed } from './mcp-server/tools/definitions/bsky-get-author-feed.tool.js';
+import { bskyGetFollows } from './mcp-server/tools/definitions/bsky-get-follows.tool.js';
+import { bskyGetPostThread } from './mcp-server/tools/definitions/bsky-get-post-thread.tool.js';
+import { bskyGetProfile } from './mcp-server/tools/definitions/bsky-get-profile.tool.js';
+import { bskyGetTrending } from './mcp-server/tools/definitions/bsky-get-trending.tool.js';
+import { bskySearchActors } from './mcp-server/tools/definitions/bsky-search-actors.tool.js';
+import { bskySearchPosts } from './mcp-server/tools/definitions/bsky-search-posts.tool.js';
+import { initBlueskyService } from './services/bluesky/bluesky-service.js';
+await createApp({
+    tools: [
+        bskyGetProfile,
+        bskySearchActors,
+        bskyGetTrending,
+        bskyGetAuthorFeed,
+        bskySearchPosts,
+        bskyGetPostThread,
+        bskyGetFollows,
+    ],
+    resources: [bskyProfileResource],
+    prompts: [],
+    instructions: 'Bluesky MCP Server — read-only access to the public AT Protocol AppView.\n' +
+        'No authentication required. All tools call https://api.bsky.app without credentials.\n\n' +
+        'Key identifier types:\n' +
+        '- Handle: human-readable username, e.g. "alice.bsky.social"\n' +
+        '- DID: permanent identity key, e.g. "did:plc:z72i7hdynmk6r22z27h6tvur"\n' +
+        '- AT-URI: post address, e.g. "at://did:plc:.../app.bsky.feed.post/rkey"\n\n' +
+        'Typical workflows:\n' +
+        '1. bsky_search_posts — find recent posts on any topic\n' +
+        '2. bsky_get_post_thread — read a full conversation (AT-URI from search results)\n' +
+        '3. bsky_get_profile — resolve a handle or look up an account\n' +
+        '4. bsky_get_trending — discover what Bluesky is talking about right now',
+    setup(_core) {
+        initBlueskyService();
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,6DAA6D,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6DAA6D,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,cAAc;QACd,gBAAgB;QAChB,eAAe;QACf,iBAAiB;QACjB,eAAe;QACf,iBAAiB;QACjB,cAAc;KACf;IACD,SAAS,EAAE,CAAC,mBAAmB,CAAC;IAChC,OAAO,EAAE,EAAE;IACX,YAAY,EACV,4EAA4E;QAC5E,0FAA0F;QAC1F,yBAAyB;QACzB,+DAA+D;QAC/D,0EAA0E;QAC1E,6EAA6E;QAC7E,sBAAsB;QACtB,yDAAyD;QACzD,mFAAmF;QACnF,gEAAgE;QAChE,yEAAyE;IAC3E,KAAK,CAAC,KAAK;QACT,kBAAkB,EAAE,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/bsky-profile.resource.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Bluesky actor public profile resource, addressable by handle or DID.
+ * @module mcp-server/resources/definitions/bsky-profile
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const bskyProfileResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    actor: z.ZodString;
+}, z.core.$strip>, undefined, readonly [{
+    readonly reason: "actor_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The handle does not resolve or the profile does not exist.";
+    readonly recovery: "Verify the handle spelling or use bsky_search_actors to find the correct handle.";
+}]>;
+//# sourceMappingURL=bsky-profile.resource.d.ts.map

package/dist/mcp-server/resources/definitions/bsky-profile.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-profile.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/bsky-profile.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,mBAAmB;;;;;;;GAuD9B,CAAC"}

package/dist/mcp-server/resources/definitions/bsky-profile.resource.js

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Bluesky actor public profile resource, addressable by handle or DID.
+ * @module mcp-server/resources/definitions/bsky-profile
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getBlueskyService } from '../../../services/bluesky/bluesky-service.js';
+export const bskyProfileResource = resource('bsky://profile/{actor}', {
+    name: 'bsky-profile',
+    description: "A Bluesky actor's public profile, addressable by handle or DID. Returns the same data as " +
+        'bsky_get_profile in injectable-context form — displayName, handle, DID, bio, follower/following/post ' +
+        'counts, avatar, moderation labels, and pinned post AT-URI.',
+    mimeType: 'application/json',
+    params: z.object({
+        actor: z
+            .string()
+            .max(253)
+            .describe('Handle (e.g. "alice.bsky.social") or DID (e.g. "did:plc:z72i7hdynmk6r22z27h6tvur") of the actor.'),
+    }),
+    errors: [
+        {
+            reason: 'actor_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The handle does not resolve or the profile does not exist.',
+            recovery: 'Verify the handle spelling or use bsky_search_actors to find the correct handle.',
+        },
+    ],
+    async handler(params, ctx) {
+        ctx.log.debug('Fetching Bluesky profile resource', { actor: params.actor });
+        try {
+            return await getBlueskyService().getProfile(params.actor, ctx);
+        }
+        catch (err) {
+            if (err instanceof McpError) {
+                const body = err.data?.responseBody ?? '';
+                if (err.data &&
+                    (body.includes('not found') || body.includes('Not Found') || body.includes('NotFound'))) {
+                    throw ctx.fail('actor_not_found', `Actor not found: "${params.actor}"`, ctx.recoveryFor('actor_not_found'));
+                }
+            }
+            throw err;
+        }
+    },
+    list: async () => ({
+        resources: [
+            {
+                uri: 'bsky://profile/bsky.app',
+                name: 'Bluesky official profile (bsky.app)',
+                mimeType: 'application/json',
+            },
+        ],
+    }),
+});
+//# sourceMappingURL=bsky-profile.resource.js.map

package/dist/mcp-server/resources/definitions/bsky-profile.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-profile.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/bsky-profile.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,wBAAwB,EAAE;IACpE,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,2FAA2F;QAC3F,uGAAuG;QACvG,4DAA4D;IAC9D,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CACP,kGAAkG,CACnG;KACJ,CAAC;IACF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,iBAAiB;YACzB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,4DAA4D;YAClE,QAAQ,EAAE,kFAAkF;SAC7F;KACF;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC;YACH,OAAO,MAAM,iBAAiB,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAI,GAAG,CAAC,IAA8C,EAAE,YAAY,IAAI,EAAE,CAAC;gBACrF,IACE,GAAG,CAAC,IAAI;oBACR,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EACvF,CAAC;oBACD,MAAM,GAAG,CAAC,IAAI,CACZ,iBAAiB,EACjB,qBAAqB,MAAM,CAAC,KAAK,GAAG,EACpC,GAAG,CAAC,WAAW,CAAC,iBAAiB,CAAC,CACnC,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,yBAAyB;gBAC9B,IAAI,EAAE,qCAAqC;gBAC3C,QAAQ,EAAE,kBAAkB;aAC7B;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-get-author-feed.tool.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Get a Bluesky user's recent posts ordered newest-first.
+ * @module mcp-server/tools/definitions/bsky-get-author-feed
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const bskyGetAuthorFeed: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    actor: z.ZodString;
+    filter: z.ZodDefault<z.ZodEnum<{
+        posts_with_replies: "posts_with_replies";
+        posts_no_replies: "posts_no_replies";
+        posts_with_media: "posts_with_media";
+        posts_and_author_threads: "posts_and_author_threads";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    posts: z.ZodArray<z.ZodObject<{
+        uri: z.ZodString;
+        cid: z.ZodString;
+        text: z.ZodString;
+        author: z.ZodObject<{
+            did: z.ZodString;
+            handle: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            avatar: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        replyCount: z.ZodOptional<z.ZodNumber>;
+        repostCount: z.ZodOptional<z.ZodNumber>;
+        likeCount: z.ZodOptional<z.ZodNumber>;
+        quoteCount: z.ZodOptional<z.ZodNumber>;
+        indexedAt: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+        }, z.core.$strip>>>;
+        embed: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        replyToUri: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "actor_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The actor handle or DID does not resolve to an existing account.";
+    readonly recovery: "Verify the handle or DID, or use bsky_search_actors to find the correct actor.";
+}], {
+    readonly totalReturned: z.ZodNumber;
+}>;
+//# sourceMappingURL=bsky-get-author-feed.tool.d.ts.map

package/dist/mcp-server/tools/definitions/bsky-get-author-feed.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-author-feed.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-author-feed.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAiE3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4J5B,CAAC"}