Quickstart

git clone https://github.com/Philo-Studio/toolshed.git
cd toolshed
pnpm install
pnpm build

pnpm dev

toolshed serve

{
  "mcpServers": {
    "toolshed": {
      "command": "npx",
      "args": ["toolshed", "serve"]
    }
  }
}

Agent: "What tools are available for GitHub?"

→ calls search_tools({ query: "github" })
→ finds github.issues.list, github.issues.create, github.repos.search

Agent: "Show me the schema for listing issues"

→ calls read_tool({ path: "github.issues.list" })
→ gets full input/output schema

Agent: "List open issues in my repo"

→ calls run({ script: `
    const result = await tools.github.issues.list({
      owner: "my-org",
      repo: "my-repo",
      state: "open",
      limit: 10
    });
    return result;
  `})
→ returns issues array

Agent: "Create an issue for the login bug"

→ calls run({ script: `...tools.github.issues.create(...)...` })
→ execution PAUSES — returns { paused: { executionId: "abc123", ... } }
→ agent calls resume({ execution_id: "abc123", approved: true })
→ issue is created