@chirpie/mcp 0.1.0

package/dist/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ChirpieClient, ChirpieApiError, getConfig } from "@chirpie/sdk";
+import { z } from "zod";
+var config = getConfig();
+var client = config ? new ChirpieClient({ apiKey: config.api_key, baseUrl: config.base_url }) : null;
+function requireClient() {
+  if (!client) {
+    throw new Error(
+      "Not authenticated. Run `chirpie login` or set CHIRPIE_API_KEY environment variable."
+    );
+  }
+  return client;
+}
+function formatResult(data) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+  };
+}
+function formatError(err) {
+  const message = err instanceof ChirpieApiError ? `${err.code}: ${err.message}` : err instanceof Error ? err.message : "Unknown error";
+  return {
+    content: [{ type: "text", text: message }],
+    isError: true
+  };
+}
+var server = new McpServer({
+  name: "chirpie",
+  version: "0.1.0"
+});
+server.tool(
+  "chirpie_post",
+  "Create a post on X/Twitter. Posts immediately or at a scheduled time.",
+  {
+    account_id: z.string().describe("X account ID to post from"),
+    text: z.string().max(280).describe("Post text (max 280 chars)"),
+    schedule_at: z.string().optional().describe("ISO 8601 datetime to schedule the post")
+  },
+  async ({ account_id, text, schedule_at }) => {
+    try {
+      const result = await requireClient().createPost({ account_id, text, schedule_at });
+      return formatResult(result);
+    } catch (err) {
+      return formatError(err);
+    }
+  }
+);
+server.tool(
+  "chirpie_thread",
+  "Create a thread (multiple posts) on X/Twitter.",
+  {
+    account_id: z.string().describe("X account ID to post from"),
+    posts: z.array(z.object({
+      text: z.string().max(280).describe("Post text")
+    })).min(2).max(25).describe("Array of posts in the thread"),
+    schedule_at: z.string().optional().describe("ISO 8601 datetime to schedule")
+  },
+  async ({ account_id, posts, schedule_at }) => {
+    try {
+      const result = await requireClient().createThread({ account_id, posts, schedule_at });
+      return formatResult(result);
+    } catch (err) {
+      return formatError(err);
+    }
+  }
+);
+server.tool(
+  "chirpie_list_posts",
+  "List recent posts. Filter by status or account.",
+  {
+    status: z.string().optional().describe("Filter: draft, scheduled, published, failed"),
+    account_id: z.string().optional().describe("Filter by account ID"),
+    limit: z.number().optional().describe("Max results (default 20)")
+  },
+  async ({ status, account_id, limit }) => {
+    try {
+      const result = await requireClient().listPosts({ status, account_id, limit });
+      return formatResult(result);
+    } catch (err) {
+      return formatError(err);
+    }
+  }
+);
+server.tool(
+  "chirpie_get_post",
+  "Get a single post by ID.",
+  {
+    id: z.string().describe("Post ID")
+  },
+  async ({ id }) => {
+    try {
+      const result = await requireClient().getPost(id);
+      return formatResult(result);
+    } catch (err) {
+      return formatError(err);
+    }
+  }
+);
+server.tool(
+  "chirpie_delete_post",
+  "Delete a post. Also deletes from X if published.",
+  {
+    id: z.string().describe("Post ID to delete")
+  },
+  async ({ id }) => {
+    try {
+      const result = await requireClient().deletePost(id);
+      return formatResult(result);
+    } catch (err) {
+      return formatError(err);
+    }
+  }
+);
+server.tool(
+  "chirpie_list_accounts",
+  "List connected X/Twitter accounts.",
+  {},
+  async () => {
+    try {
+      const result = await requireClient().listAccounts();
+      return formatResult(result);
+    } catch (err) {
+      return formatError(err);
+    }
+  }
+);
+server.tool(
+  "chirpie_analytics",
+  "Get analytics (impressions, likes, retweets, etc.) for a published post.",
+  {
+    post_id: z.string().describe("Post ID to get analytics for")
+  },
+  async ({ post_id }) => {
+    try {
+      const result = await requireClient().getPostAnalytics(post_id);
+      return formatResult(result);
+    } catch (err) {
+      return formatError(err);
+    }
+  }
+);
+var transport = new StdioServerTransport();
+server.connect(transport).catch((err) => {
+  console.error("Failed to start Chirpie MCP server:", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@chirpie/mcp",
+  "version": "0.1.0",
+  "description": "Chirpie MCP server — social media tools for AI agents",
+  "repository": { "type": "git", "url": "https://github.com/Firefloco/chirpie", "directory": "packages/mcp" },
+  "homepage": "https://chirpie.ai/docs/mcp",
+  "publishConfig": { "access": "public" },
+  "type": "module",
+  "bin": {
+    "chirpie-mcp": "./dist/index.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": ["chirpie", "mcp", "ai", "social-media", "claude"],
+  "license": "MIT",
+  "dependencies": {
+    "@chirpie/sdk": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "tsup": "^8",
+    "typescript": "^5"
+  }
+}