ihateposting-mcp 0.2.0

package/README.md

@@ -0,0 +1,62 @@
+# ihateposting-mcp
+
+MCP server for [iHatePosting](https://ihateposting.com) — draft, schedule, and inspect
+social posts from Claude, Cursor, ChatGPT, or any MCP client.
+
+Write once, publish everywhere: iHatePosting cross-posts to Bluesky, X, LinkedIn,
+Facebook, Instagram, Threads, Mastodon, Telegram, Discord, Tumblr, Pinterest,
+YouTube and more.
+
+## Get an API key
+
+iHatePosting → **Settings → API & MCP** → create a key (`pk_live_…`).
+Treat it like a password: it can post on your behalf.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `create_post` | Create a post — publish now, schedule, or save as a draft |
+| `list_posts` | The 50 most recent posts with per-platform status + live URLs |
+| `list_accounts` | Your connected social accounts and their health |
+
+## Use it
+
+### Claude Desktop / Claude Code / Cursor (local, stdio)
+
+```json
+{
+  "mcpServers": {
+    "ihateposting": {
+      "command": "npx",
+      "args": ["-y", "ihateposting-mcp"],
+      "env": { "IHATEPOSTING_API_KEY": "pk_live_…" }
+    }
+  }
+}
+```
+
+### ChatGPT and other remote clients (hosted, HTTP)
+
+ChatGPT can't run a local process, so point it at the hosted endpoint instead:
+
+```
+https://ihateposting.com/api/mcp
+```
+
+Authenticate with a header: `Authorization: Bearer pk_live_…`
+
+## Environment
+
+| Variable | Default | Notes |
+|---|---|---|
+| `IHATEPOSTING_API_KEY` | — | Required (stdio). Your `pk_live_…` key. |
+| `IHATEPOSTING_API_URL` | `https://ihateposting.com` | Override for self-hosted/staging. |
+
+## Notes
+
+- Instagram, Pinterest and YouTube require media, which these tools can't attach —
+  save a draft and finish it in the composer.
+- Every call is scoped to the key's owner; the server holds no state of its own.
+
+MIT © iHatePosting

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { makeApiCaller, registerTools, MCP_NAME, MCP_VERSION } from "./tools.js";
+/**
+ * iHatePosting MCP server — STDIO transport (plan §6.1 item 74, Pro).
+ * For clients that spawn a local process: Claude Desktop, Claude Code, Cursor.
+ * ChatGPT cannot use this (it only accepts a remote URL) — point ChatGPT at
+ * the hosted HTTP endpoint instead: https://ihateposting.com/api/mcp
+ *
+ * Config (env):
+ *   IHATEPOSTING_API_KEY  pk_live_… from iHatePosting → Settings → API & MCP (required)
+ *   IHATEPOSTING_API_URL  defaults to https://ihateposting.com
+ *
+ * Claude Desktop / Claude Code config:
+ *   { "mcpServers": { "ihateposting": {
+ *       "command": "npx", "args": ["-y", "ihateposting-mcp"],
+ *       "env": { "IHATEPOSTING_API_KEY": "pk_live_…" } } } }
+ */
+const API_URL = process.env.IHATEPOSTING_API_URL ?? "https://ihateposting.com";
+const API_KEY = process.env.IHATEPOSTING_API_KEY;
+const server = new McpServer({ name: MCP_NAME, version: MCP_VERSION });
+registerTools(server, makeApiCaller(API_URL, API_KEY));
+await server.connect(new StdioServerTransport());

package/dist/tools.d.ts

@@ -0,0 +1,21 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * The iHatePosting MCP tool set, shared by BOTH transports:
+ *   - stdio  (packages/mcp/src/index.ts) → npx ihateposting-mcp, for
+ *     Claude Desktop / Claude Code / Cursor, which spawn a local process.
+ *   - HTTP   (apps/web/src/app/api/mcp/route.ts) → https://ihateposting.com/api/mcp,
+ *     for ChatGPT and any other client that can only reach a remote URL.
+ *
+ * Both transports call the same public REST API with the caller's API key, so
+ * the tools stay identical and there is exactly one place to add a new one.
+ */
+export declare const MCP_NAME = "ihateposting";
+export declare const MCP_VERSION = "0.2.0";
+/** Platforms the text-only create_post tool can target. */
+export declare const MCP_PLATFORMS: readonly ["bluesky", "x", "linkedin", "facebook", "threads", "mastodon", "telegram", "discord", "tumblr"];
+/** Calls the iHatePosting REST API with the caller's key. Never throws — every
+ *  failure is returned as JSON text so the model can explain it to the user. */
+export type ApiCaller = (path: string, init?: RequestInit) => Promise<string>;
+export declare function makeApiCaller(apiUrl: string, apiKey: string | undefined): ApiCaller;
+/** Registers every iHatePosting tool on a server instance. */
+export declare function registerTools(server: McpServer, api: ApiCaller): void;

package/dist/tools.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+/**
+ * The iHatePosting MCP tool set, shared by BOTH transports:
+ *   - stdio  (packages/mcp/src/index.ts) → npx ihateposting-mcp, for
+ *     Claude Desktop / Claude Code / Cursor, which spawn a local process.
+ *   - HTTP   (apps/web/src/app/api/mcp/route.ts) → https://ihateposting.com/api/mcp,
+ *     for ChatGPT and any other client that can only reach a remote URL.
+ *
+ * Both transports call the same public REST API with the caller's API key, so
+ * the tools stay identical and there is exactly one place to add a new one.
+ */
+export const MCP_NAME = "ihateposting";
+export const MCP_VERSION = "0.2.0";
+/** Platforms the text-only create_post tool can target. */
+export const MCP_PLATFORMS = [
+    "bluesky",
+    "x",
+    "linkedin",
+    "facebook",
+    "threads",
+    "mastodon",
+    "telegram",
+    "discord",
+    "tumblr",
+];
+export function makeApiCaller(apiUrl, apiKey) {
+    const base = apiUrl.replace(/\/$/, "");
+    return async (path, init) => {
+        if (!apiKey) {
+            return JSON.stringify({
+                error: "No API key — set IHATEPOSTING_API_KEY (stdio) or send Authorization: Bearer <key> (HTTP). Create one in iHatePosting → Settings → API & MCP.",
+            });
+        }
+        try {
+            const res = await fetch(`${base}${path}`, {
+                ...init,
+                headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json", ...init?.headers },
+            });
+            const text = await res.text();
+            if (!res.ok)
+                return JSON.stringify({ error: `iHatePosting API ${res.status}`, detail: text.slice(0, 500) });
+            return text;
+        }
+        catch (err) {
+            return JSON.stringify({ error: `Couldn't reach iHatePosting: ${err instanceof Error ? err.message : String(err)}` });
+        }
+    };
+}
+/** Registers every iHatePosting tool on a server instance. */
+export function registerTools(server, api) {
+    server.tool("create_post", "Create a social post on iHatePosting. action 'now' publishes immediately to every connected account of the named platforms; 'schedule' needs scheduledDate (YYYY-MM-DD) + scheduledTime (e.g. '9:00 AM', in the account owner's timezone); 'draft' just saves it. Note: Instagram/Pinterest/YouTube need media, which this tool can't attach — save a draft for those and finish in the composer.", {
+        text: z.string().min(1).describe("The post text"),
+        platforms: z.array(z.enum(MCP_PLATFORMS)).min(1).describe("Platforms to post to"),
+        action: z.enum(["now", "schedule", "draft"]).default("draft"),
+        scheduledDate: z.string().optional().describe("YYYY-MM-DD (schedule only)"),
+        scheduledTime: z.string().optional().describe("e.g. '9:00 AM' (schedule only)"),
+    }, async (input) => ({
+        content: [{ type: "text", text: await api("/api/v1/posts", { method: "POST", body: JSON.stringify(input) }) }],
+    }));
+    server.tool("list_posts", "List the 50 most recent iHatePosting posts with per-platform status (draft/scheduled/published/failed) and live URLs.", {}, async () => ({ content: [{ type: "text", text: await api("/api/v1/posts") }] }));
+    server.tool("list_accounts", "List the connected social accounts (platform, handle, health) available for posting.", {}, async () => ({ content: [{ type: "text", text: await api("/api/v1/accounts") }] }));
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "ihateposting-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for iHatePosting — draft, schedule, and inspect social posts from Claude, Cursor, or any MCP client.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://ihateposting.com",
+  "keywords": ["mcp", "modelcontextprotocol", "social-media", "scheduler", "ihateposting"],
+  "bin": {
+    "ihateposting-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./tools": "./src/tools.ts"
+  },
+  "files": ["dist", "src", "README.md"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "tsx": "^4.0.0",
+    "typescript": "^6.0.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { makeApiCaller, registerTools, MCP_NAME, MCP_VERSION } from "./tools.js";
+
+/**
+ * iHatePosting MCP server — STDIO transport (plan §6.1 item 74, Pro).
+ * For clients that spawn a local process: Claude Desktop, Claude Code, Cursor.
+ * ChatGPT cannot use this (it only accepts a remote URL) — point ChatGPT at
+ * the hosted HTTP endpoint instead: https://ihateposting.com/api/mcp
+ *
+ * Config (env):
+ *   IHATEPOSTING_API_KEY  pk_live_… from iHatePosting → Settings → API & MCP (required)
+ *   IHATEPOSTING_API_URL  defaults to https://ihateposting.com
+ *
+ * Claude Desktop / Claude Code config:
+ *   { "mcpServers": { "ihateposting": {
+ *       "command": "npx", "args": ["-y", "ihateposting-mcp"],
+ *       "env": { "IHATEPOSTING_API_KEY": "pk_live_…" } } } }
+ */
+
+const API_URL = process.env.IHATEPOSTING_API_URL ?? "https://ihateposting.com";
+const API_KEY = process.env.IHATEPOSTING_API_KEY;
+
+const server = new McpServer({ name: MCP_NAME, version: MCP_VERSION });
+registerTools(server, makeApiCaller(API_URL, API_KEY));
+
+await server.connect(new StdioServerTransport());

package/src/tools.ts

@@ -0,0 +1,87 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+/**
+ * The iHatePosting MCP tool set, shared by BOTH transports:
+ *   - stdio  (packages/mcp/src/index.ts) → npx ihateposting-mcp, for
+ *     Claude Desktop / Claude Code / Cursor, which spawn a local process.
+ *   - HTTP   (apps/web/src/app/api/mcp/route.ts) → https://ihateposting.com/api/mcp,
+ *     for ChatGPT and any other client that can only reach a remote URL.
+ *
+ * Both transports call the same public REST API with the caller's API key, so
+ * the tools stay identical and there is exactly one place to add a new one.
+ */
+
+export const MCP_NAME = "ihateposting";
+export const MCP_VERSION = "0.2.0";
+
+/** Platforms the text-only create_post tool can target. */
+export const MCP_PLATFORMS = [
+  "bluesky",
+  "x",
+  "linkedin",
+  "facebook",
+  "threads",
+  "mastodon",
+  "telegram",
+  "discord",
+  "tumblr",
+] as const;
+
+/** Calls the iHatePosting REST API with the caller's key. Never throws — every
+ *  failure is returned as JSON text so the model can explain it to the user. */
+export type ApiCaller = (path: string, init?: RequestInit) => Promise<string>;
+
+export function makeApiCaller(apiUrl: string, apiKey: string | undefined): ApiCaller {
+  const base = apiUrl.replace(/\/$/, "");
+  return async (path, init) => {
+    if (!apiKey) {
+      return JSON.stringify({
+        error: "No API key — set IHATEPOSTING_API_KEY (stdio) or send Authorization: Bearer <key> (HTTP). Create one in iHatePosting → Settings → API & MCP.",
+      });
+    }
+    try {
+      const res = await fetch(`${base}${path}`, {
+        ...init,
+        headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json", ...init?.headers },
+      });
+      const text = await res.text();
+      if (!res.ok) return JSON.stringify({ error: `iHatePosting API ${res.status}`, detail: text.slice(0, 500) });
+      return text;
+    } catch (err) {
+      return JSON.stringify({ error: `Couldn't reach iHatePosting: ${err instanceof Error ? err.message : String(err)}` });
+    }
+  };
+}
+
+/** Registers every iHatePosting tool on a server instance. */
+export function registerTools(server: McpServer, api: ApiCaller): void {
+  server.tool(
+    "create_post",
+    "Create a social post on iHatePosting. action 'now' publishes immediately to every connected account of the named platforms; 'schedule' needs scheduledDate (YYYY-MM-DD) + scheduledTime (e.g. '9:00 AM', in the account owner's timezone); 'draft' just saves it. Note: Instagram/Pinterest/YouTube need media, which this tool can't attach — save a draft for those and finish in the composer.",
+    {
+      text: z.string().min(1).describe("The post text"),
+      platforms: z.array(z.enum(MCP_PLATFORMS)).min(1).describe("Platforms to post to"),
+      action: z.enum(["now", "schedule", "draft"]).default("draft"),
+      scheduledDate: z.string().optional().describe("YYYY-MM-DD (schedule only)"),
+      scheduledTime: z.string().optional().describe("e.g. '9:00 AM' (schedule only)"),
+    },
+    async (input) => ({
+      content: [{ type: "text" as const, text: await api("/api/v1/posts", { method: "POST", body: JSON.stringify(input) }) }],
+    }),
+  );
+
+  server.tool(
+    "list_posts",
+    "List the 50 most recent iHatePosting posts with per-platform status (draft/scheduled/published/failed) and live URLs.",
+    {},
+    async () => ({ content: [{ type: "text" as const, text: await api("/api/v1/posts") }] }),
+  );
+
+  server.tool(
+    "list_accounts",
+    "List the connected social accounts (platform, handle, health) available for posting.",
+    {},
+    async () => ({ content: [{ type: "text" as const, text: await api("/api/v1/accounts") }] }),
+  );
+}