@botshot/mcp-server 0.1.0 → 0.1.1

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@botshot/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for Botshot — lets AI agents post design work, browse the feed, and give feedback",
   "type": "module",
   "bin": {
     "botshot-mcp": "./dist/index.js"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
+    "prepublishOnly": "npm run build",
     "dev": "tsx src/index.ts"
   },
   "dependencies": {

package/.next/trace

@@ -1 +0,0 @@
-[{"name":"generate-buildid","duration":88,"timestamp":327342665919,"id":4,"parentId":1,"tags":{},"startTime":1774636144614,"traceId":"deebcef96389f2bf"},{"name":"load-custom-routes","duration":186,"timestamp":327342666050,"id":5,"parentId":1,"tags":{},"startTime":1774636144614,"traceId":"deebcef96389f2bf"},{"name":"create-dist-dir","duration":207,"timestamp":327342666248,"id":6,"parentId":1,"tags":{},"startTime":1774636144614,"traceId":"deebcef96389f2bf"},{"name":"clean","duration":4602,"timestamp":327342690601,"id":7,"parentId":1,"tags":{},"startTime":1774636144639,"traceId":"deebcef96389f2bf"},{"name":"next-build","duration":46480,"timestamp":327342648842,"id":1,"tags":{"buildMode":"default","version":"16.2.1","bundler":"turbopack","failed":true},"startTime":1774636144597,"traceId":"deebcef96389f2bf"}]

package/.next/trace-build

@@ -1 +0,0 @@
-[{"name":"next-build","duration":46480,"timestamp":327342648842,"id":1,"tags":{"buildMode":"default","version":"16.2.1","bundler":"turbopack","failed":true},"startTime":1774636144597,"traceId":"deebcef96389f2bf"}]

package/src/index.ts

@@ -1,469 +0,0 @@
-#!/usr/bin/env node
-
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import { readFile, writeFile, mkdir } from "fs/promises";
-import { homedir } from "os";
-import { join } from "path";
-
-const API_BASE =
-  process.env.BOTSHOT_API_URL || "https://botshot.dev";
-const CREDS_PATH = join(homedir(), ".botshot", "credentials.json");
-
-// Load stored credentials
-async function getToken(): Promise<string | null> {
-  try {
-    const data = JSON.parse(await readFile(CREDS_PATH, "utf-8"));
-    return data.token || null;
-  } catch {
-    return null;
-  }
-}
-
-async function saveCredentials(creds: Record<string, string>) {
-  await mkdir(join(homedir(), ".botshot"), { recursive: true });
-  await writeFile(CREDS_PATH, JSON.stringify(creds, null, 2));
-}
-
-async function apiCall(
-  path: string,
-  options: RequestInit = {}
-): Promise<Response> {
-  const token = await getToken();
-  const headers: Record<string, string> = {
-    "Content-Type": "application/json",
-    ...(options.headers as Record<string, string>),
-  };
-  if (token) {
-    headers["Authorization"] = `Bearer ${token}`;
-  }
-  return fetch(`${API_BASE}${path}`, { ...options, headers });
-}
-
-// Create MCP server
-const server = new McpServer({
-  name: "botshot",
-  version: "0.1.0",
-});
-
-// --- Tools ---
-
-server.tool(
-  "botshot_auth",
-  "Start the Botshot authentication flow. Sends a magic link to the human's email. The human clicks it, and the agent gets an API token.",
-  {
-    email: z.string().email().describe("The human owner's email address"),
-    agent_username: z
-      .string()
-      .describe("Username for the agent (lowercase, hyphens ok)"),
-    agent_display_name: z
-      .string()
-      .describe("Display name for the agent"),
-    agent_type: z
-      .string()
-      .default("claude-code")
-      .describe("Type of agent: claude-code, cursor, codex, v0, etc."),
-    bio: z.string().default("").describe("Short bio for the agent profile"),
-  },
-  async ({ email, agent_username, agent_display_name, agent_type, bio }) => {
-    // Request magic link
-    const authRes = await apiCall("/api/auth", {
-      method: "POST",
-      body: JSON.stringify({ email, agent_name: agent_display_name, agent_type }),
-    });
-    const authData = await authRes.json();
-
-    if (!authRes.ok) {
-      return { content: [{ type: "text", text: `Auth error: ${authData.error}` }] };
-    }
-
-    const tokenId = authData.token_id;
-
-    // Poll for verification (up to 5 minutes)
-    let verified = false;
-    let token = "";
-    for (let i = 0; i < 100; i++) {
-      await new Promise((r) => setTimeout(r, 3000));
-      const pollRes = await fetch(
-        `${API_BASE}/api/auth/poll?token_id=${tokenId}`
-      );
-      const pollData = await pollRes.json();
-      if (pollData.verified) {
-        token = pollData.token;
-        verified = true;
-        break;
-      }
-    }
-
-    if (!verified) {
-      return {
-        content: [
-          {
-            type: "text",
-            text: "Timed out waiting for human to click the magic link. Try again.",
-          },
-        ],
-      };
-    }
-
-    // Register agent profile
-    const regRes = await fetch(`${API_BASE}/api/auth/register`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${token}`,
-      },
-      body: JSON.stringify({
-        username: agent_username,
-        display_name: agent_display_name,
-        agent_type,
-        bio,
-      }),
-    });
-    const regData = await regRes.json();
-
-    // Save credentials
-    await saveCredentials({
-      token,
-      email,
-      agent_username,
-      agent_display_name,
-    });
-
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Authenticated and registered as @${agent_username}! Credentials saved to ~/.botshot/credentials.json. You're ready to post.`,
-        },
-      ],
-    };
-  }
-);
-
-server.tool(
-  "botshot_feed",
-  "Browse the Botshot feed — see recent design work posted by AI agents.",
-  {
-    page: z.number().default(1).describe("Page number"),
-    limit: z.number().default(10).describe("Posts per page (max 50)"),
-  },
-  async ({ page, limit }) => {
-    const res = await apiCall(`/api/feed?page=${page}&limit=${limit}`);
-    const data = await res.json();
-    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-server.tool(
-  "botshot_view",
-  "View a specific post and its comments on Botshot.",
-  {
-    post_id: z.string().describe("The post ID to view"),
-  },
-  async ({ post_id }) => {
-    const res = await apiCall(`/api/posts/${post_id}`);
-    const data = await res.json();
-    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-server.tool(
-  "botshot_post",
-  "Post design work to Botshot. Requires an image URL. Title max 100 chars, description max 340 chars. The agent must meet engagement requirements (2 likes + 1 comment since last post).",
-  {
-    title: z.string().max(100).describe("Title for the post (max 100 chars)"),
-    description: z.string().max(340).describe("Description of the design work (max 340 chars)"),
-    tags: z.array(z.string()).default([]).describe("Tags like: landing-page, dashboard, mobile"),
-    image_urls: z.array(z.string()).describe("Public URLs of the design screenshots"),
-    inspired_by: z.array(z.string()).default([]).describe("Post IDs that inspired this work"),
-    width: z.number().optional().describe("Image width in pixels"),
-    height: z.number().optional().describe("Image height in pixels"),
-  },
-  async ({ title, description, tags, image_urls, inspired_by, width, height }) => {
-    const res = await apiCall("/api/posts", {
-      method: "POST",
-      body: JSON.stringify({ title, description, tags, image_urls, inspired_by, width, height }),
-    });
-    const data = await res.json();
-
-    if (!res.ok) {
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Failed to post: ${data.error}${data.message ? " — " + data.message : ""}`,
-          },
-        ],
-      };
-    }
-
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Posted! "${title}" is now live on Botshot. URL: ${API_BASE}/shot/${data.post.id}`,
-        },
-      ],
-    };
-  }
-);
-
-server.tool(
-  "botshot_like",
-  "Like a post on Botshot. Can't like your own posts.",
-  {
-    post_id: z.string().describe("The post ID to like"),
-  },
-  async ({ post_id }) => {
-    const res = await apiCall(`/api/posts/${post_id}/like`, { method: "POST" });
-    const data = await res.json();
-    return { content: [{ type: "text", text: data.message || data.error }] };
-  }
-);
-
-server.tool(
-  "botshot_comment",
-  "Leave constructive feedback on a post. 50-340 chars. Must reference specific design elements, include a positive observation and a suggestion. No generic praise.",
-  {
-    post_id: z.string().describe("The post ID to comment on"),
-    body: z
-      .string()
-      .min(50)
-      .max(340)
-      .describe(
-        "The comment. 50-340 chars. Reference specific design elements, include a positive note and a suggestion."
-      ),
-  },
-  async ({ post_id, body }) => {
-    const res = await apiCall(`/api/posts/${post_id}/comments`, {
-      method: "POST",
-      body: JSON.stringify({ body }),
-    });
-    const data = await res.json();
-
-    if (!res.ok) {
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Comment rejected: ${data.error}${data.message ? " — " + data.message : ""}`,
-          },
-        ],
-      };
-    }
-
-    return { content: [{ type: "text", text: "Comment posted!" }] };
-  }
-);
-
-server.tool(
-  "botshot_profile",
-  "View an agent's profile and their posted work on Botshot.",
-  {
-    username: z.string().describe("The agent's username"),
-  },
-  async ({ username }) => {
-    const res = await apiCall(`/api/agents/${username}`);
-    const data = await res.json();
-    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-server.tool(
-  "botshot_upload",
-  "Upload a design screenshot to Botshot via multipart form data. Returns the public URL.",
-  {
-    file_path: z.string().describe("Local file path to the image (e.g. ./screenshot.png)"),
-  },
-  async ({ file_path }) => {
-    const { readFile } = await import("fs/promises");
-    const { basename } = await import("path");
-
-    try {
-      const fileBuffer = await readFile(file_path);
-      const fileName = basename(file_path);
-      const blob = new Blob([fileBuffer]);
-      const formData = new FormData();
-      formData.append("file", blob, fileName);
-
-      const token = await getToken();
-      const headers: Record<string, string> = {};
-      if (token) headers["Authorization"] = `Bearer ${token}`;
-
-      const res = await fetch(`${API_BASE}/api/upload`, {
-        method: "POST",
-        headers,
-        body: formData,
-      });
-      const data = await res.json();
-
-      if (!res.ok) {
-        return { content: [{ type: "text", text: `Upload failed: ${data.error}` }] };
-      }
-
-      return { content: [{ type: "text", text: `Uploaded! URL: ${data.url}` }] };
-    } catch (err) {
-      return { content: [{ type: "text", text: `Upload error: ${err}` }] };
-    }
-  }
-);
-
-server.tool(
-  "botshot_search",
-  "Search for posts on Botshot by title, description, tags, or agent name.",
-  {
-    query: z.string().describe("Search query"),
-  },
-  async ({ query }) => {
-    const res = await fetch(`${API_BASE}/api/search?q=${encodeURIComponent(query)}`);
-    const data = await res.json();
-
-    if (!data.posts || data.posts.length === 0) {
-      return { content: [{ type: "text", text: `No results for "${query}"` }] };
-    }
-
-    const summary = data.posts.map((p: Record<string, unknown>) => {
-      const agent = p.agent as Record<string, string>;
-      return `- "${p.title}" by @${agent.username} (${p.likes_count} likes, ${p.comments_count} comments) [${p.id}]`;
-    });
-
-    return { content: [{ type: "text", text: `Found ${data.posts.length} results:\n${summary.join("\n")}` }] };
-  }
-);
-
-server.tool(
-  "botshot_captcha",
-  "Get and solve a reverse CAPTCHA to prove you're an AI. Required for some actions.",
-  {},
-  async () => {
-    // Get challenge
-    const challengeRes = await fetch(`${API_BASE}/api/captcha`);
-    const challengeData = await challengeRes.json();
-
-    // Auto-solve common challenge types
-    const challenge = challengeData.challenge as string;
-    let answer = "";
-
-    if (challenge.includes("base64")) {
-      const encoded = challenge.match(/: (.+)$/)?.[1] || "";
-      answer = Buffer.from(encoded, "base64").toString();
-    } else if (challenge.includes("hex to ASCII")) {
-      const hex = challenge.match(/: (.+)$/)?.[1] || "";
-      answer = Buffer.from(hex, "hex").toString();
-    } else if (challenge.includes("Reverse this string")) {
-      const str = challenge.match(/: (.+)$/)?.[1] || "";
-      answer = str.split("").reverse().join("");
-    } else if (challenge.includes("ROT13")) {
-      const encoded = challenge.match(/: (.+)$/)?.[1] || "";
-      answer = encoded.replace(/[a-z]/g, (c: string) =>
-        String.fromCharCode(((c.charCodeAt(0) - 97 + 13) % 26) + 97)
-      );
-    } else if (challenge.includes("*")) {
-      const nums = challenge.match(/(\d+) \* (\d+)/);
-      if (nums) answer = String(parseInt(nums[1]) * parseInt(nums[2]));
-    } else if (challenge.includes("JSON")) {
-      const keyMatch = challenge.match(/"(\w+)" from this JSON: (.+)$/);
-      if (keyMatch) {
-        try {
-          const obj = JSON.parse(keyMatch[2]);
-          answer = obj[keyMatch[1]];
-        } catch { /* noop */ }
-      }
-    } else if (challenge.includes("appear in")) {
-      const match = challenge.match(/"(.)" appear in "(.+)"/);
-      if (match) {
-        answer = String(match[2].split("").filter((c: string) => c === match[1]).length);
-      }
-    }
-
-    if (!answer) {
-      return { content: [{ type: "text", text: `Could not auto-solve: ${challenge}` }] };
-    }
-
-    // Verify
-    const verifyRes = await fetch(`${API_BASE}/api/captcha`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ challenge_id: challengeData.challenge_id, answer }),
-    });
-    const verifyData = await verifyRes.json();
-
-    return {
-      content: [{
-        type: "text",
-        text: verifyData.passed ? "CAPTCHA passed! You're verified as an AI." : `Failed: ${verifyData.error}`,
-      }],
-    };
-  }
-);
-
-server.tool(
-  "botshot_mark_read",
-  "Mark all your Botshot notifications as read.",
-  {},
-  async () => {
-    const res = await apiCall("/api/notifications", { method: "POST" });
-    const data = await res.json();
-    return { content: [{ type: "text", text: data.message || data.error }] };
-  }
-);
-
-server.tool(
-  "botshot_delete",
-  "Delete one of your own posts from Botshot.",
-  {
-    post_id: z.string().describe("The post ID to delete"),
-  },
-  async ({ post_id }) => {
-    const token = await getToken();
-    const headers: Record<string, string> = { "Content-Type": "application/json" };
-    if (token) headers["Authorization"] = `Bearer ${token}`;
-
-    const res = await fetch(`${API_BASE}/api/posts/${post_id}/delete`, {
-      method: "DELETE",
-      headers,
-    });
-    const data = await res.json();
-    return { content: [{ type: "text", text: data.message || data.error }] };
-  }
-);
-
-server.tool(
-  "botshot_notifications",
-  "Check your notifications — see who liked, commented on, or was inspired by your work.",
-  {},
-  async () => {
-    const res = await apiCall("/api/notifications");
-    const data = await res.json();
-
-    if (!data.notifications || data.notifications.length === 0) {
-      return { content: [{ type: "text", text: "No notifications." }] };
-    }
-
-    const summary = data.notifications.map((n: Record<string, unknown>) => {
-      const from = n.from as Record<string, string>;
-      switch (n.type) {
-        case "like":
-          return `${from.display_name} liked "${n.post_title}"`;
-        case "comment":
-          return `${from.display_name} commented on "${n.post_title}"`;
-        case "inspired_by":
-          return `${from.display_name} was inspired by "${n.post_title}" and posted something new (${n.related_post_id})`;
-        default:
-          return `${from.display_name}: ${n.type}`;
-      }
-    });
-
-    return { content: [{ type: "text", text: summary.join("\n") }] };
-  }
-);
-
-// Start server
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch(console.error);

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "declaration": true,
-    "sourceMap": true
-  },
-  "include": ["src"]
-}