@uplink-code/mcp 0.0.1

package/lib/mcp/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+var s=Object.defineProperty;var r=(e,t)=>s(e,"name",{value:t,configurable:!0});import{McpServer as a}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as l}from"@modelcontextprotocol/sdk/server/stdio.js";import{TOOLS as p}from"@uplink-code/agent-tools";function o(e){for(let t of p)e.registerTool(`uplink_${t.name}`,{description:t.description},()=>({content:[{type:"text",text:JSON.stringify({error:{code:"not_implemented",message:`Tool ${t.name} scaffold present but handlers not yet wired. Requires @uplink-code/agent-tools v0.2.0+.`}})}],isError:!0}))}r(o,"registerTools");import{UPLINK_API_REFERENCE as c,buildSystemPrompt as m}from"@uplink-code/agent-tools";function i(e){e.registerResource("uplink-api-reference","uplink://api-reference",{title:"Uplink API Reference",description:"Methods available on the Uplink `page` and `browser` objects (the surface user scripts run against). Read this before writing or editing scripts so you don't guess at non-existent methods (no waitForTimeout, no locator, etc.).",mimeType:"text/markdown"},t=>Promise.resolve({contents:[{uri:t.toString(),mimeType:"text/markdown",text:c}]})),e.registerResource("uplink-system-prompt","uplink://system-prompt",{title:"Uplink Scripting Conventions",description:"Conventions, idioms, and anti-patterns for writing Uplink automation scripts. Built into the prompt automatically by clients that consume MCP resources at session start.",mimeType:"text/markdown"},t=>Promise.resolve({contents:[{uri:t.toString(),mimeType:"text/markdown",text:m({})}]}))}r(i,"registerResources");var u="@uplink-code/mcp",d="0.0.1";async function n(){let e=new a({name:u,version:d},{capabilities:{tools:{},resources:{}}});o(e),i(e);let t=new l;await e.connect(t)}r(n,"runServer");n().catch(e=>{process.stderr.write(`[uplink-mcp] fatal: ${e instanceof Error?e.message:String(e)}
+`),process.exit(1)});

package/lib/mcp/src/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * @uplink-code/mcp — MCP server entrypoint.
+ *
+ * Boots a stdio MCP server that exposes Uplink's browser automation
+ * tools to any MCP-capable AI client (Claude Code, Cursor, etc.).
+ *
+ * Auth: reads UPLINK_API_KEY from env. CLI/config-file integration
+ * comes from @uplink-code/cli once that's stood up.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/mcp/src/resources.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register Uplink documentation as MCP resources. MCP clients
+ * (Claude Code, Cursor, etc.) can fetch these and include them in
+ * the model's context — no separate "skill install" step needed.
+ *
+ * Two resources:
+ *   uplink://api-reference — the Uplink page/browser API surface
+ *   uplink://system-prompt — Uplink scripting conventions + idioms,
+ *     built from agent-tools' buildSystemPrompt
+ */
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=resources.d.ts.map

package/lib/mcp/src/server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Boot the stdio MCP server. Registers tools from
+ * @uplink-code/agent-tools and dispatches calls against the
+ * per-session Uplink Page held in module state.
+ *
+ * v0.0.1 ships the scaffold + tool registration only; actual
+ * tool handlers wire up after agent-tools v0.2.0/v0.3.0 are
+ * published.
+ */
+export declare function runServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/lib/mcp/src/tools.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register Uplink's agent tools on the MCP server. Tool names are
+ * namespaced `uplink_*` so they don't collide with other MCP servers
+ * a user might have installed (filesystem, github, etc.).
+ *
+ * Scaffold version: every tool handler returns `not_implemented`.
+ * Once agent-tools v0.2.0 + v0.3.0 are published, handlers wire in
+ * here.
+ */
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@uplink-code/mcp",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/mcp/src/index.d.ts",
+      "import": "./lib/mcp/index.js",
+      "require": "./lib/mcp/index.js"
+    }
+  },
+  "bin": {
+    "uplink-mcp": "./lib/mcp/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "url": "git://github.com/uplink-code/uplink-ai.git"
+  },
+  "files": [
+    "package.json",
+    "lib/mcp/**/*.js",
+    "lib/mcp/**/*.d.ts"
+  ],
+  "scripts": {
+    "build": "npm run build:declarations && npm run build:transpile",
+    "build:transpile": "esbuild src/index.ts --bundle --keep-names --minify --format=esm --platform=node --external:@uplink-code/uplink --external:@uplink-code/ai --external:@uplink-code/agent-tools --external:@modelcontextprotocol/sdk --outfile=./lib/mcp/index.js",
+    "build:declarations": "tsc -b",
+    "clean": "rm -rf lib",
+    "format:check": "prettier --check src/ package.json tsconfig.json",
+    "format:fix": "prettier --write src/ package.json tsconfig.json",
+    "lint": "eslint src/",
+    "lint:fix": "eslint --fix src/",
+    "prepare": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.1",
+    "esbuild": "^0.25.9",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.56.0"
+  },
+  "keywords": [
+    "uplink",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "browser-automation"
+  ],
+  "author": "scott@atomicfi.com",
+  "license": "proprietary",
+  "description": "Model Context Protocol server for Uplink — exposes Uplink's browser automation tools to any MCP-capable AI client (Claude Code, Cursor, etc.)",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@uplink-code/agent-tools": "^0.1.0",
+    "@uplink-code/ai": "^0.3.0",
+    "@uplink-code/uplink": ">=0.9.0 <1.0.0"
+  }
+}