Publish MCP Tools

Share your tools with the world. Every tool runs in a WASM sandbox.

Step 1: Install the CLI Tools

Install both workshop (build & publish) and siteboss (install & run) with a single command:

source <(curl -sSL https://registry.buildeverything.ai/install.sh) -- both

This automatically installs:

  • workshop - Build and publish components
  • rustup + wasm32-wasip2 target (if missing)
  • cargo-component - WASM component builder
  • wasm-tools - WASM inspection tools

Step 2: Create Your Tool

Scaffold a new MCP tool project:

workshop init --namespace your-namespace --component-name my-cool-tool
cd my-cool-tool

Step 3: Build Your Component

Build with --auto-wire to automatically fix missing WIT bindings:

workshop build --release --auto-wire

Step 4: Transform to MCP Tool

Use workshop mcp to make your component MCP-compatible:

# Transform component into MCP tool
workshop mcp compose target/wasm32-wasip2/release/my_cool_tool.wasm

# Test locally with interactive REPL
workshop mcp test target/mcp/my_cool_tool-mcp.wasm

Step 5: Authenticate

Log in to the registry (one-time setup):

# Authenticate (opens browser for OAuth)
workshop login

# Verify you're logged in
workshop whoami

Step 6: Publish

Push your MCP tool to the registry:

# Preview what would be published
workshop supply --tag v1.0.0 --dry-run

# Actually publish (signs with Sigstore automatically)
workshop supply --tag v1.0.0

Step 7: Register for Discovery

Make your tool discoverable on mcpsearchtool.com:

workshop mcp register your-namespace/my-cool-tool:v1.0.0

MCP Commands Reference

Command Purpose
workshop mcp compose Transform component into MCP-compatible tool
workshop mcp test Test MCP tool locally with interactive REPL
workshop mcp register Register tool with mcpsearchtool.com for discovery

What Gets Published

Workshop automatically packages your tool as an OCI artifact with:

  • component.wasm - Your WASM binary
  • policy.yaml - Security policy (if present)
  • wadm-manifest.yaml - Runtime linking config
  • Sigstore signature - Keyless cryptographic signature via Fulcio

Your tool will be available at: https://mcpsearchtool.com/tools/your-namespace/my-cool-tool