Homespun MCP Server

Name: Homespun MCP Server
Author: dev.homespun

dev.homespun/homespun

Repository Registry

What is the Homespun MCP server?

Deploy a multi-user web app from your agent: hosting, auth, database, and permissions.

How to install Homespun

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

HOMESPUN_API_KEY
secret
Homespun agent API key. If unset, the server auto-registers a fresh agent against the relay on first use and saves the key to the shared CLI store (~/.config/homespun/config.json).
HOMESPUN_URL
Homespun relay base URL. Defaults to the hosted relay https://homespun.dev; set this to point at a different relay.
HOMESPUN_AGENT_NAME
Display name for the auto-registered agent on the relay.
HOMESPUN_REGISTER_SECRET
secret
Registration secret, required only for relays running REGISTRATION_MODE=secret.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "homespun": {
      "command": "npx",
      "args": [
        "-y",
        "@homespunapps/mcp"
      ],
      "env": {
        "HOMESPUN_API_KEY": "<YOUR_HOMESPUN_API_KEY>",
        "HOMESPUN_URL": "<YOUR_HOMESPUN_URL>",
        "HOMESPUN_AGENT_NAME": "<YOUR_HOMESPUN_AGENT_NAME>",
        "HOMESPUN_REGISTER_SECRET": "<YOUR_HOMESPUN_REGISTER_SECRET>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "homespun": {
      "command": "npx",
      "args": [
        "-y",
        "@homespunapps/mcp"
      ],
      "env": {
        "HOMESPUN_API_KEY": "<YOUR_HOMESPUN_API_KEY>",
        "HOMESPUN_URL": "<YOUR_HOMESPUN_URL>",
        "HOMESPUN_AGENT_NAME": "<YOUR_HOMESPUN_AGENT_NAME>",
        "HOMESPUN_REGISTER_SECRET": "<YOUR_HOMESPUN_REGISTER_SECRET>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "homespun": {
      "command": "npx",
      "args": [
        "-y",
        "@homespunapps/mcp"
      ],
      "env": {
        "HOMESPUN_API_KEY": "<YOUR_HOMESPUN_API_KEY>",
        "HOMESPUN_URL": "<YOUR_HOMESPUN_URL>",
        "HOMESPUN_AGENT_NAME": "<YOUR_HOMESPUN_AGENT_NAME>",
        "HOMESPUN_REGISTER_SECRET": "<YOUR_HOMESPUN_REGISTER_SECRET>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "homespun": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@homespunapps/mcp"
      ],
      "env": {
        "HOMESPUN_API_KEY": "<YOUR_HOMESPUN_API_KEY>",
        "HOMESPUN_URL": "<YOUR_HOMESPUN_URL>",
        "HOMESPUN_AGENT_NAME": "<YOUR_HOMESPUN_AGENT_NAME>",
        "HOMESPUN_REGISTER_SECRET": "<YOUR_HOMESPUN_REGISTER_SECRET>"
      }
    }
  }
}

Claude Code

claude mcp add homespun --env HOMESPUN_API_KEY=<YOUR_HOMESPUN_API_KEY> --env HOMESPUN_URL=<YOUR_HOMESPUN_URL> --env HOMESPUN_AGENT_NAME=<YOUR_HOMESPUN_AGENT_NAME> --env HOMESPUN_REGISTER_SECRET=<YOUR_HOMESPUN_REGISTER_SECRET> -- npx -y @homespunapps/mcp