obot: Skill for Claude Code

Verify a change in a running Obot

Launch

make dev   # Go server on :8080 (dev mode, auth off) + SvelteKit UI on :5174, proxied through :8080

• Ready in seconds once Go is cached. If it isn't up within ~1 minute, read the log; don't keep waiting.
• pnpm requires Node ^24 || >=26. If the default Node is outside that, run with a 24 on PATH, e.g. PATH=$(mise where node@24)/bin:$PATH make dev.
• The UI must be on 5174. If an old Vite still holds 5174, the new one moves to 5175 and :8080 can't reach it. Kill leftovers by PID (ss -ltnp | grep -E ':(8080|8443|5174) '), not with pkill -f patterns that can match your own shell.
• Readiness: curl -sf localhost:8080/api/healthz && curl -sf -o /dev/null localhost:5174.
• The first page load shows a "Welcome to Obot" EULA dialog; click Continue.

Optional: connecting a local MCP server through a vMCP

Only needed when the change involves connecting to MCP servers, vMCPs, or the MCP Tester. Skip this section otherwise.

Remote MCP servers on localhost are refused by default, so start Obot with OBOT_SERVER_DISALLOW_LOCALHOST_MCP=false. Then:

# catalog entry for a local streamable-HTTP MCP server
curl -s -X POST localhost:8080/api/mcp-catalogs/default/entries -H 'content-type: application/json' \
  -d '{"name":"Test","runtime":"remote","remoteConfig":{"fixedURL":"http://localhost:9123/mcp/"}}'
# wrap it in a vMCP to connect to it (there is no POST /api/mcp-servers)
curl -s -X POST localhost:8080/api/vmcps -H 'content-type: application/json' \
  -d '{"displayName":"Test","components":[{"name":"t","mcpCatalogID":"default","mcpServerCatalogEntryID":"<entry id>"}]}'

• MCP Tester (inspector) UI: http://localhost:8080/mcp-servers/test/<vmcp id> → Tools tab.
• Protocol-level check: POST localhost:8080/mcp-connect/<vmcp or vmcp instance id> with a JSON-RPC initialize.
• After adding a tool to a test server, an existing vMCP kept showing the old tool list, even after Refresh in the tester (cause not investigated). Creating a new catalog entry and vMCP (e.g. for the server on another port) showed the new tool.