dev.homespun/homespun

up checked 2026-11-11T08:37:21.109Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Homespun

Publisher-provided description

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

Summary by lookupd

Deploys multi-user web apps with hosting, auth, row-based collections, change feeds, grants, webhooks, and member permissions.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http homespun https://homespun.dev/mcp

Claude Code, npm package (stdio)

claude mcp add homespun -- npx -y @homespunapps/mcp

Codex, remote (streamable-http)

codex mcp add homespun --url https://homespun.dev/mcp

Codex, npm package (stdio)

codex mcp add homespun -- npx -y @homespunapps/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "homespun": {
      "url": "https://homespun.dev/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "homespun": {
      "command": "npx",
      "args": [
        "-y",
        "@homespunapps/mcp"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (27 tools)

Publisher-provided text

• document_upload Create a short-lived, byte-scoped upload session for an HTML document authored in a native editor or shell. The caller supplies the exact UTF-8 byte length and
• deploy_app Deploy a v2 app: an HTML document plus a capability manifest, hosted at its own URL. For sandbox-authored files in hosted chat, native file editing and shell to
• list_rows List rows in a v2 app's mutable collection. This is also how a collection's current state is polled, since MCP has no streaming: pass the prior next_cursor as `
• count_rows The live row count of a v2 app's collection (spec B4, issue #1056), a whole-scope total with no filter and no paging. Gated by the collection's countRead opt-in
• get_row Fetch a single row by its key from a v2 app collection, through a dedicated relay route rather than a client-side scan. Returns { row }, or an isError row_not_f
• add_row Create a row in a v2 app's collection, or return the existing row when `key` is already present (deduped:true). Row creation goes through this tool; there is no
• update_row Update an existing row in a v2 app's collection, replacing its data. Gated by the collection's `update` role list when it declares one, and by its `write` list
• delete_row Soft-delete a row from a v2 app's collection. Recoverable: the row is tombstoned, not destroyed, and restore_row brings it back for 30 days (see list_deleted_ro
• list_deleted_rows List a collection's recently deleted rows: the recovery bin. Deleting a row is a soft delete, so it can be restored with restore_row until recoverable_until pas
• restore_row Restore a soft-deleted row, undoing delete_row. The row comes back with its original data and creator, its version bumped. Find restorable keys with list_delete
• get_feed_events Poll a v2 app's change feed for what has happened: row creates, updates and deletes, from any writer, agent or human. It is the long-poll analogue of `homespun
• apps The v2 app lifecycle apart from creation and redeploy, which deploy_app covers. Actions: list returns the owning human's apps; show returns full detail includin
• members A v2 app's membership (auth spec section 6): who besides the owner can sign in to a private app and write to member-scoped collections. Actions: add invites or
• grants A v2 app's grant links (M5). A grant link is a capability URL that confers a declared custom role (x-homespun-manifest.roles) on a stable per-holder anonymous i
• transfer A v2 app's ownership transfer (issue #1847): handing the app, and the quota and billing responsibility that come with it, to a different human. This is two step
• credentials A v2 app's scoped service credentials (#1354, #1355): the bearer token an app owner points a backend they host themselves at, so their own server can read and w
• connections A v2 app's Connections: the stored credential (a static header token, or a full generic OAuth2 client) a manifest webhook rule authenticates its delivery target
• ingest A v2 app's inbound catch-hooks (inbound-webhooks). A catch-hook lets an external system such as Stripe, Zapier, Make, Home Assistant or an email router POST JSO
• attachments Binary attachments (images, PDFs, audio, video) referenced from event payloads and input_data via `format: homespun-attachment-id`. Actions: upload, fetch, pres
• taste The agent's UI taste notes: a short freeform markdown document of presentation preferences gathered from human feedback, such as 'denser layout' or 'no rounded
• key The calling agent's API key. Actions: list returns key info (agent_id, key_prefix, timestamps); mint creates a sibling API key for the caller's own agent identi
• feedback Reports a problem with homespun itself to the relay operator, and lists what this agent has already reported. A report is the operator's only visibility into a
• agent Agent identity and binding. Actions: whoami returns the resolved relay URL, the active profile and whether a key is configured, with no network call and no secr
• community Publishing an app as a community template, taking your own listing back down, installing a template, and, for relay operators, reviewing submissions. Actions: p
• publisher The caller's community publisher identity: the @-handle and public profile shown in the template gallery. Actions: get returns the profile, including the handle
• review Ratings and reviews of community templates, responses from a template's own publisher, and, for relay operators, moderation. Actions: create leaves a 1-to-5 sta
• get_skill The relay's SKILL.md, a generated guide to the Homespun workflow covering events versus records, the schema grammars and the poll loop. Needs no API key. Useful

Details

• Version: 1.6.98
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 819 ms
• First indexed: 2026-11-01T09:01:05.890Z
• Last seen in registry: 2026-11-01T09:01:07.462Z
• Repository: https://github.com/homespunapps/homespun
• Website: https://homespun.dev

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/dev.homespun/homespun.svg)](https://lookupd.com/servers/dev.homespun/homespun)

• 62033 servers
• Last crawl: 2026-11-11T15:38:39.561Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp