@cyanheads/bluesky-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/bsky-get-post-thread.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-post-thread.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-post-thread.tool.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Fetch a Bluesky actor's public profile by handle or DID.
+ * @module mcp-server/tools/definitions/bsky-get-profile
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const bskyGetProfile: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    actor: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    did: z.ZodString;
+    handle: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodString>;
+    followersCount: z.ZodOptional<z.ZodNumber>;
+    followsCount: z.ZodOptional<z.ZodNumber>;
+    postsCount: z.ZodOptional<z.ZodNumber>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        val: z.ZodString;
+        src: z.ZodOptional<z.ZodString>;
+        cts: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    indexedAt: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    pinnedPostUri: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, 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.";
+}], undefined>;
+//# sourceMappingURL=bsky-get-profile.tool.d.ts.map

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

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

package/dist/mcp-server/tools/definitions/bsky-get-profile.tool.js

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Fetch a Bluesky actor's public profile by handle or DID.
+ * @module mcp-server/tools/definitions/bsky-get-profile
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getBlueskyService } from '../../../services/bluesky/bluesky-service.js';
+const LabelSchema = z
+    .object({
+    val: z
+        .string()
+        .describe('Label value (content warning or moderation tag, e.g. "porn", "spam").'),
+    src: z.string().optional().describe('DID of the labeler that applied this label.'),
+    cts: z.string().optional().describe('ISO 8601 timestamp when the label was applied.'),
+})
+    .describe('A moderation label applied by the AppView or a labeler service.');
+export const bskyGetProfile = tool('bsky_get_profile', {
+    title: 'Get Bluesky Profile',
+    description: 'Fetch a Bluesky actor\'s public profile by handle (e.g. "bsky.app") or DID ' +
+        '(e.g. "did:plc:z72i7hdynmk6r22z27h6tvur"). Returns displayName, handle, DID, bio, ' +
+        'follower/following/post counts, avatar URL, moderation labels, and pinned post AT-URI. ' +
+        'Use this as the first step to resolve a handle to a DID before calling tools that require ' +
+        'a DID or AT-URI. Handles and DIDs are interchangeable as input.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        actor: z
+            .string()
+            .max(253)
+            .describe('Handle (e.g. "bsky.app", "alice.bsky.social") or DID (e.g. "did:plc:z72i7hdynmk6r22z27h6tvur") of the actor to look up.'),
+    }),
+    output: z.object({
+        did: z
+            .string()
+            .describe('Decentralized Identifier — the permanent, portable identity key for this account.'),
+        handle: z.string().describe('Human-readable username, e.g. "alice.bsky.social".'),
+        displayName: z
+            .string()
+            .optional()
+            .describe('Display name set by the user. May differ from the handle.'),
+        description: z.string().optional().describe('Biography / about text.'),
+        avatar: z.string().optional().describe('URL of the profile avatar image.'),
+        followersCount: z.number().optional().describe('Number of accounts following this actor.'),
+        followsCount: z.number().optional().describe('Number of accounts this actor follows.'),
+        postsCount: z.number().optional().describe('Total posts authored by this actor.'),
+        labels: z.array(LabelSchema).optional().describe('Moderation labels applied to this profile.'),
+        indexedAt: z
+            .string()
+            .optional()
+            .describe('ISO 8601 timestamp when the AppView last indexed this profile.'),
+        createdAt: z.string().optional().describe('ISO 8601 timestamp of account creation.'),
+        pinnedPostUri: z
+            .string()
+            .optional()
+            .describe('AT-URI of the pinned post, if any. Pass to bsky_get_post_thread to read it.'),
+    }),
+    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(input, ctx) {
+        ctx.log.info('Fetching Bluesky profile', { actor: input.actor });
+        try {
+            return await getBlueskyService().getProfile(input.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: "${input.actor}"`, ctx.recoveryFor('actor_not_found'));
+                }
+            }
+            throw err;
+        }
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`## ${result.displayName ?? result.handle}`);
+        lines.push(`**Handle:** @${result.handle} | **DID:** \`${result.did}\``);
+        if (result.description)
+            lines.push(`\n${result.description}`);
+        const counts = [];
+        if (result.followersCount != null)
+            counts.push(`${result.followersCount.toLocaleString()} followers`);
+        if (result.followsCount != null)
+            counts.push(`following ${result.followsCount.toLocaleString()}`);
+        if (result.postsCount != null)
+            counts.push(`${result.postsCount.toLocaleString()} posts`);
+        if (counts.length)
+            lines.push(`\n${counts.join(' · ')}`);
+        if (result.avatar)
+            lines.push(`\n**Avatar:** ${result.avatar}`);
+        if (result.pinnedPostUri)
+            lines.push(`**Pinned post AT-URI:** \`${result.pinnedPostUri}\``);
+        if (result.labels?.length) {
+            const labelParts = result.labels.map((l) => {
+                const parts = [l.val];
+                if (l.src)
+                    parts.push(`src:${l.src}`);
+                if (l.cts)
+                    parts.push(`cts:${l.cts}`);
+                return parts.join(' ');
+            });
+            lines.push(`**Labels:** ${labelParts.join(', ')}`);
+        }
+        if (result.createdAt)
+            lines.push(`**Joined:** ${result.createdAt}`);
+        if (result.indexedAt)
+            lines.push(`**Indexed:** ${result.indexedAt}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=bsky-get-profile.tool.js.map

package/dist/mcp-server/tools/definitions/bsky-get-profile.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-profile.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-profile.tool.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Fetch real-time trending topics on Bluesky.
+ * @module mcp-server/tools/definitions/bsky-get-trending
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const bskyGetTrending: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    trends: z.ZodArray<z.ZodObject<{
+        topic: z.ZodString;
+        displayName: z.ZodString;
+        link: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        postCount: z.ZodOptional<z.ZodNumber>;
+        status: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined, {
+    readonly totalReturned: z.ZodNumber;
+}>;
+//# sourceMappingURL=bsky-get-trending.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-trending.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-trending.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAyBjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;EAmD1B,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-get-trending.tool.js

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Fetch real-time trending topics on Bluesky.
+ * @module mcp-server/tools/definitions/bsky-get-trending
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getBlueskyService } from '../../../services/bluesky/bluesky-service.js';
+const TrendSchema = z
+    .object({
+    topic: z
+        .string()
+        .describe('Opaque topic slug, e.g. "ailaunch2025". Use as a search term in bsky_search_posts.'),
+    displayName: z.string().describe('Human-readable topic name, e.g. "AI Launch 2025".'),
+    link: z.string().optional().describe('URL associated with this trending topic, if provided.'),
+    startedAt: z
+        .string()
+        .optional()
+        .describe('ISO 8601 timestamp when this topic started trending.'),
+    postCount: z.number().optional().describe('Approximate number of posts about this topic.'),
+    status: z.string().optional().describe('Velocity signal, e.g. "hot" or "rising".'),
+    category: z
+        .string()
+        .optional()
+        .describe('Category of the trend, e.g. "politics", "sports", "pop-culture".'),
+})
+    .describe('A single real-time trending topic on Bluesky.');
+export const bskyGetTrending = tool('bsky_get_trending', {
+    title: 'Get Bluesky Trending Topics',
+    description: 'Fetch the current 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. ' +
+        'Entry point for "what is Bluesky talking about right now". Pair with bsky_search_posts to drill ' +
+        'into any trending topic. Note: uses the app.bsky.unspecced.getTrends endpoint, which is not part ' +
+        "of Bluesky's stable lexicon and may change without notice.",
+    annotations: { readOnlyHint: true, idempotentHint: false, openWorldHint: true },
+    input: z.object({
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(25)
+            .default(10)
+            .describe('Maximum number of trending topics to return (1–25). Default 10.'),
+    }),
+    output: z.object({
+        trends: z.array(TrendSchema).describe('Current trending topics, ordered by prominence.'),
+    }),
+    enrichment: {
+        totalReturned: z.number().describe('Number of trending topics returned.'),
+    },
+    async handler(input, ctx) {
+        ctx.log.info('Fetching Bluesky trending topics', { limit: input.limit });
+        const result = await getBlueskyService().getTrends({ limit: input.limit }, ctx);
+        ctx.enrich({ totalReturned: result.trends.length });
+        return { trends: result.trends };
+    },
+    format: (result) => {
+        if (result.trends.length === 0) {
+            return [{ type: 'text', text: 'No trending topics available at this time.' }];
+        }
+        const lines = result.trends.map((t, i) => {
+            const parts = [`${i + 1}. **${t.displayName}**`];
+            const meta = [];
+            if (t.postCount != null)
+                meta.push(`${t.postCount.toLocaleString()} posts`);
+            if (t.category)
+                meta.push(t.category);
+            if (t.status)
+                meta.push(t.status);
+            if (meta.length)
+                parts.push(`   ${meta.join(' · ')}`);
+            if (t.startedAt)
+                parts.push(`   Started: ${t.startedAt}`);
+            if (t.topic !== t.displayName)
+                parts.push(`   Topic: \`${t.topic}\``);
+            if (t.link)
+                parts.push(`   Link: ${t.link}`);
+            return parts.join('\n');
+        });
+        return [{ type: 'text', text: lines.join('\n\n') }];
+    },
+});
+//# sourceMappingURL=bsky-get-trending.tool.js.map

package/dist/mcp-server/tools/definitions/bsky-get-trending.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-get-trending.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-get-trending.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,oFAAoF,CACrF;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACrF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IAC7F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC1F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAClF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,mBAAmB,EAAE;IACvD,KAAK,EAAE,6BAA6B;IACpC,WAAW,EACT,4FAA4F;QAC5F,mGAAmG;QACnG,kGAAkG;QAClG,mGAAmG;QACnG,4DAA4D;IAC9D,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;IAC/E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,iEAAiE,CAAC;KAC/E,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;KACzF,CAAC;IAEF,UAAU,EAAE;QACV,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAC1E;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,iBAAiB,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;QAChF,GAAG,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4CAA4C,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;YACjD,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;YAC5E,IAAI,CAAC,CAAC,QAAQ;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,CAAC,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,CAAC,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YACtE,IAAI,CAAC,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-search-actors.tool.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Search Bluesky accounts by name or handle fragment.
+ * @module mcp-server/tools/definitions/bsky-search-actors
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const bskySearchActors: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    actors: z.ZodArray<z.ZodObject<{
+        did: z.ZodString;
+        handle: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodString>;
+        followersCount: z.ZodOptional<z.ZodNumber>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            val: z.ZodString;
+            src: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, undefined, {
+    readonly totalReturned: z.ZodNumber;
+}>;
+//# sourceMappingURL=bsky-search-actors.tool.d.ts.map

package/dist/mcp-server/tools/definitions/bsky-search-actors.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-search-actors.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-search-actors.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAyBjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;EA+E3B,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-search-actors.tool.js

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Search Bluesky accounts by name or handle fragment.
+ * @module mcp-server/tools/definitions/bsky-search-actors
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getBlueskyService } from '../../../services/bluesky/bluesky-service.js';
+const ActorResultSchema = z
+    .object({
+    did: z.string().describe('Decentralized Identifier — permanent portable identity key.'),
+    handle: z.string().describe('Human-readable username, e.g. "alice.bsky.social".'),
+    displayName: z.string().optional().describe('Display name set by the user.'),
+    description: z.string().optional().describe('Biography / about text.'),
+    avatar: z.string().optional().describe('URL of the profile avatar image.'),
+    followersCount: z.number().optional().describe('Number of followers.'),
+    labels: z
+        .array(z
+        .object({
+        val: z.string().describe('Label value (content warning or moderation tag).'),
+        src: z.string().optional().describe('DID of the labeling service.'),
+    })
+        .describe('A moderation label applied to this actor.'))
+        .optional()
+        .describe('Moderation labels applied to this actor.'),
+})
+    .describe('A Bluesky actor profile summary.');
+export const bskySearchActors = tool('bsky_search_actors', {
+    title: 'Search Bluesky Actors',
+    description: 'Find Bluesky accounts by name or handle fragment. Returns ranked profiles with handle, ' +
+        'DID, displayName, bio, and follower count. Use before bsky_get_profile or bsky_get_author_feed ' +
+        'when you have a name but not a confirmed handle. Supports cursor-based pagination for browsing ' +
+        'beyond the first page of results.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        query: z
+            .string()
+            .max(500)
+            .describe('Name or handle fragment to search for, e.g. "alice" or "nytimes.com".'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(25)
+            .describe('Maximum number of actors to return (1–100). Default 25.'),
+        cursor: z
+            .string()
+            .max(2048)
+            .optional()
+            .describe('Opaque pagination cursor from a previous response. Omit for the first page.'),
+    }),
+    output: z.object({
+        actors: z.array(ActorResultSchema).describe('Matching actor profiles, ranked by relevance.'),
+        cursor: z
+            .string()
+            .optional()
+            .describe('Opaque cursor for the next page. Absent on the last page.'),
+    }),
+    enrichment: {
+        totalReturned: z.number().describe('Number of actors in this response page.'),
+    },
+    async handler(input, ctx) {
+        ctx.log.info('Searching Bluesky actors', { query: input.query, limit: input.limit });
+        const result = await getBlueskyService().searchActors({ q: input.query, limit: input.limit, ...(input.cursor ? { cursor: input.cursor } : {}) }, ctx);
+        ctx.enrich({ totalReturned: result.actors.length });
+        if (result.actors.length === 0) {
+            ctx.enrich.notice(`No actors matched "${input.query}". Try a different name or handle fragment.`);
+        }
+        return { actors: result.actors, ...(result.cursor ? { cursor: result.cursor } : {}) };
+    },
+    format: (result) => {
+        if (result.actors.length === 0) {
+            return [{ type: 'text', text: 'No matching actors found.' }];
+        }
+        const lines = result.actors.map((a) => {
+            const parts = [`## @${a.handle}`];
+            parts.push(`**DID:** \`${a.did}\``);
+            if (a.displayName)
+                parts.push(`**Name:** ${a.displayName}`);
+            if (a.description)
+                parts.push(a.description);
+            if (a.followersCount != null)
+                parts.push(`**Followers:** ${a.followersCount.toLocaleString()}`);
+            if (a.labels?.length) {
+                const labelParts = a.labels.map((l) => (l.src ? `${l.val} (src:${l.src})` : l.val));
+                parts.push(`**Labels:** ${labelParts.join(', ')}`);
+            }
+            if (a.avatar)
+                parts.push(`**Avatar:** ${a.avatar}`);
+            return parts.join('\n');
+        });
+        const output = lines.join('\n\n');
+        return [
+            {
+                type: 'text',
+                text: result.cursor ? `${output}\n\n---\n*cursor: \`${result.cursor}\`*` : output,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=bsky-search-actors.tool.js.map

package/dist/mcp-server/tools/definitions/bsky-search-actors.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-search-actors.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-search-actors.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IACvF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC1E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACtE,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC;SACE,MAAM,CAAC;QACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC5E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KACpE,CAAC;SACD,QAAQ,CAAC,2CAA2C,CAAC,CACzD;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;CACxD,CAAC;KACD,QAAQ,CAAC,kCAAkC,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,oBAAoB,EAAE;IACzD,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,yFAAyF;QACzF,iGAAiG;QACjG,iGAAiG;QACjG,mCAAmC;IACrC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CAAC,uEAAuE,CAAC;QACpF,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,yDAAyD,CAAC;QACtE,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,IAAI,CAAC;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,6EAA6E,CAAC;KAC3F,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC5F,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,2DAA2D,CAAC;KACzE,CAAC;IAEF,UAAU,EAAE;QACV,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC9E;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,MAAM,iBAAiB,EAAE,CAAC,YAAY,CACnD,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EACzF,GAAG,CACJ,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,MAAM,CAAC,MAAM,CACf,sBAAsB,KAAK,CAAC,KAAK,6CAA6C,CAC/E,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACxF,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,CAAC,CAAC,cAAc,IAAI,IAAI;gBAC1B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,cAAc,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACrB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACpF,KAAK,CAAC,IAAI,CAAC,eAAe,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACpD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,uBAAuB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,MAAM;aAClF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/bsky-search-posts.tool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Full-text search across public Bluesky posts.
+ * @module mcp-server/tools/definitions/bsky-search-posts
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const bskySearchPosts: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    author_handle: z.ZodOptional<z.ZodString>;
+    language: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        top: "top";
+        latest: "latest";
+    }>>;
+    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>;
+    hitsTotal: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, undefined, {
+    readonly totalReturned: z.ZodNumber;
+}>;
+//# sourceMappingURL=bsky-search-posts.tool.d.ts.map

package/dist/mcp-server/tools/definitions/bsky-search-posts.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsky-search-posts.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/bsky-search-posts.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAiEjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkL1B,CAAC"}