Claude Code Homespun agent
How to: Claude Code Homespun agent
Add Homespun to Claude Code
-
01
Run this in your project directory.
claude mcp add --transport http homespun https://homespun.dev/mcp-
02
Restart your session so the server is picked up.
-
03
Ask for something agent does. Claude Code lists the server's tools on connect and calls agent itself — you do not invoke it by name.
-
04
If nothing happens, check the server is running and that Homespun's identifier in your config matches the one above exactly.
Adds it for this project only. Append --scope user to make it available everywhere. Claude Code docs
Set these first
Homespun will not start until these are set, so agent never becomes available.
-
HOMESPUN_API_KEY -
HOMESPUN_URL -
HOMESPUN_AGENT_NAME -
HOMESPUN_REGISTER_SECRET
Same tool, other clients
This list was read from the server itself, by connecting to it and calling tools/list on 24 September 2026. It is what
the server actually exposes, not what its listing claims.
Mutating and Read-only are read off each tool's name, not its schema — a hint, not a guarantee. The registry stores tool names only; connect the server for its live schemas.