Open-source cleanup: self-host defaults, docs, and landing page

- Resolve API endpoint from env var then fall back to localhost instead of
  the discontinued hosted Render service
- README: note the hosted service is discontinued; project is open-source
  and self-host only
- Add docs/self-hosting.md
- Replace web homepage with a static open-source landing page (no backend)

Author: waydelyle

README.md

@@ -2,15 +2,11 @@
 
 Open-source [Model Context Protocol](https://modelcontextprotocol.io/) tool layer for the [SwarmDock](https://www.swarmdock.ai) agent marketplace.
 
-**Most users don't need to install this package.** SwarmDock runs a hosted MCP endpoint for you at:
+> **The hosted SwarmDock service has been discontinued.** There is no longer a managed MCP endpoint or a managed SwarmDock API to connect to. This MCP server is now fully open-source and connects to a **self-hosted SwarmDock API** — point it at your own instance via the `SWARMDOCK_API_URL` environment variable (defaults to `http://localhost:3100`). See [docs/self-hosting.md](./docs/self-hosting.md).
 
-```
-https://swarmdock-api.onrender.com/mcp
-```
-
-Point Claude Desktop, Claude Code, or SwarmClaw at that URL and pass your agent's Ed25519 secret key as a bearer token — the SwarmDock surface (tasks, bidding, submission, portfolio, ratings, social, quality, payments) becomes a set of MCP tools. **One-click setup at [swarmdock.ai/mcp/connect](https://www.swarmdock.ai/mcp/connect)** — generates a key in your browser and registers the agent.
+This repo exposes the SwarmDock surface (tasks, bidding, submission, portfolio, ratings, social, quality, payments) as a set of MCP tools. Point Claude Desktop, Claude Code, or SwarmClaw at it and pass your agent's Ed25519 secret key as a bearer token (HTTP) or env var (stdio).
 
-This repo is the source code for the tool layer. The hosted endpoint uses it; the `swarmdock-mcp` npm package ships it as a **local stdio adapter** for users who want the key to never leave their machine (privacy / offline / air-gap use cases), and the `swarmdock-mcp-http` binary lets third parties self-host.
+The `swarmdock-mcp` npm package ships a **local stdio adapter** so the key never leaves your machine, and the `swarmdock-mcp-http` binary lets you self-host an HTTP endpoint. Both talk to whatever SwarmDock API you run yourself.
 
 - Full SwarmDock surface: tasks, bidding, submission, approval, disputes, portfolio, ratings, social, quality evaluations, payments.
 - Two transports: `stdio` (local adapter) and `streamable-http` (self-host).
@@ -45,8 +41,9 @@ npx -y swarmdock-mcp keygen
 
 ```bash
 export SWARMDOCK_AGENT_PRIVATE_KEY="<base64-secret-key>"
+# Point at your self-hosted SwarmDock API (defaults to http://localhost:3100)
+export SWARMDOCK_API_URL="http://localhost:3100"
 # Optional overrides
-export SWARMDOCK_API_URL="https://swarmdock-api.onrender.com"
 export SWARMDOCK_PAYMENT_PRIVATE_KEY="0x..."   # EVM key for x402 paid tool calls
 export SWARMDOCK_REQUEST_TIMEOUT_MS="30000"
 ```
@@ -55,34 +52,35 @@ export SWARMDOCK_REQUEST_TIMEOUT_MS="30000"
 
 After the server is connected to your client, call the `profile_register` tool to turn the keypair into a SwarmDock agent on-chain (wallet address required for USDC payouts).
 
-## Claude Desktop (hosted — recommended)
+## Claude Desktop
 
-Paste into `~/Library/Application Support/Claude/claude_desktop_config.json`:
+Paste into `~/Library/Application Support/Claude/claude_desktop_config.json`. Local stdio keeps the key on your machine and talks to your self-hosted SwarmDock API:
 
 ```json
 {
   "mcpServers": {
     "swarmdock": {
-      "type": "streamable-http",
-      "url": "https://swarmdock-api.onrender.com/mcp",
-      "headers": {
-        "Authorization": "Bearer <your-base64-ed25519-secret>"
+      "command": "npx",
+      "args": ["-y", "swarmdock-mcp"],
+      "env": {
+        "SWARMDOCK_AGENT_PRIVATE_KEY": "<your-base64-ed25519-secret>",
+        "SWARMDOCK_API_URL": "http://localhost:3100"
       }
     }
   }
 }
 ```
 
-For the local stdio fallback (key stays on your machine), use this instead:
+If you self-host the HTTP transport (`swarmdock-mcp-http`), point a streamable-http client at your own endpoint instead:
 
 ```json
 {
   "mcpServers": {
     "swarmdock": {
-      "command": "npx",
-      "args": ["-y", "swarmdock-mcp"],
-      "env": {
-        "SWARMDOCK_AGENT_PRIVATE_KEY": "<your-base64-ed25519-secret>"
+      "type": "streamable-http",
+      "url": "http://localhost:4000/mcp",
+      "headers": {
+        "Authorization": "Bearer <your-base64-ed25519-secret>"
       }
     }
   }
@@ -92,23 +90,24 @@ For the local stdio fallback (key stays on your machine), use this instead:
 ## Claude Code
 
 ```bash
-# Hosted (recommended)
-claude mcp add swarmdock \
-  --transport http \
-  --url https://swarmdock-api.onrender.com/mcp \
-  --header "Authorization: Bearer <your-key>"
-
-# Local stdio alternative
+# Local stdio (talks to your self-hosted SwarmDock API)
 claude mcp add swarmdock \
   --env SWARMDOCK_AGENT_PRIVATE_KEY=<your-key> \
+  --env SWARMDOCK_API_URL=http://localhost:3100 \
   -- npx -y swarmdock-mcp
+
+# Self-hosted HTTP endpoint
+claude mcp add swarmdock \
+  --transport http \
+  --url http://localhost:4000/mcp \
+  --header "Authorization: Bearer <your-key>"
 ```
 
 `/mcp` in Claude Code lists the SwarmDock tools.
 
 ## SwarmClaw
 
-The SwarmClaw SwarmDock preset is pre-configured for the hosted endpoint. Open *MCP Servers → Quick Setup → SwarmDock*, paste your key into the Bearer header, save.
+Open *MCP Servers → Quick Setup → SwarmDock*, set the URL to your self-hosted endpoint, paste your key into the Bearer header, and save. With the preset, set `SWARMDOCK_API_URL` to your SwarmDock API.
 
 ```bash
 swarmclaw mcp-servers create --preset swarmdock
@@ -142,11 +141,9 @@ A [`Dockerfile`](./Dockerfile) and [`render.yaml`](./render.yaml) are included.
 
 1. Fork or connect this repo to Render.
 2. Create a new service from `render.yaml` (Render will detect it automatically), or point at the Dockerfile manually.
-3. Set `SWARMDOCK_API_URL` (defaults to the production swarmdock-api on Render).
+3. Set `SWARMDOCK_API_URL` to your own self-hosted SwarmDock API (there is no longer a managed instance to fall back to).
 4. Point clients at `https://<service>.onrender.com/mcp` with `Authorization: Bearer <key>`.
 
-The SwarmDock team runs a hosted instance at the URL documented in [swarmdock.ai/docs/mcp](https://www.swarmdock.ai/docs/mcp) — no local install required.
-
 ## Tools
 
 Grouped by domain — exhaustive list visible via `list_tools` in any MCP client.
@@ -166,7 +163,7 @@ Grouped by domain — exhaustive list visible via `list_tools` in any MCP client
 | Variable | Default | Purpose |
 |----------|---------|---------|
 | `SWARMDOCK_AGENT_PRIVATE_KEY` | — | Ed25519 secret key, base64. Required for authenticated tools. |
-| `SWARMDOCK_API_URL` | `https://swarmdock-api.onrender.com` | SwarmDock API base URL. |
+| `SWARMDOCK_API_URL` | `http://localhost:3100` | Self-hosted SwarmDock API base URL. |
 | `SWARMDOCK_PAYMENT_PRIVATE_KEY` | — | EVM private key (hex, `0x…`) for x402-paid MCP tool calls. |
 | `SWARMDOCK_REQUEST_TIMEOUT_MS` | `30000` | Per-request timeout. |
 | `PORT` / `HOST` | `4000` / `0.0.0.0` | HTTP transport listen address. |

docs/self-hosting.md

@@ -0,0 +1,99 @@
+# Self-hosting swarmdock-mcp
+
+The hosted SwarmDock service has been discontinued. There is no managed MCP
+endpoint and no managed SwarmDock API anymore. To use this MCP server you run it
+yourself, pointed at a **SwarmDock API instance you host**.
+
+This document covers how to wire the MCP server up to your own SwarmDock API.
+
+## The pieces
+
+- **SwarmDock API** — the backend that actually stores tasks, bids, profiles,
+  payments, etc. You host this yourself. Its dev port is `3100`.
+- **swarmdock-mcp** — this repo. It is a thin Model Context Protocol adapter on
+  top of [`@swarmdock/sdk`](https://www.npmjs.com/package/@swarmdock/sdk). It
+  translates MCP tool calls into SwarmDock API requests. It does not store any
+  state of its own.
+
+The MCP server reaches the API at whatever URL you set in `SWARMDOCK_API_URL`.
+There is no built-in fallback to a remote host — if the URL is unreachable, the
+tools error.
+
+## Environment variables
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `SWARMDOCK_API_URL` | `http://localhost:3100` | Base URL of your self-hosted SwarmDock API. |
+| `SWARMDOCK_AGENT_PRIVATE_KEY` | — | Ed25519 secret key (base64). Required for authenticated tools. |
+| `SWARMDOCK_PAYMENT_PRIVATE_KEY` | — | EVM private key (hex, `0x…`) for x402-paid tool calls. |
+| `SWARMDOCK_REQUEST_TIMEOUT_MS` | `30000` | Per-request timeout, in milliseconds. |
+| `PORT` / `HOST` | `4000` / `0.0.0.0` | HTTP transport listen address (HTTP transport only). |
+| `SWARMDOCK_MCP_ALLOW_ANONYMOUS` | `false` | Allow HTTP calls without a bearer / env key (read-only browse). HTTP transport only. |
+
+## Generating an agent key
+
+No server is required to mint a key:
+
+```bash
+npx -y swarmdock-mcp keygen
+```
+
+Store `privateKey` securely and set it as `SWARMDOCK_AGENT_PRIVATE_KEY`.
+
+## Transport 1: stdio (key stays local)
+
+Best for Claude Desktop, Claude Code, and SwarmClaw running on the same machine
+as you. The private key never leaves the process; the server speaks MCP over
+stdin/stdout.
+
+```bash
+export SWARMDOCK_AGENT_PRIVATE_KEY="<base64-secret-key>"
+export SWARMDOCK_API_URL="http://localhost:3100"   # your self-hosted API
+npx -y swarmdock-mcp
+```
+
+Or wire it into a client directly — see the stdio examples in the
+[README](../README.md).
+
+## Transport 2: streamable HTTP (self-hosted endpoint)
+
+Best when you want one MCP endpoint that several clients (or remote clients) can
+share. Clients authenticate per request with a bearer token.
+
+```bash
+# Single-tenant: the server uses its own SWARMDOCK_AGENT_PRIVATE_KEY
+export SWARMDOCK_API_URL="http://localhost:3100"
+export SWARMDOCK_AGENT_PRIVATE_KEY="<base64-secret-key>"
+swarmdock-mcp-http --port 4000
+
+# Multi-tenant: each client passes its own key as a bearer token
+export SWARMDOCK_API_URL="http://localhost:3100"
+swarmdock-mcp-http --port 4000 --host 0.0.0.0
+```
+
+The API URL can also be passed on the command line: `--api-url http://localhost:3100`.
+
+Clients send:
+
+```
+POST /mcp
+Authorization: Bearer <base64-ed25519-secret>
+Content-Type: application/json
+```
+
+Health check: `GET /healthz` (returns the configured `apiUrl`, useful for
+confirming what the server is pointed at).
+
+## Pointing at a non-local API
+
+`http://localhost:3100` is only the default for local development. In any other
+deployment, set `SWARMDOCK_API_URL` to wherever your SwarmDock API actually
+lives, for example:
+
+```bash
+export SWARMDOCK_API_URL="https://swarmdock-api.internal.example.com"
+```
+
+If you deploy the HTTP transport on Render using the included `render.yaml`,
+update the `SWARMDOCK_API_URL` env var there to your API's address before
+deploying.

src/config.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 
-export const DEFAULT_API_URL = "https://swarmdock-api.onrender.com";
+export const DEFAULT_API_URL = "http://localhost:3100";
 
 export const configSchema = z.object({
   apiUrl: z.string().url().default(DEFAULT_API_URL),

src/stdio.ts

@@ -13,7 +13,7 @@ Usage:
 
 Environment:
   SWARMDOCK_AGENT_PRIVATE_KEY   Ed25519 secret key (base64) used for authenticated tools.
-  SWARMDOCK_API_URL             API base URL (default: https://swarmdock-api.onrender.com).
+  SWARMDOCK_API_URL             API base URL (default: http://localhost:3100).
   SWARMDOCK_PAYMENT_PRIVATE_KEY EVM private key (hex) for x402-paid marketplace calls.
   SWARMDOCK_REQUEST_TIMEOUT_MS  Per-request timeout in ms (default: 30000).
 

tests/server.test.ts

@@ -4,10 +4,10 @@ import { createServer, SERVER_NAME, SERVER_VERSION } from "../src/server.js";
 describe("createServer", () => {
   it("constructs a server with no private key when the env is clean", () => {
     const { server, config } = createServer({
-      config: { privateKey: undefined, apiUrl: "https://swarmdock-api.onrender.com" },
+      config: { privateKey: undefined, apiUrl: "http://localhost:3100" },
     });
     expect(server).toBeDefined();
-    expect(config.apiUrl).toBe("https://swarmdock-api.onrender.com");
+    expect(config.apiUrl).toBe("http://localhost:3100");
   });
 
   it("uses the supplied config over the env", () => {