@buildinternet/uploads 0.48.0 → 0.48.1

package/README.md

@@ -204,6 +204,8 @@ Config layers (first match wins): CLI flags → env vars → `--env-file` → `~
 
 Or with `UPLOADS_TOKEN`/`UPLOADS_WORKSPACE` in the environment or user config. Claude Code: `claude mcp add uploads -- uploads --env-file /path/to/.env mcp`.
 
+The MCP Registry lists this server as `sh.uploads/mcp`.
+
 For HTTP clients there's also a hosted variant at `https://agents.uploads.sh/mcp` — the workspace is inferred from the bearer token, so only the URL and token are needed (`https://agents.uploads.sh/<workspace>/mcp` and the `mcp.uploads.sh` hostname also work). Tools: file operations (including `get_metadata` / `set_metadata` / `find_files`) plus `gallery_create`, `gallery_get`, `gallery_add`, `gallery_link`, and `gallery_find_by_reference`; all use the same bearer-token workspace scopes and gallery URLs come from the API — see `apps/mcp` in the repo. The hosted `put` also accepts a `metadata` param. `uploads install` registers the skills + hosted MCP with whichever of Claude Code, Codex, and Grok are on PATH (a missing CLI is skipped) + Grok/Cursor hooks (short progress; `--verbose` for underlying output). Claude and Codex use their plugins for the same pre-PR screenshot reminder (`uploads hook pre-pr-screenshot`). Its `put` takes no content type: the stored type is sniffed server-side from the bytes and checked against the workspace allowlist, and writes are rate limited per workspace.
 
 ## Programmatic use

package/dist/commands/mcp.js

@@ -2,7 +2,7 @@ import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { AjvJsonSchemaValidator } from "@modelcontextprotocol/server/validators/ajv";
 import { parseCommandArgs } from "../cli-args.js";
 import { resolveApiUrl } from "../config.js";
-import { createMcpServer } from "../mcp/server.js";
+import { createMcpServer, MCP_SERVER_ICONS } from "../mcp/server.js";
 import { createUploadsMcpTools } from "../mcp/tools.js";
 import { packageVersion } from "../package-version.js";
 import { writeCommandHelp } from "../cli-style.js";
@@ -35,7 +35,7 @@ export async function runMcp(args, opts, help = false) {
     // `@cfworker/json-schema` provider instead).
     const validator = new AjvJsonSchemaValidator();
     const handle = serveStdio(() => createMcpServer({
-        serverInfo: { name: "uploads", version: packageVersion() },
+        serverInfo: { name: "uploads", version: packageVersion(), icons: MCP_SERVER_ICONS },
         tools: createUploadsMcpTools({ globals: opts.globals }),
         apiUrl: resolveApiUrl(opts.globals),
         validator,

package/dist/mcp/server.d.ts

@@ -17,7 +17,7 @@
  * The stdio transport comes from `@modelcontextprotocol/server/stdio`; logs
  * must never go to stdout.
  */
-import { McpServer, type jsonSchemaValidator } from "@modelcontextprotocol/server";
+import { McpServer, type Implementation, type jsonSchemaValidator } from "@modelcontextprotocol/server";
 export { appProp, canonicalMetaFromArgs, METADATA_DESCRIPTION, metadataArgWithCanonical, metadataProp, stateProp, optBool, optPosInt, optString, optStringArray, optStringRecord, usage, type ToolArgs, } from "./args.js";
 export { ToolBatchError, batchFailureMessage } from "./batch-error.js";
 export { mapBounded } from "../async.js";
@@ -81,11 +81,14 @@ export interface McpTool {
     outputSchema?: Record<string, unknown>;
     handler: (args: Record<string, unknown>) => Promise<unknown>;
 }
+/**
+ * Brand mark on `serverInfo.icons` (MCP `Icon`, spec 2026-07-28). PNG is the
+ * type clients that render icons MUST support. The file is the site's
+ * apple-touch-icon (180×180 pixel chevron), already public on uploads.sh.
+ */
+export declare const MCP_SERVER_ICONS: NonNullable<Implementation["icons"]>;
 export declare function createMcpServer(opts: {
-    serverInfo: {
-        name: string;
-        version: string;
-    };
+    serverInfo: Implementation;
     tools: McpTool[];
     /** API base for telemetry (honors uploads --api-url). */
     apiUrl?: string;

package/dist/mcp/server.js

@@ -138,6 +138,18 @@ function wrapHandler(tool, apiUrl) {
         }
     };
 }
+/**
+ * Brand mark on `serverInfo.icons` (MCP `Icon`, spec 2026-07-28). PNG is the
+ * type clients that render icons MUST support. The file is the site's
+ * apple-touch-icon (180×180 pixel chevron), already public on uploads.sh.
+ */
+export const MCP_SERVER_ICONS = [
+    {
+        src: "https://uploads.sh/apple-touch-icon.png",
+        mimeType: "image/png",
+        sizes: ["180x180"],
+    },
+];
 export function createMcpServer(opts) {
     const { serverInfo, tools, apiUrl, validator } = opts;
     const server = new McpServer(serverInfo, {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@buildinternet/uploads",
-  "version": "0.48.0",
+  "version": "0.48.1",
+  "mcpName": "sh.uploads/mcp",
   "description": "CLI and client for uploads.sh — workspace-scoped image hosting for GitHub embeds",
   "type": "module",
   "sideEffects": false,