MCP server

Homespun Official

dev.homespun/homespun

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

homespun.dev (verified by the MCP Registry)

Status

Working at last check

Tools

27

Token cost

About 21,836 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.homespun]
url = "https://homespun.dev/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"homespun":{"type":"http","url":"https://homespun.dev/mcp"}}}

Antigravity

agy mcp add homespun https://homespun.dev/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"homespun","server_url":"https://homespun.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"homespun","server_url":"https://homespun.dev/mcp"}

Tools

• add_row ~561 tokens
  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 separate strict-create verb. Omit `key` to add a new row with a server-generated key, or pass `key` to ensure a row exists at that key. Pas
• agent ~313 tokens
  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 secrets; claim binds this agent to a human using a one-shot claim code from their Settings UI, and is one-way; logout clears the locally saved k
• apps ~1277 tokens
  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 including manifest, timezone and has_share_token; audit is a read-only security review of every app the caller owns, computed from each app's stored
• attachments ~1909 tokens
  Binary attachments (images, PDFs, audio, video) referenced from event payloads and input_data via `format: homespun-attachment-id`. Actions: upload, fetch, presign, finalize, download, show, list, delete, mint_token, revoke_token, list_tokens. Choosing an upload path matters for cost. An inline upl
• community ~3722 tokens
  Publishing an app as a community template, taking your own listing back down, installing a template, and, for relay operators, reviewing submissions. Actions: publish, unpublish, get_config_contract, install, list_pending, get_submission, approve, reject, set_trust_level. publish captures a live ap
• connections ~1321 tokens
  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 with, bound to a host so the credential can never be exfiltrated to another one. There is no update action: change a connection by deleting
• count_rows ~229 tokens
  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, independent of its read list: a collection that opted in returns its count even to a caller who cannot list the rows (the '3 spots left' s
• credentials ~1294 tokens
  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 write the app's data without holding the owner's full authority. Effective permission is always the intersection of the allowlist and what th
• delete_row Deletes data · ~244 tokens
  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_rows). A watcher sees the deletion live as op:delete on the change feed. Pass if_match for an optimistic-locked delete. Returns { deleted: tru
• deploy_app ~2584 tokens
  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 tools can create and validate the document. Its UTF-8 byte length and SHA-256 go to `document_upload`; the exact raw bytes are PUT to the retu
• document_upload ~407 tokens
  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 SHA-256 hex digest as { size, sha256, app_id? }. The returned `upload_url` accepts a PUT of those raw UTF-8 bytes with `Authorization: Beare
• feedback ~852 tokens
  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 failure that happened inside an agent's session, so an unreported one is a failure nobody can fix. The channel covers homespun's own behavi
• get_feed_events ~417 tokens
  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 watch`, since MCP has no streaming. The loop is: call with no `since` first, process the returned entries, keep the cursor, then call a
• get_row ~165 tokens
  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_found.
• get_skill ~188 tokens
  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 when working out how the other tools fit together, or to refresh a cached copy. Pass version_only:true to return just the relay's skill ver
• grants ~825 tokens
  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 identity, so a holder's own rows are isolated by author/:own scoping. A grant does not escalate to owner, member or agent. Actions: mint crea
• ingest ~838 tokens
  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 JSON to a secret URL that writes into a declared collection, so the app receives data with no agent online. Hooks are declared in the manifest
• key ~461 tokens
  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 identity with the same scope and ownership and returns its raw value once, which is how an MCP-driven agent hands a CLI or child process a working
• list_deleted_rows ~275 tokens
  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 passes (30 days after deletion by default). Owner or agent only, and deliberately independent of the collection's read permissions. Rows alread
• list_rows ~245 tokens
  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 `since` to fetch only rows that are new or changed. Returns { rows, next_cursor, has_more }.
• members ~823 tokens
  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 attaches a member by email, attaching immediately when the email already has a Human and otherwise sending a magic-link invite; list returns
• publisher ~500 tokens
  The caller's community publisher identity: the @-handle and public profile shown in the template gallery. Actions: get returns the profile, including the handle, whether it has been claimed, tenure, and the rating and template counters; claim sets the handle from a lowercase 3-to-32-character string
• restore_row ~222 tokens
  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_deleted_rows. Owner or agent only. Fails with restore_expired if the row was purged, or restore_conflict if another live row took a unique value t
• review ~814 tokens
  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 star rating and an optional written body on a template the caller has installed, identifying it by `template` (\"<handle>/<slug>\") or by `hand
• taste ~287 tokens
  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 corners'. Reading it before generating or revising an app is what carries earlier feedback into new output. Actions: get returns the current
• transfer Moves money · ~664 tokens
  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 steps, and `start` completing is only the first one. start mints a pending offer and emails the named person an accept link; the app is still ow
• update_row ~399 tokens
  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 otherwise, so a collection that scopes updates to the row's `creator` refuses an edit on someone else's row. Pass if_match with the row's cu

Browse

• Stripe tools
• Zapier tools
• Website monitoring
• Domains and DNS
• Presentations
• Email

Related MCP servers

• Redu
  Agent-native cloud, EU-hosted. Provision VMs, networks & databases on redu.cloud via MCP.
• BorealHost
  Agent-native web hosting — deploy sites, manage DNS, register domains, scale infrastructure
• The Deployer
  Check if a repo will deploy, plan a deploy to your own cloud, and see status, logs and redeploys.
• VibeKit
  Build, deploy, and operate hosted web apps on VibeKit (vibekit.bot) from any MCP client.
• Novence
  Hosted MCP for creating, checking, deploying, and hosting static sites for AI agents.
• Entity Enricher
  Multi-LLM entity enrichment: schemas, single/batch enrichment, fusion, model benchmarks.
• SpinupWP MCP by usefulapi
  Read SpinupWP servers, sites and events; purge caches, restart services, run git deploys.
• Gluecron
  AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).

Badge for your README

[![AptLynx](https://aptlynx.net/badge/dev.homespun/homespun.svg)](https://aptlynx.net/servers/dev.homespun/homespun)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents