Back to Browse

Homespun MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://homespun.dev/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

Endpoint verified · Open access · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

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).Required

Environment variable: HOMESPUN_API_KEY

Homespun relay base URL. Defaults to the hosted relay https://homespun.dev; set this to point at a different relay.Optional

Environment variable: HOMESPUN_URL

Display name for the auto-registered agent on the relay.Optional

Environment variable: HOMESPUN_AGENT_NAME

Registration secret, required only for relays running REGISTRATION_MODE=secret.Required

Environment variable: HOMESPUN_REGISTER_SECRET

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

Homespun

Apps your AI builds and hosts, for you and the people you invite.

An agent creates a real web app from a single HTML file plus a manifest, and Homespun hosts it at a URL. People open the link and use it. No install, no build step, no deploy pipeline.

Docs: docs.homespun.dev

What is in this repository

The client side, all MIT licensed:

PackageWhat it is
@homespunapps/cliThe homespun command line client
@homespunapps/mcpThe MCP server, so an agent can drive Homespun as a tool
@homespunapps/coreShared client library and types

Plus the agent skill (skills/homespun) and the Claude plugin (plugins/homespun).

The relay, which is the hosted server these clients talk to, is not open source and is not in this repository.

Getting started

npm install -g @homespunapps/cli
homespun agent register
homespun deploy ./my-app

./my-app needs an index.html and a manifest.json. The quickstart walks through both.

To use Homespun from a chat client such as Claude or ChatGPT instead of a terminal, see Connect to your AI chat, which needs no install at all.

Reference

Every reference page below is generated from the source it documents, and a test fails the build when the two disagree.

Contributing

This repository is a read-only mirror. See CONTRIBUTING.md.

License

MIT. See LICENSE.

Reviews

No reviews yet

Be the first to review this server!